MagicDraw. Inhaltsverzeichnis. Marcel Schreeck, B.Sc.

Transkript

1 MagicDraw Diese Anleitung fußt auf MagicDraw 17.0.x des Herstellers NoMagic. Sie bezieht sich auf die Bedürfnisse der Praktikumsdurchführung und erhebt daher keinen Anspruch auf Vollständigkeit. Wenn Sie MagicDraw auf ihrem eigenen Rechner installieren wollen, um das Praktikum zuhause weiterzuentwickeln, verwenden Sie bitte unbedingt die selbe Version wie im Labor. Die Kompatibilität zwischen den Versionen ist leider nicht immer gegeben. Inhaltsverzeichnis 1.Installation Download Windows Linux Initiale Einrichtung Lizenz Projekttemplate Erster Start Verwendung in anderen Laboren des Fachbereichs Übersicht MagicDraw Projekt anlegen Usecasediagramme Use Case Scenario Klassendiagramme Klassen Attribute Operationen Automatisierte Funktionen Assoziationen Allgemein Sequenzdiagramme Codegenerierung Aufsetzen der Codegenerierung Überprüfung des Modells Erzeugen von Modellteilen Reverse Engineering Dokumentation Tastenkürzel...17 Anleitung MagicDraw 1 Version

2 1.Installation In diesem Kapitel wird die Installation von MagicDraw auf dem eigenen Rechner beschrieben. Auf den Praktikumsrechner ist das Tool bereits vollständig eingerichtet. 1.1.Download Um MagicDraw auf dem eigenen Rechner verwenden zu können, müssen Sie eine Demoversion vom Hersteller herunterladen: Dort muss dann die Version und Enterprise ausgewählt werden. Ein Demolizenzkey wird Ihnen zugeschickt. 1.2.Windows Um die Installation zu starten, muss die Installationsdatei ausgeführt werden. Nach dem Entpacken der Daten werden Sie von einem Installationsassistenten geleitet. Sollten Sie kein Java auf ihrem Rechner installiert haben, so können Sie dies mit dem Installer vollziehen. Anderenfalls sollten die automatisch ausgewählten Pfade korrekt sein. Die Installation selbst kann bis zu einigen Minuten dauern. Danach kann das Tool sofort gestartet werden. 1.3.Linux Sollte die Installationsdatei unter Linux nicht automatisch als ausführbares Shell Script erkannt werden, so muss dies mit dem Terminal angepasst werden. Navigieren Sie im Terminal mit cd zu dem entsprechenden Verzeichnis. Dort müssen Sie dann die Rechte der Datei ändern. Dies geschieht mit chmod 770 DATEINAME. Nun kann die Datei mit./dateiname ausgeführt werden. Die Installation selbst ist durch einen Assistenten geführt und ist mit der Windows Installation identisch. Anleitung MagicDraw 2 Version

3 1.4.Initiale Einrichtung Lizenz Die Lizenz kann nach erfolgreicher Anmeldung mit dem ist-account an folgender Seite heruntergeladen werden: Dort kann auch das Magicdraw-Template des Fachbereichs heruntergeladen werden. Dieses sollte am besten direkt in den templates Ordner der Magicdraw-Installation kopiert werden und dort das template.mdzip ersetzen. In dem Template sind einige Einstellungen und Elemente vorkonfiguriert um die Arbeit zu erleichtern Projekttemplate Am Fachbereich Informatik setzen wir ein speziell konfiguriertes Template ein. Dieses muss aus dem Internet geladen werden und mit dem Namen template.mdzip unter <Installationsverzeichnis>/templates/ gespeichert werden. Dabei muss das alte Standardtemplate überschrieben werden Erster Start Beim ersten Start wird nach importierbaren Einstellungen gefragt. Hier sollten die Standardeinstellungen gewählt werden. Als Anwendungsperspektive wählen Sie Software Architekt da diese die Funktionen schnell zur Verfügung stellt, die wir im Praktikum verwenden. Des Weiteren sollte die Experten Ansicht eingestellt werden um sofort alle Einstellungen sehen zu können. Dies geschieht unter Options > Enivroment > Experience und dort dann mit einem Häkchen für Main Menu Expert Mode und Context Menu Expert Mode. 1.5.Verwendung in anderen Laboren des Fachbereichs Auch in anderen Laboren des Fachbereichs kann MagicDraw für die Modellierung von Softwaresystemen verwendet werden. In einem Linux Labor müssen Sie folgende Befehlszeile in der Konsole ausführen:./home/groups/labdisk/case/bin/mdraw In den Windows Laboren kann das Programm mit einem Doppelklick auf das Symbol unter Y:\CASE\MagicDraw_UML_Win\bin\MagicDraw_Start.bat Anleitung MagicDraw 3 Version

