Importing Conceptual Models from External Catalogs

You can import conceptual models from external catalogs using Exchange Format XML. The Exchange Format XML file is a consistent representation of Design Studio entities and external catalog system entities. You can import multiple entities across multiple projects with a single input XML file.

The import operations do not update sealed projects, read-only projects, or read-only entities.

You can import the following conceptual model entities, along with supporting data elements, data schemas, and model projects, into Design Studio:

  • Product

  • Customer facing service

  • Resource facing service

  • Resource

  • Service action

  • Technical action

You can perform a partial or complete import of the XML file.

Note:

Partial import is the default option.

A partial import:

  • Creates new projects, entities, and elements if they are not present in the workspace

  • Appends new information and updates the existing information for entities or elements

  • Leaves existing information on entities and elements, if information is not included in the import file

  • Renames the existing projects, entities, or elements

Note:

Partial import does not support the removal of information from existing entities or elements.

A complete import:

  • Creates new entities or elements if they are not present in the workspace

  • Replaces existing information on entities and elements with information that is provided in the import file

  • Removes information from existing entities or elements if that information is not included for these entities or elements in the input file

  • Renames the existing projects, entities, or elements

  • Deletes the existing projects, entities, or elements

  • Handles enumerations as follows:

    • Removes existing information of entities or elements if they are missing from the input file

    • Updates existing entities or elements with information that is modified in the input file

  • Handles non-list or elements (for example, Copyright information, project name) as follows:

    • Defaults existing entities or elements with information that is missing from the input file

    • Updates existing entities or elements with information modified in the input file

Note:

Unique external identifiers must be provided for new instances of projects, entities, and elements that are imported.

Identifiers for existing or imported projects, entities, and elements cannot be modified by import operations.