ArchiMate® import allows you to input ArchiMate® model elements from XML files. You can subsequently access the imported elements using a separate plug-in.
Adopting ArchiMate® Model Elements from Other Tools
What Can You Import?
The ArchiMate® import provides a means of adopting ArchiMate® model elements from other tools. Of course it is also possible to import ArchiMate® model elements that were exported from Innovator.
You can import files which contain data in accordance with ArchiMate® 3.0, 3.1 or 3.2 in the "ArchiMate Model Exchange" format.
Multilingual import is supported. Elements that have multiple values for the name due to different language attributes are supplied for the respective display languages if these are set in the model. This also applies to the names of stereotype properties if they are added to the customization profile.
Import Supports
There are two methods to help with import:
-
Import Wizard
Import ArchiMate files with settings you make using the wizard.
-
Your Own Import Configurations
Import ArchiMate files with settings which you have set up, tested and stored so that they can be reused in the application configurations.
Import Variations
There are two import variations:
-
Use the Innovator model template folder structure
Export your model without folder structure (organization) from the source application to the ArchiMate file.
Carry out the import in the system model. The elements are then automatically distributed to all packages according to type and all diagrams are sent to the "Views" package.
-
Using Your Own Folder Structure
Export your model with folder structure (organization) from the source application to the ArchiMate file.
Use a system model that does not distribute elements using create defaults. To do this, either change the Innovator template structure or create a new system model. Import the "Enterprise Architecture Modeling Customization" and "Enterprise Architecture Documentation" profiles.
Import into this system model or in a model or package below it. Select the Create new package option in the import wizard.
The folder structure is then copied from the initial model and the elements are then where you would expect to find them.
Preparing the Innovator Model
You must prepare the Innovator model before being able to achieve a successful import result.
If the node labels are not within the nodes in the starting tool, then select the "Icons only" display for concept nodes for all ArchiMate diagrams. The nodes are then approximately as large as the original, as the names will not increase the size of the nodes. Containers are not affected.
If the node labels are in the node, then you can set the width and height of the node in the diagram's display options so that the name does not get split if it is too long and the node does not get too big.
Select View>Colors>Custom Colors to see the colors from the tool to be exported.
The same model language as the starting tool must also be set in Innovator. Only the language and not the region is taken into consideration, e.g. "en" (English) also works for "en_us" and "en_gb".
It is possible to import description texts in multiple languages if an element contains multiple documentation nodes, each with a different language attribute. The foreign language texts are then created as translations. The respective language must be available as a display language in the model and one of the user's roles must have the Translate Model Elements privilege.
Extensions, Name Similarity and Distributed Export
If you use an extension in the starting model, then you need to create the appropriate stereotypes as an inheritance of ArchiMate stereotypes. To do this, create your own profile which imports "Enterprise Architecture Modeling" which then imports from "Enterprise Architecture Modeling Customization". Please also take the icons into consideration which you add in Innovator as described under "Using Your Own Icons". If the extension is not available, then the elements are assigned the general stereotype and its icon.
Restriction
Please note that Innovator cannot display overlapping edges. Any small overlapping nodes are adopted in the larger containers upon import. Nodes in the containers always have the container as logical owner in Innovator.
If your starting model allows elements with the same name of the same type which can only be differentiated between using their properties:
- The names will be made unique if you carry out import variation A. The changes are logged so that you know where post-processing must be carried out.
- For import variation B, you need to set the unique name of the affected stereotypes or the "Concept" root stereotype to "in the package" in the Properties dialog in the configuration ("Enterprise Architecture Modeling Customization" profile).
Restriction
Please make sure that you have set the viewpoint property to a suitable value for all diagrams before exporting into another model; this is done to ensure the diagrams have the right type in Innovator. Diagrams will be created as "ArchiMate diagrams" without the viewpoint property.
You can distribute your export to multiple files if e.g. your tool only allows single diagram export.
You can import multiple files which belong to each other by selecting multiple files in the wizard. You can also import files one after another; the elements which they share will be recognized.
Setting Up Automatic Post-Processing when Importing from Foreign Tools
You can automatically start your own post-processing upon successful import from a foreign tool. You require your own plug-in for this which handles the imported elements with your individual code.
Add a project reference for the ArchiMate plug-in the project file for this:
<ProjectReference Include="..\Archimate\Plugins.Archimate.csproj"> <Private>false</Private> </ProjectReference>
You also require <Reference Include> for
-
MID.Innovator.Util
-
MID.Innovator.API
Register an event in the IApplicationComponent.RequestHandler in the RequestType.OpenModel in your plug-ins component file:
ArchimateFactory.PostImport += PostImport;
The imported elements appear in the PostImport event handler. You can run any code in these elements which is contained in your plug-in.
Post-processing is automatically carried out by the ArchiMate Import wizard.
Importing ArchiMate® Model Elements from ArchiMate® XML Files
Prerequisites
You can only import model elements defined by the ArchiMate® standard.
It is also possible to use your own types for ArchiMate elements; these expand on the ArchMate standard through inheriting valid element types (stereotypes in Innovator) as long as the type determined for export is a valid ArchiMate type.
The files must comply with the "ArchiMate Model Exchange" XML schema definition.
You require a role with access rights for the model to be imported and execution rights for creating concepts if you wish to import ArchiMate® data. You require the Configure privilege and access right to the "Enterprise Architecture Modeling Customization" profile to be able to automatically create missing stereotype properties.
How to Proceed
You import ArchiMate® model elements from XML files that you have exported from Innovator or other tools.
It only makes sense to select existing structure elements as the import target; this is due to the defaults necessary for a successful import:
- The system model which originated from the model template (see import variation A above)
- A system model that was created and configured before the import or a (sub)model below (see import variation B above)
The import in a (sub)model created using a wizard can only produce a desirable result if it inherits the content configuration and is not excluded as target by the create defaults.
The wizard help will show you in detail how to proceed.
Validation
The selected files can be validated by default before import. You can skip validation as this may take some time. Any errors will then be shown in the results dialog after import.
If you carry out the validation, then a message appears for each file containing validation errors. You can decide whether you wish to skip the respective file, import it anyway or abort the entire import.
The type of error can vary greatly, so it is not possible to say that you should never import files containing errors. It may still be possible to get good import results from such files. You must decide whether this is possible for each individual file.
Creating Missing Properties
There are properties which do not already exist in the Innovator model, particularly when importing the first file from a different tool. These can be automatically created upon import.
There are three abstract stereotypes in the "Enterprise Architecture Modeling Customization" profile where you can store the import stereotype properties for concepts, concept diagrams and concept relationships.
One of your roles must have the access right to be able to lock the profile to be able to do this. Model administrator rights are also sufficient for this.
You can select in the wizard that you want all string value properties with value lists to be created. Then all values with the same property that are already assigned to other elements will be available for the element at a later stage. This makes it much easier to e.g. replace a name from a selection.
The Undo (Ctrl+Z) command is no longer available after import if you choose to use this automatic configuring option; this is because configuration modifications delete the buffer.
Once the import has completed, the missing properties will be shown in the results dialog; marked either as created or missing.
What to Note After Import
Please take note of the messages in the Details expander in the results dialog and use the opportunity to transfer the imported elements into the result region.
Check the messages to see whether changes are required in the model or in the exporting tool.
After import, open the diagrams one after another and check the layout. The import tries to replicate the original depiction where ever possible. It may be necessary to carry out some small form of post-processing. It may take a long time to make any changes necessary to the interface layout. It is only possible to delete the imported diagrams and reimport the file once the change has been made. This then only updates the diagrams.
If you are not happy with the result, then try the Undo (Ctrl+Z) command. If this is not available, then you can delete the elements in the Result region.
You can find created stereotype properties in the configuration (see above). You can use them for the next import attempt with the Undo (Ctrl+Z) command.
Related Topics
Further Information