4 gestartet werden. 2.Übersicht MagicDraw Abb1: Übersicht MagicDraw MagicDraw ist ein kommerzielles CASE-Tool der Firma No Magic. Nachfolgend sind einige grundlegende Informationen zu MagicDraw dargestellt. Weitere Erläuterungen finden Sie auf den Web-Seiten des CASE-Labors. Start des Programms Im CASE-Labor sind die Rechner so eingerichtet, das MagicDraw direkt über das Startmenü unter Development gestartet werden kann. Auf Ihrem eigenen Rechner müssen Sie den Pfad wählen, unter dem Sie MagicDraw installiert haben. Unter Windows sollte ein Eintrag im Startmenü angelegt worden sein. Anleitung MagicDraw 4 Version

5 Containmentbaum Der Modell-Browser stellt alle Elemente des Modells dar. Er zeigt die Pakete des Modells und die Elemente, die den Paketen zugeordnet sind. Er stellt also das Inhaltsverzeichnis des Modells dar. Der Modellbaum zeigt die Struktur des Modells. Der Modellinhalt ist in weitere Modelle zerlegt um die Übersicht zu erhöhen. Diese Teilbäume können auf- und zugeklappt werden. Detailansicht Hier werden die Diagramm und die modellierten Elemente dargestellt. Die Elemente können dabei frei angeordnet und erweitert werden. Eigenschaften/Dokumentation/Zoom Diese Fenstergruppe beschleunigt die Arbeit ungemein. Hier können nach Auswahl eines Objektes in der Detailansicht weitere Eigenschaften manipuliert, eine Dokumentation für das Objekt verfasst, oder sich Überblick über das gesamte Diagramm verschafft werden. Ergebnisbereich Hier sind Meldungen des System zu finden. Gerade bei der Codegenerierung und beim Reverse Engineering werden hier wichtige Informationen aufgezeigt. Fensterleiste MagicDraw kann mehrere Diagramme gleichzeitig geöffnet halten. Sie werden oberhalb der Detailansicht aufgelistet. Sie können per einfachen Klick auf den Diagrammnamen geöffnet werden. Spezifikationen Die Spezifikationen eines Objektes können im Diagramm nach dessen Auswahl per Eingabe- Taste, oder via Rechtsklick Spezifikation geöffnet werden. Mehrere Projekte MagicDraw kann mehrere Projekte gleichzeitig geöffnet halten. Zum wechseln zwischen diesen Projekten muss das Projekt aus der Dropdownbox oben(siehe 1) gewählt werden. Zum Schließen einzelner Projekte muss das x oben rechts(siehe 2) unter dem x zum Schließen des Fensters gewählt werden. Wenn neue Projekte geöffnet werden, werden die alten dabei nicht automatisch geschlossen, sodass zwischen ihnen gewechselt werden kann. Anleitung MagicDraw 5 Version

