Import External Data into a New External Business Object

Create a new Business Object to import external data into.

When importing external data, data is imported into the Cherwell Service Management system and edited there. Linking external data allows for the data to be manipulated within the external source.

To import external data to a new External Business Object:

1. In the CSM Administrator main window, select the Blueprints category, and then select Create a New Blueprint or open an existing Blueprint.

   The Blueprint Editor opens, showing the Object Manager in its Main Pane. The Object Manager lists the existing Business Objects.

2. Select New Object from the Blueprint Object Manager, and then select the New external Business Object task. The External Data Wizard opens.

3. Select Next.

   The Import vs. Linked page opens.

4. Select the Import data option.

5. Select Next.

   The Data Source page opens.

6. Select Ellipses. The External Connection manager opens. Select an existing External Database or select New to create a new External Connection.

7. Select Next.

   The External Table to Map page opens, listing the Tables and/or Views from an External Database.

8. Select the Table or View to import.

9. Select Next.

   The Business Object Type page opens if creating a new object. If using an existing object, go to the Map to Fields page.

10. Select the Type of Business Object to create: Major, Supporting, or Lookup.

11. Select Next.

    The Part of Cherwell Group Group page opens.

12. Define Group information options for the External Business Object:
    • Not a Member of a Group: Select this option if the Business Object is not part of a Group.
    • Group Leader: Select this option to make the Business Object a Group Leader.
    • Member of: Select this option if the Business Object is going to be part of an existing Group. Select the Group from the enabled drop-down list.

13. Select Next.

    The Fields to Map page opens.

14. Map fields from the Table/View to a Field in the new External Business Object:
    • To map all available Table/View Fields at once, select Map all fields. The Wizard automatically creates a new Field for each external Table/View Field and populates the mapping list.
    • To map one Field at a time, select Add.

      The Map Field from External Table window opens, listing the available Table/View fields.

      1. Select the external field to map to.
      2. Select Create new field and type a name for the new field.

      3. Select OK.

15. Select Next.

    The Unique Key and Timestamp Fields page opens.

16. Designate a Unique Key and Timestamp Field:
    1. Field that Holds Unique Key: Select the Field from the View that is considered the unique identifier (example: MachineID or ComputerID).
    2. Last Modified Date/Time: Select the Field from the Table/View that is considered the last modified date/time Field(example: LastScanDate or date_modified).
17. Select Next.

    The Read-Only or Updatable page opens.

18. Select the Data is read-only or Allow data to be updated option.

19. Select Next.

    The Name and Description page opens.

20. Provide the Name and Description for the Business Object.

21. Select Next.

    The Summary page opens. The information varies depending on selections throughout the wizard.

22. Select Finish.

    The Business Object's Properties window opens, showing current (and editable) properties, including a new external data page where the Field mappings, unique ID, and last modified date/time Fields can be viewed/edited.

23. Select OK to close the Properties window.
24. Create Forms and Grids for the External Business Object just as for a new CSM Business Object.
25. (Optional for Supporting Objects) If needed, create a Relationship between the newly created Supporting Objects and the Major Object they support.
26. Publish the Blueprint (File>Publish Blueprint) to commit the changes, or save the Blueprint (File>Save Blueprint) to continue making other changes.