ArchiMate Import Wizard

The wizard for importing from ArchiMate® guides you step-by-step through the process for importing files that correspond to the ArchiMate® specification and comply with the XML schema definition of this specification. Default settings are used, which make it easy to get started with using the configurable ArchiMate Import.

Purpose

The ArchiMate Import Wizard takes you through the steps necessary for importing ArchiMate® data, where you specify which data should be imported and the target location in the model.

You can only import model elements defined by the ArchiMate® standard or those specialized using suitable stereotype extensions from the standard.

If the files contain description texts (documentation) in different languages from that of the model language, then these can be imported as translations if the language is configured as a display language and one of your roles has the Translate Model Elements privilege.

Prerequisites

The model must be based on the current "Enterprise Architect for ArchiMate" model template.

A package is selected in the model structure. All imported elements must be able to be created from this package, e.g. using create defaults.

The files must comply with the "ArchiMate Model Exchange File Format" XML schema definition in versions 2.0 or higher

You require a role with access rights for the model to be imported and execution rights for creating concepts and concept diagrams if you wish to import ArchiMate® data.

You also require access to the customization profile via a role or with model administrator rights to be able to automatically create missing stereotype properties.

Call

Select Import/Export>Import>ArchiMate®.

Step 1 of 3: Select Files

Prerequisites

You import ArchiMate® model elements from ArchiMate®- XML files that you have exported from Innovator or other tools.

Context

Select the ArchiMate® files with the content you want to import as model elements in the model.

How to proceed

  1. Click on Select....

    The standard dialog for opening files appears.

  2. Select one or more files for import in the Open standard dialog using the [Ctrl] key. Use the search in the standard dialog to import files from different directories.

  3. Confirm your selection with Open.

    The selected files are listed.

  4. Activate the Skip Validation check box to skip validating files.

    The selected files are not validated.

  5. Click on Next.

The The validation has failed. message appears if the validation was carried out and a corrupted file was found; otherwise proceed with step 2 Create Properties or step 3 Ready to Import

Validation Error

Prerequisites

The validation has found an error in one of the files to be imported.

Context

If errors occur, then you can decide whether you wish to carry on importing the file, whether you do not wish to import the file containing the error or if you wish to abort the entire import.

How to proceed

  1. To import the file containing the error regardless, click on Yes.

    The erroneous file is imported.

    The next erroneous file is shown or step 2 Create Properties or step 3 Ready to Import is proceeded with.

  2. If you do not wish to import the file containing the error, click on Step Over.

    The erroneous file is not imported.

    The next erroneous file is shown or step 2 Create Properties or step 3 Ready to Import is proceeded with.

  3. To abort the entire import, click on Abort import.

    The ArchiMate import wizard is closed.

Step 2 of 3:Create Properties (optional)

Prerequisites

You want to automatically create missing properties as stereotype properties.

One of your roles must have access rights to the "Enterprise Architecture Modeling Customization" profile or you must have model administrator rights.

Otherwise this step will not appear

Context

Attention

You cannot undo the import if you create missing properties as stereotype properties.

If you want to automatically create missing properties, then these are created as stereotype properties in the customization profile. If not, then missing properties are listed in the log.

If string type properties in the file originated from drop-down lists in the source code, then you can create these as value lists. The values are then available for selection at the element.

How to proceed

  1. If you want to automatically create missing properties as stereotype properties, then activate the Create Missing Properties Automatically check box.

    Missing properties are created as stereotype properties in the customization profile.

    You can create the stereotype properties the first time you carry out the import; you no longer need to create the stereotype properties the next time you carry out an import from the same source model as the properties already exist and you can undo the import if necessary.

  2. If you want to create string type properties in the file as value lists, then activate the Create Strings as Lists check box.

  3. Click on Next.

Continue with step 3 Ready to Import.

Step 3 of 3: Ready to Import

Context

There are display or mapping options for diagram nodes of the imported diagrams.

How to proceed

  1. Check your specifications.

  2. To open the imported diagrams in the model editor afterwards, activate the Open Diagrams after Import check box. Ensure that the number of diagrams listed is not too large.

  3. Click on Import to import the model elements with these specifications into the model.

    A progress indicator appears, telling you roughly how much longer the import will take.

    A result report appears in a dialog once import is complete. You can adopt imported elements into the result region here. Please take note of the information in the Details area.

    If the information in the import result shows you the import has not been carried out as you require, then undo the entire import and change the configuration or select another source model. If you created stereotype properties, then the Undo (Ctrl+Z) command is no longer active. You can then delete imported elements in the result region.