6 3.Projekt anlegen Nach dem Start des Programms erscheint der Willkommens-Bildschirm. Hier kann nun mit STRG+N oder durch Klick oben Links auf das leere Blatt ein neues Projekt angelegt werden. Nach dem das Standardtemplate von MagicDraw durch das Fachbereichstemplate ersetzt wurde(siehe Punkt 1.4.2Projekttemplate), kann ein normales UML Project erstellt werden. Dem Projekt müssen Sie einen selbst sprechenden Namen geben und einen Speicherpfad wählen. Wenn Sie als Speicherpfad im Labor ihr Homeverzeichnis (Windows: Eigene Dateien) angeben, so wird das Projekt automatisch auf dem Userv gespeichert. Eine lokale Speicherung auf den Laborrechnern ist nicht ratsam, da diese Daten regelmäßig gelöscht werden. 4.Usecasediagramme Ein neues Usecasediagramm kann einfach mit dem Klick auf den Button oben erzeugt werden. Im Dialog sollte dann ein selbst sprechender Name angegeben und der Besitzer des Diagrammes festgelegt werden. Als erstes müssen die Systemgrenzen definiert werden. Dazu muss rechts neben Package auf den Pfeil geklickt werden um die weiteren Objekte anzuzeigen. Hier muss nun System Boundary gewählt werden. Ziehen Sie das Element groß in der Detailansicht auf. Fügen Sie nun die Akteure, Anwendungsfälle und Verbindungen hinzu die sie benötigen. Zur Eingabe der Bezeichnung doppelklicken Sie auf das Objekt. Alternativ kann nach Markierung des Objekts nach Rechsklick Specification ausgewählt werden. Hier können dann neben dem Namen auch weitere Eigenschaften des markierten Objekts eingestellt werden. Anleitung MagicDraw 6 Version

7 4.1.Use Case Scenario In MagicDraw können auch textuelle Beschreibungen von Use Cases hinterlegt werden. Dazu müssen die Spezifikationen des im Diagramm erstellte Use Case geöffnet werden. Hier kann nun links unter Use Case Scenario der Basic Flow erzeugt werden. Mit dem Plus- Symbol oben können die einzelnen Schritte angelegt werden. Zum verschieben dienen die Pfeile nach oben bzw nach unten. Zum Anlegen von Alternative oder Exceptional Flow muss in den entsprechenden unteren Reitern neue Conditions/Execption Type angelegt werden. Hier können auch mehrere Alternative bzw Exceptional Flow angelegt werden, welche untereinander angezeigt werden. Hieraus könne auch direkt Aktivitätsdiagramme erzeugt werden. Diese sind allerdings Fehleranfällig. Bei Änderungen des Aktivitätsdiagramms muss teilweise mit Programmabstürzen gerechnet werden. 5.Klassendiagramme Zur Erstellung eines neuen Klassendiagramms klicken Sie entweder auf das Symbol für Klassendiagramme, oder führen Sie einen Rechtsklick auf das entsprechende Packet im Modellbrowser aus und wählen unter New Diagram das Class Diagram. Zum Anzeigen bereits vorhandener Klassendiagramme drücken Sie STRG Klassen Klassen können per Drag and Drop dem Klassendiagramm hinzugefügt werden. Hier ziehen Sie das Symbol der Klasse an die Position des Diagramms. Durch den Pfeil an der linken Seite des Symbols können weitere Klassentypen ausgewählt werden. Einen Namen kann per Selektion der obersten Zeile oder in den Spezifikationen gesetzt werden. Eine leere benannte Klasse Die Klassen sind Modell gespeichert und sind in allen Diagrammen verfügbar. Dies hat zur Folge, das die Namensgebung eindeutig sein muss. Bereits vorhandene Klassen können direkt aus dem Modellbaum in das Klassendiagramm hineingezogen werden. Sollten Sie mit Entity, Controll und Boundary arbeiten, so können dies mit einem Rechtsklick auf die Klasse unter Stereotype einstellen. MagicDraw blendet dabei automatisch die Anleitung MagicDraw 7 Version

