Innovator 11 classix. Erweiterter XMI-Export aus Innovator Business und Object classix. HowTo.

Transkript

1 Innovator 11 classix Erweiterter XMI-Export aus Innovator Business und Object classix HowTo

2 Erweiterter XMI-Export aus Innovator Business und Object classix Inhaltsverzeichnis Zweck... 2 Modellinhalte für XMI-Export den XMI-Komponenten zuordnen... 2 XMI-Basiskomponente... 2 Weitere XMI-Komponenten... 3 XMI-Daten exportieren... 3 Profil "<Sprache> XMI Add On" nachladen... 3 XMI-Basiskomponente erstellen... 4 XMI-Komponenten erstellen... 4 Gewünschte Modellelemente der XMI-Komponente zuordnen... 5 XMI-Komponenten exportieren... 6 Zweck Modellinhalte für XMI- Export den XMI- Komponenten zuordnen XMI (XML Metadata Interchange) ist ein textbasiertes Austauschformat für Metadaten und Daten. Der XMI-Export generiert aus einem UML-Modell der Editionen Innovator Business oder Object classix eine oder mehrere XMI- Dateien mit den entsprechenden Modellinformationen. Die aus der UML- Spezifikation generierte Document Type Definition (DTD) stellt ein generisches Austauschformat für UML-Modelle dar. Der erweiterte XMI-Export aus Innovator Business und Object classix basiert auf der von der OMG bereitgestellten DTD für UML 1.4 ( Diese DTD wird bei der Programminstallation in das Innovator-Verzeichnis.../inodir/meta kopiert. Die Elemente eines Business/Object-Modells sind vor dem XMI-Export einer oder mehreren sprachabhängigen XMI-Komponenten (z.b. Komponenten vom Stereotyp «Java xmi file») zuzuordnen. Ein Projekt kann auf mehrere XMI-Komponenten verteilt werden; es wird dann automatisch referenziert. Eine XMI-Basiskomponente nimmt das Modell selbst, das Systemmodell, die Paketstruktur und diejenigen Pakete auf, die nicht anderen XMI- Komponenten zugeordnet werden. Weiteren XMI-Komponenten werden die jeweils zu exportierenden Elemente zugeordnet. Dies können folgende Elemente sein: Klassen Pakete Zustandsautomaten Aktivitätsdiagramme Einschränkungen XMI-Basiskomponente Die Basiskomponente beinhaltet die Paketstruktur und das Systemmodell. Dieser XMI-Basiskomponente werden beim Export von XMI-Komponenten vom Tcl-Skript auch alle Pakete zugewiesen, die unterhalb des Systemmodells liegen und keiner anderen XMI-Komponente zugeordnet sind. Diese Rekursion endet jedoch bei Paketen, die einer anderen Komponente zugeordnet sind. Pakete, die unterhalb eines Paketes liegen, das einer anderen Komponente zugeordnet ist, und die selbst nicht zugeordnet sind, werden nicht hinzugefügt. Des Weiteren werden in der Basiskomponente Einträge für alle Stereotypen sowie die Standard-Datentypen vom Tcl-Skript vorgenommen. Der Standardname der Basiskomponente besteht aus der Zielsprache, dem Projektnamen und einer Dateierweiterung. Der Name kann durch einen Parameter explizit angegeben werden. Heißt das UML-Projekt z. B. "Gesamtmodell" und ist die Zielsprache UML, dann lautet der Standardname der XMI-Basiskomponente "UML-Gesamtmodell.xml". 2

3 XMI-Daten exportieren Die Dateierweiterung ist beliebig, sie muss jedoch angegeben werden. Sie können die Dateierweiterungen in der Dialogbox Modell/Konfiguration/Komponenten/Komponenteneigenschaften festlegen. Der XMI-Basiskomponente werden im Regelfall keine Modellelemente zugeordnet. Weitere XMI-Komponenten Die sonstigen exportierbaren Modellelemente werden anderen XMI-Komponenten zugeordnet. Sie können die exportierbaren Modellelemente auf mehrere XMI-Komponenten aufteilen. Die dann typischer Weise auftretenden, übergreifenden Referenzen werden automatisch erstellt. Durch die Aufteilung auf mehrere Komponenten muss bei lokalen Änderungen nicht der Export des gesamten Modells angestoßen werden. XMI-Komponenten werden jeweils in eine XMI-Datei exportiert, die mit den Informationen für die zugeordneten Elemente gefüllt wird. Ein XMI-Export ist für Klassen mit einer Zielsprachendeklaration möglich. Folgende Zielsprachen werden unterstützt: C++ CORBA IDL Java UML Visual Basic Hinweis Für die konkrete Zielsprache ist in den folgenden Handlungsanweisungen die Variable <Sprache> durch die jeweilige Zielsprache (siehe obige Aufzählung) zu ersetzen. Der XMI-Export erfolgt in mehreren Schritten: Profil "<Sprache> XMI Add On" nachladen XMI-Komponenten für die Zuordnung von Elementen einrichten XMI-Basiskomponente erstellen XMI-Komponenten erstellen Gewünschte Modellelemente der XMI-Komponente zuordnen XMI-Komponenten exportieren Das Profil "<Sprache> XMI Add On" ist für ein Modell einmal zu laden. Auch die Auswahl der Elemente, die den XMI-Komponenten zugeordnet werden können, und das Erstellen der XMI-Basiskomponente erfolgen einmalig. Das Erstellen von XMI-Komponenten und die Zuordnung von Elementen zu diesen Komponenten kann beliebig oft wiederholt werden. Gleiches gilt für den XMI-Export selbst. Profil "<Sprache> XMI Add On" nachladen Für ein Modell ist ein sprachspezifisches Profil "<Sprache> XMI Add On" einmal zu laden. Um ein Profil "<Sprache> XMI Add On" nachzuladen:» Melden Sie sich im UML-Modell als Administrator an oder wechseln Sie mit dem Menübefehl Modell>Administration>Anmelden in den Administratorstatus.» Wählen Sie Modell>Konfiguration>Modelloptionen laden. Die gleichnamige Dialogbox erscheint.» Aktivieren Sie in der Gruppe Konfigurationsdatei das Alternativfeld Add-On. 3

4 » Wählen Sie in der Auswahlliste Konfigurationsdatei die Konfigurationsdatei <Sprache> XMI ([de en]). Wenn Sie UML als Sprache wählen, erscheint eine Meldung, dass Sie mit dem Menübefehl Modell>Konfiguration>Modellstruktur die Modellstruktur anpassen müssen.» Bestätigen Sie mit [Anwenden].» Schließen Sie die Dialogbox mit [Schließen].» Wenn Sie UML als Sprache gewählt haben, wählen Sie Modell> Konfiguration>Modellstruktur, selektieren Sie in der Liste Verfügbare Vorlagen die Vorlage General Component Add On for UML Profiles und in der Liste Struktur erstellen das Paket, in dem die Struktur erstellt werden soll. Klicken Sie auf [Erstellen] und schließen Sie die Dialogbox. Die Modellstruktur wird mit dem Paket general component system ergänzt.» Melden Sie sich als Administrator ab bzw. melden Sie sich als normaler Benutzer an. Die Konfigurationsparameter für das Erstellen von XMI-Komponenten stehen damit zur Verfügung. XMI-Basiskomponente erstellen Das Erstellen der XMI-Basiskomponente erfolgt in einem Projekt einmal. Die Existenz und ein bestimmter Name der XMI-Basiskomponente sind Voraussetzung für den Start des XMI-Exports. Um eine XMI-Basiskomponente im Paket <Sprache> Implementation system zu erstellen und zu benennen:» Selektieren Sie ein Paket vom Stereotyp «<Sprache> Implementation system» oder «<Sprache> Implementation subsystem».» Wählen Sie Element>Neu>Komponente><Sprache> XMI File.» Selektieren Sie die entstandene XMI-Komponente <Sprache>XmiFile.xml.» Wählen Sie den Menübefehl Element>Umbenennen, um die XMI- Basiskomponente umzubenennen.» Geben Sie im Eingabefeld einen Namen für die XMI-Basiskomponente nach dem Schema "<Sprache>-<Modellname>.<Dateierweiterung>" ein, z.b. "UML-Gesamtmodell.xml" und bestätigen mit [Eingabe]. Die XMI-Basiskomponente existiert und hat den vom Tcl-Skript für den Export erwarteten Namen. Der XMI-Basiskomponente werden durch das Tcl-Skript beim XMI-Export die Standardeinträge und alle nicht aufgelösten Referenzen zugewiesen. XMI-Komponenten erstellen Das Erstellen von XMI-Komponenten erfolgt für einen konkreten XMI- Export. Um eine XMI-Komponente im Paket <Sprache> Implementation system zu erstellen:» Selektieren Sie ein Paket vom Stereotyp «<Sprache> Implementation system» oder «<Sprache> Implementation subsystem».» Wählen Sie den Menübefehl Element>Neu>Komponente><Sprache> XMI File. Die XMI-Komponente wird vom Programm erstellt und steht im selektierten Paket zur Verfügung. 4

5 Gewünschte Modellelemente der XMI-Komponente zuordnen Das Zuordnen von Modellelementen zu den XMI-Komponenten erfolgt für einen konkreten XMI-Export. Diese Elemente dürfen jedoch nur einer XMI- Komponente zugeordnet werden. In größeren Modellen kann die Zuordnung einzelner Modellelemente zu den XMI-Komponenten durchaus recht aufwändig sein. Deshalb können Sie mit dem Tcl-Skript xmiassign.tcl ein oder mehrere Pakete und alle darin enthaltenen Modellelemente einschließlich der Sohnpakete einer Komponente zuordnen. Hinweis Die Auswertung mit dem Tcl-Skript xmiassign.tcl entfernt alle zuvor bestehenden Zuordnungen von Modellelementen zu XMI-Komponenten im Modell, die Sie ggf. bereits manuell vorgenommen haben. Für die Zuordnung von Modellelementen stehen Ihnen also zwei Varianten zur Verfügung: Manuelle Zuordnung der Modellelemente zu XMI-Komponenten Automatische Zuordnung aller Modellelemente, die in den Paketen existieren, die einer XMI-Komponente zugeordnet wurden Manuelle Zuordnung von Modellelementen Modellelemente können XMI-Komponenten manuell zugeordnet werden. Diese Zuordnung kann auch im Nachgang zur automatischen Zuordnung von Modellelementen durchgeführt werden. Um Modellelemente einer XMI-Komponente zuzuordnen:» Selektieren Sie die XMI-Komponente für die Zielsprache, der Modellelemente zugeordnet werden sollen.» Wählen Sie den Menübefehl Engineering>Komponente>Modellelemente zuordnen. Die gleichnamige Dialogbox erscheint.» Klicken Sie auf [Hinzufügen]. Die Dialogbox Einträge auswählen erscheint.» Selektieren Sie im Bereich Namensräume das Paket, aus dem Modellelemente zugeordnet werden sollen. Im Bereich Einträge werden die Modellelemente aufgelistet, die von Ihnen zugeordnet werden können.» Durch Klicken auf die Schaltflächen [Hinzufügen] bzw. [Entfernen] werden selektierte Einträge in die jeweils andere Auswahlliste ü- bernommen. Ordnen Sie auf diese Weise alle für die Zuordnung bestimmten Modellelemente der Auswahlliste Ausgewählte Einträge zu.» Schließen Sie die Dialogbox mit [OK]. Die Modellelemente sind den XMI-Komponenten zugeordnet und erscheinen in der Dialogbox Engineering>Komponente>Modellelemente zuordnen in der Auswahlliste Zugeordnete Einträge.» Schließen Sie die Dialogbox mit [Schließen]. Diese Vorgehensweise gilt auch für die Zuordnung von Modellelementen zu weiteren XMI-Komponenten bzw. im Ausnahmefall kleiner Modelle für die ausschließliche Zuordnung zur XMI-Basiskomponente. Bei größeren Modellen empfiehlt sich eine sinnvolle Aufteilung der Modellelemente auf mehrere XMI-Komponenten. Bei Änderungen im Modell müssen Sie dann nur die betroffenen XMI-Komponenten erneut exportieren. 5

6 Automatische Zuordnung von Modellelementen Modellelemente können einer XMI-Komponente automatisch zugeordnet werden. Dazu werden der XMI-Komponente zunächst nur die Pakete zugeordnet, deren Modellelemente rekursiv zugeordnet werden sollen. Das Tcl-Skript xmiassign.tcl übernimmt dann die Zuordnung aller Modellelemente des Paketes zur XMI-Komponente. Das Skript ist vorkonfiguriert und wird im Menü Engineering>Aktion ausführen>xmi Zuordnungen aktualisieren bereitgestellt. Pakete zuordnen Das Paket oder die Pakete, deren exportierbaren Modellelemente zugeordnet werden sollen, sind den XMI-Komponenten zuzuordnen. Die Zuordnung erfolgt so wie bei der manuellen Zuordnung von Paketen. (siehe oben, Abschnitt "Manuelle Zuordnung von Modellelementen") Modellelemente automatisch zuordnen Die Auswertung XMI-Assign ermittelt das oder die in der Hierarchie höchstrangigen Pakete, die einer beliebigen XMI-Komponente im Modell zugeordnet wurden. Allen XMI-Komponenten im Modell werden jeweils alle Modellelemente zugeordnet, die sich unterhalb dieses oder dieser höchstrangigen Pakete in den jeweiligen XMI-Komponenten befinden. Die Auswertung entfernt alle zuvor bestehenden Zuordnungen von Modellelementen zu XMI-Komponenten im Modell, die Sie ggf. bereits manuell vorgenommen haben. Um die Modellelemente automatisch zuzuordnen:» Wählen Sie den Menüpunkt Engineering>Aktion ausführen>xmi Zuordnungen aktualisieren. Die Modellelemente werden wie beschrieben automatisch den XMI- Komponenten zugeordnet. XMI-Komponenten exportieren Sie können XMI-Komponenten mit ihrem Inhalt in XMI-Dateien exportieren. Um eine XMI-Komponente zu exportieren:» Stellen Sie sicher, dass für das Paket vom Stereotyp "<Sprache> Implementation system" eine Adresse (Verzeichnis) für die XMI-Exportdateien vergeben ist. Falls dies noch nicht der Fall ist, selektieren Sie das Paket und sperren Sie es. Wählen Sie anschließend den Menübefehl Element>Eigenschaften. Im Register Elementeigenschaften selektieren Sie für die Adresse ja; im Register Adresse geben Sie das Verzeichnis für den Export an.» Selektieren Sie die zu exportierenden XMI-Komponenten <Sprache>XmiFile.xml.» Wählen Sie den Menübefehl Engineering>Forward/Reverse.» Aktivieren Sie im Register Komponente in der Gruppe Aktionen das Alternativfeld Forward-Engineering.» Selektieren Sie in der Auswahlliste Aktionen den Eintrag <Sprache> XMI file from object model / <Sprache> XMI file from business model.» Klicken Sie auf die Schaltfläche [Anwenden]. Die XMI-Dateien werden in das durch die Adresse bestimmte Verzeichnis exportiert. In einem Infofenster wird der Export protokolliert. 6

7 » Schließen Sie das Infofenster.» Schließen Sie die Dialogbox Engineering>Forward/Reverse mit [Schließen]. Die XMI-Dateien stehen in dem Verzeichnis, das Sie für das Paket vom Stereotyp "<Sprache> Implementation system" im Register Adresse der Dialogbox Element>Eigenschaften angegeben haben. Copyright 2010 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline Telefon: +49 (0)911 / , support@mid.de. Dieses Dokument finden Sie neben anderen auch im exklusiven Login- Download-Bereich für Innovator-Wartungskunden unter Ihre MID MID GmbH, Kressengartenstraße 10, Nürnberg Telefon: +49 (0)911 / , Fax: +49 (0)911 / info@mid.de, Internet: Innovator_11.2_HowTo_XMI_Export_classiX_ doc 7