Import of Documents

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

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 '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.

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.

Note

The link role used to control the hierarchy in the target document must be excluded from the mapping!

Document Link Role

Warning

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