8 Methoden und Attribute aus. Diese können mit einem klick auf das + wieder angezeigt werden. Alternativ dazu können auch die Optionen geändert werden. Hierzu muss man unter Options Project den Pfad Symbols>Default>Stereotypes die gewünschten Stereotypen per Rechtsklick Add/Remove Stereotype hinzugefügt werden. Für diese Stereotypen kann man nun einzeln die Optionen ändern. Zum Anzeigen der Methoden und Attribute muss der Hacken bei Show Attributes visibility bzw. Show Operations visibility gesetzt werden Attribute Ein Attribut kann entweder über den orangen Punkt rechts in der zweiten Zeile der Klasse, oder in den Spezifikationen der Klasse unter Attributes angelegt werden. Bei Verwendung des orangen Punktes muss darauf geachtet werden, dass mit der Eingabetaste das nächste Attribut eingefügt wird. Dies kann mit Strg+D endgültig gelöscht werden. Alle anderen Funktionen blenden das Attribut nur aus. Die Typ-Zuweisung geschieht in der Detailansicht des Klassendiagramms nach Rechtsklick auf das Attribut unter Type. Hier kann nun der Datentyp ausgewählt werden. Alternativ kann der Typ auch direkt bei der Namensgebung in der richtigen Syntax eingegeben werden. Bitte beachten Sie bei der Eingabe von Datentypen, die nicht zum Sprachkern gehören (z.b. string, vector, list) darauf, den Namespace voranzustellen (z.b. std::). In den Spezifikationen des Attributs kann die Zuweisung des Typs mit Hilfe des gleichnamigen Feldes erfolgen. Ein Attribut kann auf static gesetzt werden, indem man es mit der rechten Maustaste selektiert und is Static anwählt. Darstellung von Arrays und Listen/STL-Containern Ein weiterer wichtiger Punkt für die Attribute ist die Darstellung als STL-Container, wie List oder vector, oder Array. Diese werden in MagicDraw auf besondere Art und Weise erzeugt. Hierzu müssen die Spezifikationen der Attribute aufgerufen werden. In der Ansicht Alle gibt es nun unter dem Punkt Type Modifier beziehungsweise Container die Möglichkeit die spezielle Syntax der Zielsprache anzugeben. Das Feld Container sollte dabei immer den STL Container enthalten. Dies wird sonst durch das Reverseengineering geändert. Leider werden die Container-Informationen nicht im Klassendiagramm angezeigt. Das $ ist jeweils ein Platzhalter für den Type. Dadurch wird vector<$*> nach der Codegenerierung beispielsweise zu vector <string*>, oder $[3] zu int[3]. Beispiele Wunsch (in C++) Eingabefelder Ausgabe Type Type Container Array Anzeige im Anleitung MagicDraw 8 Version

9 Modifier (C++ Lang. Prop.) (C++ Lang. Diagramm Prop.) string s string [std] (Class) s : string int* a[7] int $* [7] a:int"$*"[0..*] list<string> sl string [std] (Class) std::list<$> sl:string [0..*] vector<int*> vi int std::vector<$*> vi:int[0..*] Operationen Ähnlich wie die Attribute können auch die Operationen erzeugt werden. In der Detailansicht ist hierbei nur der grüne Punkt in der 3. Zeile zu verwenden. Parameter können direkt in der unten stehenden Syntax eingegeben werden, oder in den Spezifikationen des Operators unter Parameter angelegt werden. Hier können auch weitere Einstellungen wie Standardwerte oder Parameter eingestellt werden. Klassenobjekt Die Eigenschaft abstract abstract wird für Methoden über die rechte Maustaste mit is Abstract aktiviert. Das Tool fordert dann, dass die Klasse ebenfalls abstract sein muss. Dies muss in den Eigenschaften der Klasse aktiviert werden. Klassenmethoden werden analog durch is Static bestimmt. Die Eigenschaft virtual virtual wird in den Eigenschaften der Methoden unter C++ Language Properties im Feld virtual aktiviert. Allerdings wird sie nicht im Klassendiagramm angezeigt Automatisierte Funktionen Erstellung von Konstruktoren Um einen Konstruktor in einer Klasse zu erstellen öffnen Sie deren Spezifikationen und wählen den Pfad Operations. Hier muss nun eine neue Operation angelegt werden. Da MagicDraw standardmäßig nicht alle Eigenschaften anzeigt, muss oben unter Anleitung MagicDraw 9 Version

