Importieren von Architekturelementen

Was Sie importieren können

Der ArchiMate®-Import stellt eine Übernahme von ArchiMate®-Modellelementen aus anderen Tools zur Verfügung. Selbstverständlich können Sie auch ArchiMate®-Modellelemente importieren, die aus Innovator exportiert wurden.

Sie können Dateien im Format "ArchiMate Model Exchange" importieren, die Daten gemäß ArchiMate® 3.0, 3.1 oder 3.2 enthalten.

Mehrsprachiger Import wird unterstützt. Elemente, welche durch unterschiedliche Sprachattribute mehrere Werte für den Namen haben, werden für die jeweiligen Anzeigesprachen versorgt, wenn diese im Modell eingestellt sind. Das gilt auch für die Namen von Stereotypeigenschaften, wenn diese in das Customization-Profil eingetragen werden.

Import-Unterstützungen

Für den Import gibt es zwei alternative Unterstützungen:

1. Import-Assistent

   Importieren Sie die ArchiMate-Dateien mit Einstellungen, die Sie im Assistenten vornehmen.

2. Eigene Importkonfigurationen

   Importieren Sie die ArchiMate-Dateien mit Einstellungen, die Sie in Anwendungskonfigurationen eingerichtet, getestet und zur Wiederverwendung gespeichert haben.

Import-Varianten

Für den Import gibt es zwei Varianten:

1. Ordnerstruktur der Innovator-Modellvorlage nutzen

   Exportieren Sie Ihr Modell ohne Ordnerstruktur (organization) aus der Quellanwendung in die ArchiMate-Datei.

   Führen Sie den Import in das Systemmodell durch. Die Elemente verteilen sich dann automatisch nach Typ auf die Pakete, alle Diagramme landen im Paket "Views".

2. Eigene Ordnerstruktur nutzen

   Exportieren Sie Ihr Modell mit Ordnerstruktur (organization) aus der Quellanwendung in die ArchiMate-Datei.

   Verwenden Sie ein Systemmodell, welches die Elemente nicht über Anlegevoreinstellungen verteilt. Dazu bauen Sie entweder die Struktur aus der Innovator-Vorlage um oder legen ein neues Systemmodell an. Importieren Sie die Profile "Enterprise Architecture Modeling Customization" und "Enterprise Architecture Documentation".

   Importieren Sie in dieses Systemmodell oder in ein Modell oder Paket, das darunter liegt. Wählen Sie ggf. im Import-Assistenten die Option Neues Paket erzeugen.

   Dann wird die Ordnerstruktur aus dem Ausgangsmodell nachgebildet, und die Elemente liegen an ihrem vertrauten Ort.

Vorbereitung des Innovator-Modells

Um ein gutes Import-Ergebnis zu erreichen, sind einige Vorbereitungen des Innovator-Modells zweckmäßig.

Wenn im Ausgangs-Tool die Knotenbeschriftung außerhalb der Knoten steht, dann wählen Sie in den Anzeigeoptionen für alle ArchiMate-Diagramme die Darstellung "Nur Symbol" für Konzeptknoten. Die Knoten sind dann ungefähr so groß wie im Original, weil die Namen den Knoten nicht vergrößern. Container sind davon nicht betroffen.

Wenn die Knotenbeschriftung im Knoten steht, können Sie in den Anzeigeoptionen der Diagramme eine geeignete Knotenbreite und -höhe einstellen, damit überlange Namen abgeschnitten werden und damit die Knoten nicht zu sehr vergrößern.

Wählen Sie Ansicht>Farben>Individuelle Farben, um die Farben aus dem exportierenden Tool zu sehen.

In Innovator muss die gleiche Modellsprache eingestellt sein wie beim Export im Ausgangs-Tool. Dabei wird nur die Sprache berücksichtigt, "de" (Deutsch) funktioniert z.B. für "de_de", "de_ch", "de_at", die Region ist unerheblich.

Beschreibungstexte können jedoch in mehreren Sprachen importiert werden, wenn ein Element mehrere Documentation-Knoten mit jeweils unterschiedlichem Sprach-Attribut besitzt. Die fremdsprachlichen Texte werden dann als Übersetzungen angelegt. Voraussetzung dafür ist, dass die betreffende Sprache im Modell als Anzeigesprache verfügbar ist, und der Benutzer über eine seiner Rollen das Verfahrensrecht Modellelemente übersetzen besitzt.

Erweiterungen, Namensgleichheit und verteilter Export

Falls Sie im Ausgangsmodell eine Erweiterung nutzen, müssen Sie in Innovator die entsprechenden Stereotype als Vererbung von ArchiMate-Stereotypen anlegen. Erstellen Sie dazu ein eigenes Profil, welches "Enterprise Architecture Modeling" importiert und seinerseits von "Enterprise Architecture Modeling Customization" importiert wird. Denken Sie auch an die Symbole, die Sie wie unter "Eigene Symbole verwenden" beschrieben in Innovator einspielen. Ist die Erweiterung nicht vorhanden, bekommen die Elemente das generalisierende Stereotyp und auch dessen Symbol.

Falls Ihr Ausgangsmodell gleichnamige Elemente des gleichen Typs zulässt, die sich nur über Eigenschaften unterscheiden:

1. Bei Import-Variante A werden die Namen eindeutig gemacht. Die Anpassung wird protokolliert, sodass Sie wissen, wo Sie nacharbeiten müssen.
2. Bei Import-Variante B müssen Sie in der Konfiguration (Profil "Enterprise Architecture Modeling Customization") die Namenseindeutigkeit der betroffenen Stereotype oder des Wurzelstereotyps "Konzept" im Eigenschaftendialog auf "im Paket" umstellen.

Sie können Ihren Export auf mehrere Dateien verteilen, wenn z.B. Ihr Tool nur einzelne Diagramme exportieren lässt.

Beim Import können Sie mehrere zusammengehörige Dateien gleichzeitig importieren, indem Sie im Assistenten mehrere Dateien auswählen. Sie können die Dateien ebenso nacheinander importieren, die gemeinsam genutzten Elemente werden erkannt.

Automatische Nachbehandlung beim Import aus Fremdtools einrichten

Nach erfolgreichem Import aus einem Fremdtool können Sie automatisch eine eigene Nachbehandlung des Ergebnisses anstoßen. Dazu benötigen Sie ein eigenes Plug-in, das die importierten Elemente mit Ihrem individuellen Code behandelt.

In der Projektdatei des Plug-ins fügen Sie dazu eine Projektreferenz für das ArchiMate-Plug-in ein:

<ProjectReference Include="..\Archimate\Plugins.Archimate.csproj">
<Private>false</Private>
</ProjectReference>

Zusätzlich benötigen Sie <Reference Include> für

• MID.Innovator.Util

• MID.Innovator.API

In der Component-Datei Ihres Plug-ins registrieren Sie ein Ereignis im IApplicationComponent.RequestHandler im RequestType.OpenModel:

ArchimateFactory.PostImport += PostImport;

Im Ereignishandler PostImport bekommen Sie dann die importierten Elemente. Auf diesen Elementen können Sie beliebigen Code ausführen, der in Ihrem Plug-in enthalten ist.

Die Nachbehandlung wird vom Assistenten des ArchiMate-Imports automatisch ausgeführt.