Skip to content

Import of Documents

To import only workitems included in a specific document it has to be selected in the package configuration dialog.

Referenced workitems

It is also possible to include workitems which are only referenced in the document, by selecting the "Load Referenced Items" check mark in the configuration dialog.

Import of documents package configuration dialog

Note

You shouldn't import a referenced item multiple times into the same model. If you do so, it will be moved to the last package that was used for import, since the element can only exist one time in EA.

Document hierarchy and EA sorting

On import the documents hierarchy will be reflected as precise as possible, but is limited by your EA sorting settings.

To allow for proper item order please enable "Free Sorting".

Enable Fre Sorting

Another limitation is that Packages are always sorted above all other Element types (Diagram Sorting preference excluded).

A typical Example of WorkItems imported as Packages would be headings.

 <elementRule>
      <matchingRule>
        <externalProperty name="_objectType" value="heading" />
        <myumlProperty name="_objectType" value="Package" />
      </matchingRule>
      <properties>
        <property external="title" myuml="Name" />
        <property external="description" myuml="Documentation" />
        <property external="uri" myuml="::uri" />
      </properties>
    </elementRule>

Note

Keep in mind that packages and diagrams are excluded from "Free Sorting" and are always sorted above other element types.

The parental link role in the target document must be excluded from the mapping! This role will be used to replicate hierarchy in Enterprise Architect.

Document Link Role

Warning

Chosen documents must have a title heading as topmost item to avoid problems on import.