Skip to end of metadata
Go to start of metadata

This feature is only available in the BiZZdesign on-premise solution.

Visio drawings can be imported into ArchiMate® models. Shapes, text and relations in Visio are imported based on a mapping that specifies which shapes and relations are mapped onto which types of objects and relations in Enterprise Studio. 

To successfully import a Visio drawing, note the following:

  • To import lines or relations from Visio, the lines have to be connected to the objects/shapes in Visio; isolated lines will not be imported.
  • To import names of objects or relations, the names have to be connected to the objects or relations.
  • Any shape or relation to be imported has to be mapped in the type mapping; shapes or relations not in this type mapping will not be imported.

Required Visio file format

You can only import Visio files with the extension .VDX or .VSDX (Visio 2013). To be able to use the Visio import, you need to save your Visio model as XML file. Visio will create a file with extension .VDX or .VSDX.

Type mapping file

Within Visio you need to use a (the standard) Visio scheme. This Visio scheme is like a metamodel specification. If you save the Visio file, this specification is added to the file. Enterprise Studio uses this specification to determine which types of objects must be created while importing.

The mapping of the Visio object types to the Enterprise Studio object types needs to be defined in the mapping file VisioToArchiMateTypeMapping.xml, available in the folder Configuration\MetaModels\ArchiMate\ImportTypeMappings of your Enterprise Studio installation. Example:



Every shape or relation in the mapping file is mapped using four lines:

<TypeToType>

<FromType>visioname</FromType>

<ToType>metamodelname</ToType>

</TypeToType>


Visioname is the name of the shape or relation in Visio as defined in Master, a property of the shape or relation. The Master identifies the type of shape (object) or relation. For shapes and relations in the Visio file to be imported into Enterprise Studio, they need to have a Master description and this description needs to be included in the mapping file, otherwise they cannot be mapped and imported into Enterprise Studio. In Visio, the Master of a shape or relation can be found in the Shape Name window. Example:



Alternatively, you can open the Visio XML diagram in a basic text editor, and search for the Master. The Master name can be found next to "NameU". Example:



Metamodelname is the name of the corresponding object type or relation type in Enterprise Studio. This name can be found in the Metamodel Browser in Enterprise Studio, accessible via the Metamodel button in the Query tool window. The metamodel name is the text between brackets.



The easiest way to complete the mapping is to create a small example of the Visio file(s) to be imported, and import that example. Based on the error messages one can complete the mapping and finalize the import. When importing, warning and error messages may be generated, for instance when mappings are missing for certain shapes. These messages can help in completing the type mapping, since the names of the missing shapes and relations are listed here.



If you use a non-standard Visio scheme, you may need to update this transformation file. Please contact your application manager or BiZZdesign for this.

Steps:

  1. In the model browser, select the ArchiMate model in which you want to import data.

  2. On the ArchiMate tab, in the Import group, click Visio.

  3. In the Import objects window, select the file you want to import and click Open.

  4. In the Choose Diagrams window, select the diagrams you want to import and select the diagrams/views where they must be imported in.



  5. Transformation to use during import shows the mapping file that is used for the Visio import. If the correct file is located elsewhere, select the correct location and file.

  6. Optional: By default, all imported objects are added as new objects to the model the are imported in, even if objects (of the type) already exist in the model. In that case, new objects will be created with the same name as the existing ones, including a sequence number between bracket.

    If you select the Match names with existing objects check box, the imported objects will be matched with the existing objects. If an object (of the type) already exists in the model, it remains the same and the new object will not be imported.

  7. Click OK to start the import.


ArchiMate® is a registered trademark of The Open Group.