10 Eigenschaften von Standard auf All gewechselt werden. Dadurch wird eine Vielzahl weiterer Eigenschaften angezeigt. Hier muss nun unter Applied Stereotype C++ Constructor [Operation] [C++ ANSI profile] ausgewählt werden. Dabei sollte natürlich der Name mit dem Namen der Klasse übereinstimmen. Erstellung von Getter/Setter Da es von Vorteil ist die Attribute zu kapseln kann mit MagicDraw automatisch für ausgewählte Attribute Getter bzw Setter Funktionen erzeugt werden. Dies geschieht am Einfachsten mit einem Rechtsklick auf die Klasse und dort unter Tools Create Getters/Setters. Hier können nun die gewünschten Attribute ausgewählt werden. Im unteren Bereich des Dialoges können weitere Einstellungen vorgenommen werden. Mit einem Klick auf OK werden die entsprechenden Methoden erzeugt. Einfügen von Pattern Auch einige Pattern können automatisch mit Hilfe eines Assistenten eingefügt werden. Unterstützt werden von MagicDraw unter anderem folgende Standardmuster: Adapter Bridge Singleton Observer (Beobachter) Daneben gibt es noch einige spezielle Muster für einzelne Sprachen. Die Erzeugung eines Muster geschieht nach Selektion einer neuen Klasse mit einem Rechtsklick auf die Klasse Tools Apply Pattern anwenden. Im erscheinenden Dialog kann links das Muster ausgewählt werden und rechts weitere Einstellungen und Klassennamen ausgewählt werden. 5.2.Assoziationen Am einfachsten erzeugt man Beziehungen, indem man eine Klasse, von der eine Beziehung ausgeht selektiert. Rechts von der Klasse werden alle Beziehungstypen, die von der Klasse ausgehen können, eingeblendet. Man wählt einen Beziehungstyp aus und klickt in das Diagramm. Die Beziehung und die Zielklasse werden erzeugt. Bereits bestehende Klassen müssen einfach verbunden werden. Für die Assoziationen müssen die Multiplizitäten angegeben werden. Diese können in den Spezifikationen der Assoziationsenden eingestellt werden. Der Wert der Multiplicity kann dabei frei eingetragen oder aus der Liste ausgewählt werden. Leider erzeugt MagicDraw Anleitung MagicDraw 10 Version

11 unabhängig von der Multiplizität immer einen einfachen Pointer. Damit Multiplizitäten größer eins verwaltet werden können, muss der Type Modifier angepasst werden. Hier kann die Syntax frei gestaltet und auch STL Strukturen verwendet werden. Das $ gilt dabei als Platzhalter für den Typ. Beispielhaft hier die Syntax für einen Vector von Pointern: vector<$*> Sollte eine Assoziation ausgeblendet sein, so kann sie automatisch mit einem Rechtsklick auf einer der beteiligten Klassen über Related Elements Display Paths wieder angezeigt werden. Alternativ können von einer Klasse aus auch alle verbundenen Klassen dem Diagramm hinzugefügt werden. Dazu muss wieder ein Rechtsklick auf die Klasse ausgeführt werden und dann Related Elements Display Related Elements anzeigen gewählt werden. Hier kann unten links die Tiefe gewählt werden, bis zu welcher tiefe die Elemente hinzugefügt werden sollen. Standardmäßig werden Beziehungen als senkrechte und waagerechte Linien dargestellt. Wenn direkte Verbindungen gewünscht werden, kann dies nach Selektierung der Verbindung mit diesem Button erfolgen. Die Assoziationsattribute werden in den Klassendiagrammen standardmäßig ausgeblendet. Damit die Attribute auch im Klassendiagramm angezeigt werden müssen sie unter Options Project den Pfad Symbols>Default>Shapes >Class auswählen und Show Association Ends as Attributes auf All setzen. Aus einer Spezialisierung ("Vererbung Vererbung") von A nach B erzeugt MagicDraw den C++-Code "class B: A". D.h. es fehlt das Schlüsselwort "public" (class B: public A"). Das ist zwar in C++ erlaubt, (und bedeutet, dass die Vererbung als private implementiert wird) aber in der Regel meint man eher public. Lösung: Bei den Eigenschaften der Beziehung kann man unter den "C++ Language Properties" den Wert von "Inheritance Visibility" auf public stellen. 5.3.Allgemein Löschen von Objekten Wird z. B. eine Klasse in einem Klassendiagramm mit der Taste Entf(ernen) gelöscht, so wird die Klasse nur aus dem Diagramm entfernt. Sie existiert im Modell weiter. Alle Beziehungen, die sie in dem Klassendiagramm zu anderen Klassen hatte, bleiben erhalten. Um eine aus einem Diagramm entfernte Klasse wieder einzufügen, selektiert man die Klasse zu der Beziehungen existieren und wählt Related Elements Display Parts anzeigen. Über die Checkbox unten links, Alway Create new Symbols, wird festgelegt ob für die Anleitung MagicDraw 11 Version

12 eingefügten Klassen neue Klassensymbole angelegt werden, oder eventuell vorhandenen Klassen verwendet werden. Soll ein Element aus dem Modell komplett gelöscht werden, so erreicht man dies im Diagramm mit Strg + D oder der Menüfunktion Bearbeiten/Löschen. Einbindung anderer Elemente Elemente die nicht (mehr) im Diagramm angezeigt werden, können ganz einfach via Drag and Drop aus dem Modell-Browser hinzugefügt werden. Dokumentation MagicDraw kann automatisch eine komplette Dokumentation erstellen. In der Spezifikation eines jeden Objektes kann Dokumentation hinterlegt werden. Hierzu muss einfach links der Zweig Documentation gewählt und der entsprechende Text eingegeben werden. Dokumentation zu Klassen, Methoden und Attributen wird im Quellcode als Kommentar eingefügt. Constraints Um ein Constraint für eine Assoziation hinzuzufügen müssen die Spezifikation der Verbindung geöffnet werden und dort unter Constraints ein neuer Constraint angelegt werden. Dort kann dann in den Spezifikationen der Constrainttext angegeben werden. Leserichtung Die Leserichtung kann mit der rechten Maustaste im Contextmenü unter Show Direction Arrow eingeblendet werden. Im selben Menü gibt es auch die Funktion Reverse Arrow Direction. Der Text für die Leserichtung kann nun entweder direkt hinter dem Pfeil eingegeben werden, oder in den Spezifikationen der Assoziation unter Name. Anleitung MagicDraw 12 Version

13 6.Sequenzdiagramme Die gewünschten Klassen können einfach per Drag and Drop aus dem Containment-Baum in das Sequenzdiagramm gezogen werden. Nach dem Erzeugen einer Call Message gibt man im Spezifikationseditor der Nachricht einen Namen und wählt unter Signature (operation) eine Methode, die diese Nachricht aufruft. Existiert die aufgerufene Methode in der Klasse nicht, so legt man die Nachricht im Diagramm an, gibt ihr einen Namen und drückt dann den grünen Punkt hinter dem Nachrichtennamen. Dadurch wird die entsprechende Methode in der Klasse erzeugt. Neue Instanzen können mit erzeugt werden. Die Instanzen können mit wieder gelöscht werden. 7.Codegenerierung MagicDraw kann aus den UML Modellen Coderahmen generieren. Unterstützt werden die Programmiersprachen C++, Java und C#. 7.1.Aufsetzen der Codegenerierung Bevor man Code generieren kann, muss man MagicDraw mitteilen, welche Klassen in welche Dateien in welchem Verzeichnis erzeugt werden sollen. Diese Aufgabe erfüllt bei MagicDraw ein Code-Engineering-Set. Um eine Codegenerierung einzurichten, führen Sie einen Rechtsklick auf den Zweig Code-Engineering-Sets im Modellbaum aus, wählen New und dann die gewünschte Sprache. Für C++ wählen Sie bitte ANSI C++, da wir oft unter Linux entwickeln. Geben Sie dem Set einen entsprechenden Namen. Nun muss das Set Editiert werden (Rechtsklick Edit). Hier werden nun die gewünschten Objekte aus dem Modell Anleitung MagicDraw 13 Version

14 gewählt. Gehen Sie hierzu in den Reiter Add Data from Model und wählen die entsprechenden Klassen. Oben kann unter Working Directory noch der Pfad gewählt werden, wo die Dateien erzeugt werden sollen. Einstellungen des Code-Engineering-Set Bevor der erste Code generiert wird, sollte man den Stil für die Generierung von Code setzen. Ansonsten kommt es beim Reverse Engineering zu hässlichen Verdopplungseffekten. Unter Options->Project->Code Engineering->C++ Language Options kann man verschiedene Stile auswählen. Geschickt sind folgende Einstellungen: Während der Generierung legt MagicDraw für den existierenden Code automatisch ein Backup in einer.bak Datei an. Auch veränderter Code in den Dateien wird nicht gelöscht Anleitung MagicDraw 14 Version

15 oder überschrieben. Wählen Sie aber trotzdem zur Sicherheit Code kommentieren um bei Problemen noch auf den alten Code zurückgreifen zu können. Mit einem Rechtsklick auf das entsprechende Engineering Set und Generate kann der Code erstellt werden. Vorher sollten Sie Ihr Modell aber jedenfalls auf Konsistenz prüfen. 7.2.Überprüfung des Modells Damit die Codegenerierung das erwünschte Ergebnis liefert, muss das Modell konsistent sein. Häufig kommt es zu Fehlern, weil Assoziationen nicht benannt sind oder die Multiplizitäten fehlen. Schwerwiegende Probleme entstehen, wenn Ihre Klassen zyklisch voneinander abhängen und trotzdem Code generiert wird. Fehler werden im Nachrichtenfenster angezeigt und sollten unbedingt bereinigt werden. Um zyklische Abhängigkeiten zwischen Klassen schnell sehen zu können, ist es geschickt eine Abhängigkeitsmatrix zu erstellen. Unter Analyze Dependency Matrix Matrix Tempates wählt man Class_Association und selektiert "Make column same as row" und "Take all Model as default scope". Dann klickt man auf "Rebuild" und sieht eine Matrix mit den Abhängigkeiten. Ein Kreuz bedeutet, dass es eine beidseitige Abhängigkeit gibt. Im normalen Praktikumsumfang gibt es keinen Grund für zyklische Abhängigkeiten. Deshalb sind sie einfach ein Zeichen für einen ungeschickten Entwurf mit unnötigen Abhängigkeiten und müssen entfernt werden. 7.3.Erzeugen von Modellteilen Häufig soll bei der Code-Generierung nur ein bestimmter Teil des Modells erzeugt werden (z.b. wegen iterativer Entwicklung). Dabei entstehen oft Probleme, weil es Abhängigkeiten zu dem Modellteil gibt, der nicht generiert werden soll. Im Code tauchen Klassen auf, für die es noch keine Header gibt usw. Das Ergebnis sind Compilerfehler, die in der Regel durch auskommentieren gelöst werden. Importiert man dann den lauffähigen Code in das Modell werden oft die auskommentierten Attribute und Assoziationen gelöscht. Anleitung MagicDraw 15 Version

16 In der Abbildung sollen die Klassen A und C (ohne B und D) generiert werden. Ein bequemer Trick zur Lösung des Problems ist die Einführung von temporären Dummyklassen. Zur Klasse A wird die Klasse A_Dummy angelegt. Anschließend werden alle Assoziationspfeile von A an die Dummyklasse umgehängt (analog für C). Dadurch sind A und C nun vom Rest des Modells entkoppelt und können einzeln generiert werden. Wenn der Code von A und C implementiert und importiert wurde, werden die Assoziationen wieder zurückgehängt (da jede Klasse eine eigene Dummyklasse hat, weiß man genau wohin) und die Dummyklassen gelöscht. 7.4.Reverse Engineering Auch hier müssen wieder die Eigenschaften des Code Engineering Sets geändert werden. Nach dem die Klassen und Dateien von MagicDraw erstellt worden sind, oder weitere noch nicht modellierte Softwareteile, können diese in MagicDraw aktualisiert werden. Hierzu gehen Sie in die Eigenschaften Ihres Code Engineering Sets bleiben diesmal aber auf dem Reiter Add Files. Hier müssen Sie nun die gewünschten Dateien auswählen. Auch ist es wichtig, dass das korrekte Working Package ausgewählt wird. Mit einem Rechtsklick auf das Code Engineering Set kann nun der Punkt Reverse gewählt werden. Wenn während der Entwicklung neue Klassen hinzugefügt worden sind, müssen die Dateien in den Spezifikationen des Code Engineering Set inkludiert werden. Dadurch werden sie vom System erfasst. Wenn diese neuen Klassen in MagicDraw verändert werden, müssen sie natürlich auch dem Forward-Engineering hinzugefügt werden (siehe oben). 8.Dokumentation Da MagicDraw leider nur sehr spezialisierte Reports anbietet haben wir als Fachbereich ein eigenes Template für die Gesamtdokumentation Ihres Entwurfs erstellt. Dieses muss unter heruntergeladen werden. Anleitung MagicDraw 16 Version

17 Zur Installation des Reporttemplates muss unter Tools der Report Wizard aufgerufen werden. Dort muss unter New ein Name für das Template gewählt werden. Unter Template File muss man die heruntergeladene rtf-datei auswählen. Die weiteren Felder sind obsolet und das Template kann einfach angelegt werden. Zur Verwendung des Reporttemplates muss dieses ausgewählt werden. Im nächsten Bildschirm muss Default gewählt werden. Der folgende Bildschirm beinhaltet den zu dokumentierenden Scope. Hier sollte der gesamte Data Zweig hinzugefügt werden, soweit sie nicht konkrete Bereiche Ihres Entwurfes auswählen wollen. Nach der Spezifizierung des Namens (mit Endung.rtf) kann der Bericht nun generiert werden. Die Erstellung kann einige Sekunden in Anspruch nehmen. Zum öffnen des Berichtes muss er mit Libre Office, oder vergleichbar, geöffnet werden. 9.Tastenkürzel Tasten STRG + D Entf STRG + 1 STRG + Umschalt + 1 STRG + 2 STRG + Umschalt + 2 STRG + 3 STRG + Umschalt + 3 STRG + 4 Bedeutung Objekt endgültig löschen Objekt ausblenden ODER löschen(je nach Diagramm/Objekt) Klassendiagramme anzeigen Neues Klassendiagramm erzeugen Use-Case-Diagramme anzeigen Neues Use-Case-Diagramm erzeugen Kommunikationsdiagramme anzeigen Neues Kommunikationsdiagramm erzeugen Sequenzdiagramme anzeigen Anleitung MagicDraw 17 Version

18 STRG + Umschalt + 4 STRG + 5 STRG + Umschalt + 5 STRG + 6 STRG + Umschalt + 6 STRG + 7 STRG + Umschalt + 7 STRG + 8 STRG + Umschalt + 8 STRG + 9 STRG + Umschalt + 9 Neues Sequenzdiagramm erzeugen Zustandsautomatendiagramme anzeigen Neues Zustandsautomatendiagramm erzeugen Protokoll-Zustandsautomatendiagramme anzeigen Neues Protokoll- Zustandsautomatendiagramm erzeugen Aktivitätsdiagramme anzeigen Neues Aktivitätsdiagramm erzeugen Implementierungsdiagramme anzeigen Neues Implementierungsdiagramm erzeugen Kompositionsstrukturdiagramme anzeigen Neues Kompositionsstrukturdiagramm erzeugen Anleitung MagicDraw 18 Version