Version Control Best Practices für Enterprise Architect
Contents
1. E Get All Latest anwenden um sicherzustellen dass Sie ber das gesamte Modell verf gen Best Practice 9 ii Package A und Package B auschecken von Enterprise Architect f r diesem Zug erforderlich iii Element X von Package A in Package B schieben iv Package A und Package B einchecken mittels Check in Branch Best Practice 10 Project Browser x Project Browser x amp Model amp Model S M Model S AE Model 9 0 Package A DJ Package A Ex Package B Ev Abbildung 12 Das Verschieben eines Elements ndert semantisch beide Pakete Wir m ssen daher beide Pakete auschecken Ein Hinweis zu Sequenz und Kommunikations Diagrammen Bei der Erstellung von Sequenz Modellen ist es blich die Classifier wie Elemente in der Klasse Domain Model oder Akteure im Use Case Modell in verschiedene Pakete aus Sequenz Diagrammen die diese Elemente nutzen zu trennen Dies ist sinnvoll da es eine bessere Organisation des Modells erm glicht Ein Beispiel f r eine Modell Hierarchie ist in Abbildung 13 dargestellt Project Browser x amp Model 4 Model View H g Use Cases B Actors 23 Actors Administrator g Customer S g Domain Model 33 Domain Model E ClassA E ClassB S Sequence Diagrams Disarm 1 Abbildung 13 Anwendung des Sequenz Diagram Pakets Bei der Verwendung von Classifiern aus diesem externen Pakete ist es jedoch am besten Instanzen auf Sequenz Diagrammen zu ers2. e einer einzelnen Datei reduziert Hinweis Der Add Branch to Version Control Befehl wird Sie zum Export as Model Branch auffordern und es wird empfohlen diese Option auszuw hlen Eine Modell Branch Datei EAB gibt Ihnen einen bequemen Bezug auf den Unterbaum den Sie exportieren Es ist eine kleine Datei die in f r Menschen lesbaren Begriffen benannt werden kann im Gegensatz zu einer GUID Sp ter wenn Sie oder ein anderes Teammitglied zu einem Modell Repository von Grund auf neu f llen muss k nnen Sie dies einfach ber die Import a Model Branch Befehl bewirken Wie Versionskontrolle selektiv anzuwenden ist Anderenfalls wenn Sie ein verteiltes Team haben k nnen Sie Cross Paket Abh ngigkeiten zwischen versionskontrollierten Pakete reduzieren Dies erfordert dass Sie nicht unabh ngige Versionskontrollen von untergeordnete Pakete durchf hren Stattdessen werden untergeordnete Pakete mit dem bergeordneten Paket der XMI Datei in der Version Control Repository inkludiert Der Ablauf ist Folgender 1 Definieren Sie welche Top Level Pakete in sich geschlossene Modell Portionen ausreichend darstellen 2 F r jedes Paket i Bedienen Sie die rechte Maustaste und w hlen Sie Konfigurieren oder verwenden Sie das Tastaturk rzel Strg Alt P n tzlich wenn dieselbe Aktion f r mehrere Pakete wiederholt werden muss ii W hlen Sie die entsprechende Versionskontroll Konfiguration den Standard XMI Dateiname wenn n tig
3. Repository enth lt immer die neuesten Modell Informationen Die gespeicherten Revisionen der Version Control Repository stammen aus dem Modell Repository Best Practice 1 In einem Centralized Team Modell wenden Sie Version Control auf alle Pakete in der Modell Hierarchie an die sub Pakete und Root Knoten enthalten um das Potenzial f r paralleles Arbeiten zu maximieren Best Practice 2 Verwenden Sie Enterprise Architects rollenbasierte Benutzer Sicherheit um Funktionalit t durch Benutzer und Gruppenberechtigungen zu beschr nken und Workflow Scripting zu erm glichen Beispielsweise k nnen Sie eine Security Gruppe anlegen die ber die Berechtigung zur Verwaltung versionskontroller Pakete verf gt und Berechtigungen wie Configure Version Control und Configure Packages aktivieren Durch die gezieltes Hinzuf gene administrativer Benutzer zu einer Gruppe k nnen Sie effektiver steuern welche Pakete nach Ihren Vorgaben zur Version Control hinzugef gt oder entfernt werden Dar ber hinaus k nnen Sie bestimmen welche Benutzer Pakete auschecken k nnen indem Sie das Use Version Control Recht aufheben damit Benutzer nur mehr Lese Zugriff auf versionskontrollierte Pakete haben Sie k nnen auch Zugriffsrechte Ihres Version Control Systems auf bestimmte Ordner einschr nken um Lese Schreibzugriff der in diesen Ordnern gespeicherten Paketen zu beschr nken N B Es wird nicht empfohlen die rollenbasierte Sicherheit zu verwenden um Benut
4. einem verteilten Teamumfeld in dem Mitglieder lokale EAP Dateien bearbeiten gibt es keine automatische Aktualisierung der rollenbasierten Sicherheitsinformationen von Enterprise Architect da sie nicht im Repository der Versionskontrolle gespeichert wird Daher ist es nicht empfehlenswert rollenbasierte Sicherheit in diesem Szenario anzuwenden Cross Package Abh ngigkeiten verwalten ia merian aa Da Pakete unabh ngig voneinander gesteuert werden k nnen ist pese rn es m glich ein Modell absichtlich oder unabsichtlich zu Pant splitten sodass ein Element an einem Ende einer Beziehung nicht in in der Kopie vorhanden ist welche Sie gerade bearbeiten Dies kann beabsichtigt werden um den Umfang der Modell informationen einzuschranken der von einem Editor des Modells erforderlich ist Ein solches Szenario kann jedoch zum Verlust der Modellinformationen f hren Betrachten Sie das Beispielmodell in Perasa Abbildung 5 Etoma Package AzChild Die Klassen Eltern Parent und Kind Child werden in abgetrennten versionskontrollen Paketen definiert und besitzen eine Erbschaftsbeziehung dazwischen Kind ist in Paket A definiert w hrend Eltern in Paket B definiert ist Dieses Szenario zeigt ein Beispiel f r eine Cross Paket Abh ngigkeit zwischen versionskontrollierten Paketen Figure 5 Parent and Child defined in separate Packages Die Modell Hierarchie ist im Enterprise Architects Pro
5. Classifier verweisen bei Sequenz und Kommunikations Diagrammen Somit werden Instanzen und Diagramme im gleichen Paket beihalten Szenario 3 Mehrfache Standorte Immer h ufiger teilen gro e Konzerne Modell Informationen ber geografisch verteilte Entwicklungsstandorte Die Herausforderung besteht darin jeden Standort mit den aktuellsten Modellinformationen auf dem neuesten Stand zu halten W hrend DBMS Ebenen Replikation zwischen Standorten m glicherweise mit Synchronisations Tools m glich w re bietet der Einsatz von versionskontrollierten Paketen eine einfache und effektive Alternative Die Situation stellt eine Kombination aus den Szenarien 1 und 2 dar Jeder Standort kann von einem Modell Repository profitieren welches auf einem lokalen DBMS gehostet wird oder es k nnen EAP Dateien von den einzelnen Editoren verwendet werden wie in Abbildung 15 dargestellt deployment Distributed Team Figure 15 Das Version Control Repository kann die Replikation von Modellen ber mehrere Entwicklungsstandorte erm glichen Wenn an mehreren Orten agiert wird bernimmt jedes gemeinsame Modell Repository wie in Szenario 1 beschrieben eine Rolle hnlich wie bei einem lokalen Repository wie in Szenario 2 beschrieben Das gleiche Verfahren wie in Szenarien 1 und 2 beschrieben gilt f r die Einrichtung von Modell Repositories in diesem Szenario f r gemeinsame DBMS Modelle bzw lokale EAP Dateien Die
6. Enterprise Architect k nnen als kontrolliert markiert werden ohne mit einem separate Version Control System verbunden zu werden Ein Controlled Package wird von Enterprise Architect mit einer entsprechenden XMI Datei erkannt und kann mit dieser auch synchronisiert werden W hrend kontrollierte Pakete im Gegensatz zu Version Controlled Paketen nur begrenzt ber Dateiverwaltungs Befehle verf gen k nnen sie auch geladen gespeichert und konfiguriert werden und zwar komfortabler als das manuelle Durchf hren von XMI Import Export Operationen auf jedem Paket Role Based User Security Enterprise Architect s User Security bietet Editoren einen Mechanismus zum Modell Log in welcher zwei wichtige Funktionen erf llt Erstens erm glicht es Unternehmen die Bearbeitungsfunktionen die f r Benutzer verf gbar sind zu beschr nken Zweitens erlaubt es Pakete und Elemente pro benutzer und gruppespezifisch zu sperren Wenn Versionskontrolle in einem Modell verwendet wird ist nur die erste Funktion der User Security ist anwendbar d h Die Beschr nkung der Verf gbarkeit von Bearbeitungsfunktionen Sollte jedoch Versionskontrolle nicht in einem gemeinsamen Modell verwendet werden spielt User Security bei der Unterst tzung kooperativer Modellierungstools eine wichtige Rolle Durch die Anwendung von Sicherheitssperren k nnen Teammitglieder das gegenseitige berschreiben von nderungen anderer vermeiden sowie ungewollte nderungen durch Benutzer
7. Version Control Best Practices f r Enterprise Architect SPARA SYSTEMS www sparxsystems com Alle Unterlagen Sparx Systems PTY 2010 Glossar Einleitung Was habe ich von Version Control Modelle Was heisst Version Control in Enterprise Architect Team Deployment Centralized or Distributed Szenario 1 Centralized Team Empfohlener Vorgang f r Version Control Modelle Empfohlene Vorgehensweise nderungen zur ckzusetzen Rollback Szenario 2 Distributed Team und lokale Modelle Empfohlene Verfahren zur Versionskontrolle von Modelle Cross Package Abh ngigkeiten verwalten Empfohlene Verfahren f r die sichere Einreichung von nderungen Empfohlene Verfahren f r Rollback zur cksetzen von nderungen Szenario 3 Multiple Site Locations Anhang A Enterprise Architect Meta Daten die nicht in der Version Control Repository gespeichert sind Anhang B Built In Collaboration und Change Management Tool Glossar Baseline Model Baseline In Enterprise Architect bezieht sich Baseline auf eine Package Momentaufnahme zu einem bestimmten Zeitpunkt Der Schnappschuss wird in der Modell Repository als komprimierte XMI gespeichert und bildet die Grundlage der Compare and Merge Funktionalit t von Enterprise Architect Check in Der Prozess der Einreichung von nderungen an das Version Control Repository In Enterprise Architect f hren Sie diesen Befehl auf ein Paket aus das Sie ausgecheckt haben D
8. Verwaltung von Cross Package Abh ngigkeiten folgt auch den Best Practices wie in Szenario 2 beschrieben Ber cksichtigt werden muss auch die Verwaltung von Enterprise Architects Reference Data so dass gemeinsame Projektdefinitionen ber jeden Standort geteilt werden k nnen Eine n here Beschreibung von Reference Data finden Sie in Anhang A Enterprise Architect bietet einen bequemen Mechanismus f r die bertragung des gesamten Modell Repositories zwischen Standorten einschlie lich Reference Data ber die Projekt Transfer Funktion Zum Beispiel k nnen Sie das Modell das im DBMS am Standort 1 erstellt wurde in eine EAP Datei und diese an andere Standorte verteilen Diese Standorte k nnen dann mit der Projekt Transfer Funktion eines leeren DBMS Repositories durch die bertragung von der EAP Datei best ckt werden Das Enterprise Architect Handbuch beschreibt in Detail wie die Projekt Transfer Funktion verwendet wird Anhang A Enterprise Architect Meta Daten die nicht in der Version Control Repository gespeichert sind Hier setzen wir uns mit Versionsverwaltung von Modell Paketen und den dazugeh rigen Daten auseinander Es sollte beachtet werden dass Enterprise Architect Projekte ob EAP Datei oder DBMS Repository zus tzliche Meta Daten enthalten bekannt als Referenzdaten Diese Daten k nnen verwendet aber nicht direkt innerhalb eines Pakets definiert werden Beispiele f r Enterprise Architects Reference Data sind Vorlagen f
9. Wissen wollen ob die Anwendung der Versionskontrolle auf Ihr Modell von Vorteil sein k nnte und welche Alternativen zur Verf gung stehen oder Best Practice Empfehlungen f r spezifische Enterprise Architect Einsatzszenarien ben tigen oder bereits Erfahrung mit Version Control Modellen haben und verbessern wollen wie diese verwaltet werden Was habe ich von Version Control Modelle Einige Vorteile der Verwendung von Version Control Systems sind z B die Steigerung des Potenzials f r parallele und verteilte Arbeit verbesserte Verfolgung und Zusammenf hrung von nderungen im Zeitablauf sowie die Automatisierung der Verwaltung vom Revisionsverlauf Im Folgenden sind einige spezifische Vorteile aufgelistet die durch die Anwendung der Versionskontrolle auf eine Modellierungsumgebung realisiert werden k nnen Sie sind besonders relevant wenn Modelle gemeinsam von mehreren Editoren benutzt werden die eventuell geografisch getrennt sind Unterst tztung von global verteilter Modell Bearbeitung durch eine bequeme und effektive Methode Modelle zu vervielf ltigen Erleichterung der Zusammenarbeit ber mehrere Projekte durch Wiederverwendung von gemeinsamen Modelldaten Verbesserung der Leistung f r weit verstreuten Teams ber langsame Netzwerke indem die lokale Speicherung von Modellen erm glicht wird wobei nur die nderungen global bermittelt werden F rderung geordneter Ver nderungen gegen ber chaotischer Ver n
10. anpassen und lassen Sie die brigen Optionen als Standard Verfahren zum Anwendung von Versionskontrolle auf ein neues leeres Modell wenn es gerade gebaut wird 1s Erstellen Sie eine Paket Skelett Struktur f r das Modell 2 Pakete zur Versionskontrolle mit einem der folgenden Ans tze hinzuf gen a Verwenden Sie den Befehl Add Branch to Version Control Befehl um die Versionskontrolle auf alle Pakete anzuwenden oder b Versionskontrolle auf einzelne Pakete anwenden i Bedienen Sie die Rechte Maustaste und Configure ausw hlen oder verwenden Sie die Tastatur Short Cut Strg Alt P ii W hlen Sie die entsprechende Versionskontroll Konfiguration aus den Standard XMI Dateiname wenn n tig anpassen und lassen Sie die brigen Optionen als Standard 3 Wenn ein neues Paket in dem Modell hinzugef gt wird erscheint der Neues Paket erstellen Dialog und stellt Ihnen die Option zur Verf gung ob es zur Versionskontrolle hinzugef gt werden soll Fall Sie in einer verteilten Team Umgebung arbeiten sobald das Modell eingerichtet wird B Alle Pakete einchecken und als Master Modell beiseite legen 2 Verteilen Sie Kopien dieser Originalkopie an die Teammitglieder
11. derungen Hilft St rungen durch die Trennung von work in progress und fertiger Arbeit zu minimieren Hilfe bei der Automatisierung von Kommunikation innerhalb eines Teams durch den Koordinierten Zugang zu kontrollierten Informationen wodurch versehentliche nderungen verhindert werden Hilfe bei der Einhaltung aufeinanderfolgender Revisionen von Work to Date mit n tzliche F higkeiten wie undo um falsche nderungen zu widerrufen oder roll back um bis zur letzten guten Version einen Fehler r ckg ngig zu machen oder eine Wiederherstellung nach ungewollter L schung oder nderung durchzuf hren H lt ein Arbeitsverlauf fest und verfolgt nderungen an einem Modell um besser nachvollziehen zu k nnen wer was ge ndert hat und wann Was heist Version Control im _ a 1 Version Control beim Root View Package or Sub Package Enterprise Architect Enterprise Architect Version Control gilt f r Pakete innerhalb eines Modells Das Paket ist das prim re organisatorische Konstrukt f r UML Modelle Auf jedes Paket kann Versionskontrolle angewandt werden egal ob es der Root Knoten des Modells ein View oder ein Sub Paket ist siehe Abbildung 1 Enterprise Architect unterst tzt prim r zwei M glichkeiten die Versionskontrolle auf Pakete in einem Modell anzuwenden Model Baselines Diese eingebaute Funktion speichert Point in Time Snapshots von einem Paket in der Modell Repository selbst Das Modell Baselines Konzep
12. die Parent Klasse semantisch nicht ndern indem wir die Erbschaft Beziehung entfernen werden Informationen ber den Connector in den XMIs von beiden Paketen gespeichert Um sicherzustellen dass der Connector nicht zu einem sp teren Zeitpunkt ber das XMI f r Paket B wiederhergestellt wird z B indem Get Latest ausf hrt wird m ssen wir beide Pakete aktualisieren Best Practice 10 Atomic Commits Beim Einchecken einer in sich geschlossenen nderung dass mehrere Pakete betrifft verwenden Sie bitte Enterprise Architects Check in Branch Befehl Dieser Befehl erm glicht es Ihnen alle betroffenen Pakete gleichzeitig zu bergeben damit wird verhindert dass andere Editoren nur einen Teil Ihrer Aktualisierung auschecken und somit m gliche Verluste Es erm glicht Ihnen auch den gleichen Check in Kommentar f r alle Pakete und das Change Set logisch zu gruppieren Best Practice 11 Kleine in sich abgeschlossene nderungen regelm ig bergeben Wenn Sie mehrere Pakete ber einen l ngeren Zeitraum ausgecheckt halten werden Sie wahrscheinlich zahlreiche unabh ngige nderungen vornehmen die Zahl an Cross Paket Abh ngigkeiten die durch die nderungen betroffen sind erh hen und die mit Rollback Ver nderungen verbundene Komplexit t steigern Modeling Classifier Referenzen zwischen zwei versionskontrollierten Pakete Gehen wir wieder davon aus dass wir ber zwei unabh ngig versionskontrollierte Pakete A und B verf gen Ang
13. enommen Paket A hat ein Element X und Paket B enth lt ein Element Y Nun wollen wir ein Referenzmodell von Element X auf Element Y als Classifier erstellen Einige Modellierung Beispiele in diesem Fall sind Festlegung der Art des Attribut im Element X Angeben des R ckgabetyps oder Parameter Typen von einer Operation im Element X Angabe der Classifier f r Element X wobei X eine Instanz oder UML Objekt ist class Package A x Package B Y attribute1 Y operation1 p1 Y Y Abbildung 11 Class X bezieht sich auf Class Y als Classifier f r Attribute und Operationsparametertypen Class Y ist in einem separaten versionkontrollierte Paket Package B In solchen Situationen modellieren wir wieder eine Cross Package Abh ngigkeit obwohl keine explizite Beziehung zwischen den Elementen gezogen wird Die empfohlene Vorgehensweise f r die Erstellung oder Aktualisierung dieser impliziten Abh ngigkeiten ist i Get All Latest anwenden um sicherzustellen dass Sie ber das gesamte Modell verf gen Best Practice 9 v Package A und Package B auschecken vi Hinzuf gen Aktualisieren oder L schen der Classifier Referenz en vii Package A und Package B einchecken mittels Check in Branch Best Practice 10 Da wir Paket B oder deren Elemente nicht durch die Einstellung von Classifier Referenzen in einem anderen Package semantisch ndern ist die folgende Frage sinnvoll Wieso soll Package B berhaup
14. erreicht werden und das detaillierte Modellieren von UML Abh ngigkeitsbeziehungen dazwischen Pflegen Sie die Paket Diagramme in einer Kopie Ihrer Master EAP Datei wo alle Pakete zur Verf gung stehen Definieren Sie Modellierungskonventionen und richtlinien welche Modellierer von der Einf hrung ungeplanter Abh ngigkeiten abhalten Enterprise Architect verf gt ber Tools die Ihnen dabei helfen die Beziehung eines bestimmtes Elements zu anderen Elementen im Modell zu identifizieren Beispiele hierf r sind Traceability Window Relationships Window und Relationship Matrix Skripte auf der Sparx Systems Enterprise Architect Community Website wie das Skript zur Paketabh ngigkeit das Ihnen bei der automatischen Erstellung von Diagrammen hilft k nnen auch hilfreich sein Best Practice 9 Arbeiten Sie immer mit dem gesamten Modell Ein Gro teil der Komplexit t die mit Cross Paket Abh ngigkeiten verbunden ist kann vermieden werden indem Sie sicherstellen dass Ihre lokale EAP Datei eine Kopie des gesamten Modells enth lt statt eines Teilmodells Indem Sie mit einer Kopie der Master EAP Datei beginnen und regelm ig das Get All Latest Kommando ausf hren minimieren Sie das Risiko nderungen mit fehlenden Abh ngigkeiten an das Version Control System zu bergeben Es wird empfohlen immer Get All Latest vor dem Auschecken eines Pakets auszuf hren Empfohlene Verfahren f r die sichere Einreichung von nderungen Die fo
15. gigkeiten zwischen versionskontrollierten Paketen vereinfacht werden Um dies zu erreichen m ssen Sie bestimmen ob Versionskontrolle nicht in den unteren Ebenen der Modell Hierarchie anzuwenden ist Dies ist ein Kompromiss zwischen Verminderung von potenziell fehlenden Cross Package Abh ngigkeiten Leistung und parallelem Arbeiten Best Practice 6 Definieren Sie ein Teammitglied als Model Manager der f r die Aufrechterhaltung einer Master EAP Datei verantwortlich ist Die EAP Datei wird nicht f r die tagt gliche Arbeit eingesetzt werden Vielmehr ist es ihr Zweck ein Ausgangspunkt f r neue Team Mitglieder zu sein Die Kopie des Modells welches ein neues Team Mitglied erh lt soll keine Pakete enthalten die bereits von einem anderen Benutzer als ausgecheckt markiert sind Die Master EAP Datei sollte aus dem Repository der Versionskontrolle mit Get All Latest in Enterprise Architect aktualisiert werden Alle neu erstellten Top Level Pakete m ssen zu dem Modell mit Get Package hinzugef gt werden Definieren Sie eine Vorgehensweise um Model Manager auf neue Pakete hinzuweisen die zur Versionskontrolle hinzugef gt wurden Sie k nnen eine konsistente Schreibweise von Konfigurations IDs auf jeder Kopie erzielen indem Sie mehrere Kopien einer Master EAP Datei verwenden und es Enterprise Architect erm glichen den Benutzer zur Eingabe der Definitionen der erforderlichen Version Control Konfigurationen aufzufordern Best Practice 7 In
16. glied des Teams in der gleichen zentralen Lage und ber ein Hochgeschwindigkeits Netzwerk verbunden Werden die Editoren eher aus der Ferne selbstst ndig arbeiten und von einem geteilten Netzwerk f r l ngere Zeit getrennt sein Gibt es mehrere Schl sselstandorte in der Welt wo das Modell geshared und bearbeitet wird Antworten auf diese Fragen bestimmen wie das Enterprise Architect Modell selbst f r Sharing zur Verf gung steht und somit wie Versionskontrolle angewendet wird In den folgenden Abschnitten beschreiben wir wie Versionskontrolle in h ufig auftretende Szenarien angewendet werden soll Nachstehend sind die Szenarien die wir im Detail betrachten werden aufgelistet 1 Zentralisiertes Team Alle Editoren sind ber ein Hochgeschwindigkeits Netzwerk verbunden und k nnen somit an dem gleichen physikalischen Modell in einem Datenbank Management System DBMS beteiligt sein 2 Verteiltes Team Vielleicht m ssen sie ihren Beitrag am Modell offline leisten und daher eine lokale Kopie des Modells auf der eigenen Maschine erstellen 3 Mehrfache Standorte Mehrere geografisch verteilte Standorte arbeiten an demselben Modell Es gibt keine High Speed Verbindung zwischen Standorten Teams an jedem Standort haben gemeinsamen Zugriff auf eine lokale Kopie des Modells N B K nftige Versionen dieses Whitepapers werden sich auch mit dem Konzept der Verteilung von Modell Bibliotheken auseinandersetzen das sind Modelle die als eige
17. ie sicher dass Team Mitglieder die entsprechende Client Software installiert haben b Erstellen Sie eine Version Control Repository mit einem leeren Projekt das f r Enterprise Architect verwendet wird 3 Version Control Clients einrichten a Verwenden Sie einen Client Rechner um eine Arbeitskopie des leeren Projekts auszuchecken und in einen lokalen Ordner abzulegen b In Enterprise Architect definieren Sie eine Version Control Konfiguration die auf Dateien der Arbeitskopie zugreift Der Prozess eine Version Control Konfiguration zu definieren variiert je nach Ihrem Version Control System Jeder Benutzer der sp ter auf das DBMS Modell Repository zum ersten Mal zugreift wird aufgefordert seine lokale Version Control Einstellungen zu konfigurieren Sie werden die Konfiguration die Sie f r dieses Modell erstellt haben wiederverwenden und den Pfad zu ihrer eigenen Arbeitskopie Dateien und den Version Control Client als ausf hrbar festlegen 4 Pakete unter kontrolle setzten a Versionskontrolle f r einzelne Pakete in Enterprise Architect anwenden Siehe Anhang C f r weitere Details Nach Umsetzung der genannten Setups werden Nutzer Pakete in Enterprise Architect unter ihrem Version Control User Account auschecken Der Checkout Prozess innerhalb von Enterprise Architect sperrt das Paket f r exklusive Bearbeitung durch den Benutzer Hier sind Get All Latest oder Get Latest grunds tzlich nicht notwendig denn das Modell
18. ieser aktualisiert dann das Version Control Repository mit Ihren nderungen und hebt Ihre Editiersperre f r das Paket auf Check out Der Prozess bei dem die neueste Version einer Datei aus der Version Control Repository abgerufen wird Die Ausf hrung dieses Befehls in Enterprise Architect berschriebt die ausgew hlte Pakete mit der neuesten Version und setzt f r Sie eine exklusive Editiersperre Commit So k nnen Sie Ihre nderungen an die Version Control Repository bergeben ohne Ihre Editiersperre auf die dazugeh rige n Datei en aufheben zu m ssen Dies entspricht in Enterprise Architect der Ausf hrung des Put Latest Kommandos DBMS Database Management System Um Hosting f r die Model Repository zu erm glichen unterst tzt Enterprise Architect einige relationale DBMS Produkte blicherweise wird ein DBMS verwendet wenn auf das Model Repository von mehreren Benutzern gleichzeitig zugegriffen wird EAP Enterprise Architect Projekt Die Abk rzung bezieht sich f r gew hnlich auf die Datei basierte Model Repository also EAP Datei Get Latest Ein Befehl das aus Enterprise Architect heraus auf ein ausgew hltes Paket ausgef hrt wird Es aktualisiert das Paket mit den aktuellsten Informationen aus dem Version Control Repository ohne eine Check out durchzuf hren zu m ssen Get All Latest aktualisiert alle versionskontrollierten Pakete innerhalb des Projektes Model Repository Enterprise Architect Speichermechan
19. igkeit ist besonders n tzlich wenn mehrere Teammitglieder das gleiche Modell Repository teilen Folgende Fragen hilft es zu beantworten Wer nderte welche Teile des Modells Wann wurde die nderung vorgenommen Was war der vorherige Zustand Audit Informationen werden direkt in der Enterprise Architect Model Repository gespeichert und nicht in der Version Control Repository Die Auditing F higkeit bietet ein fortlaufendes Protokoll der nderungen statt eines Point in Time Snapshots Audit Protokolle k nnen in eine Datei exportiert werden und sofortige nderungen von Protokollen k nnen direkt in Enterprise Architect verglichen werden Das Enterprise Architect Benutzerhandbuch bietet weitere Informationen ber Auditing Baseline Vergleichen und Zusammenf hren Enterprise Architect kann Paket Versionen direkt in das Modell Repository als Baselines speichern Damit k nnen Sie ein Paket mit einem fr heren Zustand vergleichen und unerw nschte nderungen r ckg ngig machen Da die Baseline im XMI Format existiert k nnen Sie auch ein Paket mit jeder XMI Datei vergleichen die zuvor aus diesem Paket exportiert wurde Dies erm glicht Ihnen gezielt nderungen welche von Kollegen auf lokalen Model Kopien durchgef hrt wurden zusammenzuf hren ohne ein Version Control System zu verwenden Das Enterprise Architect Benutzerhandbuch enth lt weitere Informationen ber Baselines vergleichen und zusammenf hren Controlled Packages Packages in
20. isch korrekte und indem Elemente und Diagramme im gleichen Paket gehalten werden es wird sichergestellt dass Nachrichten w hrend des Ein und Auschecken bewahrt werden Empfohlene Verfahren f r Rollback zur cksetzen von nderungen Rollback von nderungen oder Fehler zur cksetzen erfordert das gleiche Verfahren das f r die zentralisieten Teams beschrieben wurde Nachstehend sind alle Best Practices in diesem Abschnitt in Kurzform aufgelistet Best Practice 5 Versionskontrolle auf Low Level Pakete anwenden um das Potenzial f r paralleles Arbeiten zu steigern Gleichen Sie dies mit der entsprechenden Potenzialerh hung f r Abh ngigkeiten zwischen versionskontrollierten Paketen aus Best Practice 6 Einen Model Manager f r die Aufrechterhaltung einer Master EAP Datei beauftragen Best Practice 7 Die rollenbasierte Sicherheit ist nicht anzuwenden bei der Verwendung von lokalen EAP Dateien nicht verwenden um das Modell zu replizieren Best Practice 8 Planen Sie Ihre Paketabh ngigkeiten im Voraus und pflegen Sie die bekannten Abh ngigkeiten Best Practice 9 Immer mit dem gesamten Modell arbeiten Get All Latest vor dem Auschecken jedes Pakets anwenden Best Practice 10 Atomic Commits Verwenden Sie Check in Branch beim Einchecken einer nderung die mehrere Pakete betrifft Best Practice 11 Kleine in sich geschlossene nderungen regelm ig bergeben Best Practice 12 Verwenden Sie Instanzen die auf
21. ismus f r die Modell Informationen Wenn mehrere Benutzer gleichzeitig dasselbe Modell bearbeiten wird das Repository in der Regel DBMS basiert In verteilten Umgebungen in denen Team Mehrfachzugriff auf das Modell nicht m glich ist werden blicherweise stattdessen die lokalen EAP Dateien eingesetzt Enterprise Architect kann Ihr Version Control System f r den Informationsaustausch zwischen dem Model Repository und einem Version Control Repository verwenden um nderungen unter Teammitglieder zu kommunizieren Package Das prim re organisatorische Konstrukt in Enterprise Architect Modellen etwa vergleichbar mit einem Ordner im Dateisystem Ein Paket kann ein Modell eines Root Knotens eine Ansicht oder ein Sub Paket sein Put Latest Ein Befehl der aus Enterprise Architect heraus auf einem ausgew hlten Paket das Sie ausgecheckt haben ausgef hrt wird Es aktualisiert die Version Control Repository mit Ihren nderungen auf diesen Paket unter Beibehaltung seiner Checked out Status Entspricht etwa dem Einchecken eines Pakets das daraufhin gleich wieder Ausgecheckt wird Version Control Configuration In Enterprise Architect zeichnet eine Version Control Configuration Verbindungseinstellungen f r das Version Control Repository sowie den Pfad zu Ihrer lokalen Arbeitskopie auf Version Control Repository Der Speichermechanismus von dem Version Control System zur Speicherung von Revisionen insbesondere Modell Revisionen Versi
22. ject Browser dargestellt Abbildung 6 Project Browser x Bana 2 E ae ARO 5 amp Model 3 4E Model Q Inheritance A B S g Package A E Child 5 0 Package B g E Parent Abbildung 6 In Verbindung stehende Pakete unabh ngig voneinander Versionskontrolliert Wenn beide Pakete im Modell existieren ist die implizite Abh ngigkeit zwischen Paket A und B ber die angeschlossenen Elemente gegeben Umgekehrt wenn wir nur eines der Pakete in unserem lokalen Modell h tten w re die Abh ngigkeit gebrochen eines der erforderlichen Elemente w rde fehlen Die unmittelbare Folge w re dass alle auf dieses Verh ltnis bezogenen Diagramme unvollst ndig w ren Weiterhin falls das Paket eines unvollst ndigen Modells ausgecheckt und eine neue Revision bergeben wird dann ist die Beziehung in der resultierenden XMI nicht enthalten was zu einer semantischen nderung des Modells f hrt In jedem nicht trivialen Projekt werden Sie h chstwahrscheinlich Abh ngigkeiten zwischen versionskontrollierten Paketen modellieren Bisher haben wir nur ein Szenario ber cktichtigt wo dies der Fall ist In den folgenden Abschnitten betrachten wir andere spezifische Modellierungssituationen die Cross Paket Abh ngigkeiten und empfohlene Prozesse f r die sichere Bearbeitung mit einbeziehen Best Practice 8 Planen Sie Ihre Paketabh ngigkeiten im Voraus und pflegen Sie die bekannte Reihe von Abh ngigkeiten Dies kann mit UML Paket Diagrammen
23. l gespeichert als auch abgerufen werden XMI wird verwendet um Paketdaten in serielle Reihenfolge zu bringen sodass ein Point in Time Snapshot erstellt werden kann Enterprise Architect sorgt daf r dass nur ein einziger Benutzer jeweils ein bestimmtes Paket bearbeiten kann Dieser Ansatz stellt eine Lock Modify Unlock L sung dar die Revisionskonflikte vermeiden verhilft dies ist besonders n tzlich da XMI Dateien bin re Artefakte sind die man nicht direkt ber das Version Control System zusammenf hren kann deployment Interfaces Version Control Enterprise System Architect Abbildung 2 Enterprise Architect tauscht Daten mit dem Modell Versionskontrollsysteme mittels XMI Dateien Der Rest dieses Dokuments soll Ihnen dabei helfen Ihr Einsatzszenario f r Enterprise Architect festzustellen und geeignete Versionskontroll Ans tze vorzuschlagen F r jeden Ansatz werden auch spezifische Herausforderungen hervorgehoben welche ber cksichtigt werden m ssen Statt ausf hrliche how to Schritte zur Einrichtung Ihres Version Control Systems mit Enterprise Architect zu geben wird auf die relevanten Teile in der Enterprise Architect Bedienungsanleitungs verweisen Team Einsatz zentralisiert oder verteilt Der wichtigste Aspekt bei der Entscheidung ber die richtige Vorgehensweise f r das Version Controlling Ihres Modells ist wie die Modell Redakteure oder Autoren verteilt sind Ist jedes Mit
24. len um die Ver nderungen aus Abbildungen 8 10 zu implementieren wird eine nderung herbeigef hrt die die Elemente sowohl in Paket A als auch B semantisch ver ndert Deshalb m ssen wir beide Pakete berpr fen um die nderung vorzunehmen und anschlie end beide Pakete einchecken um sicher zu gehen dass die XMI Dateien in der Version Control Repository unserem aktuellen Modell entsprechen class Inheritance A B tance AB class Inheritance AB Package B Parent Package B Parent Package B Parent KH PERT le Package A Child Package A Child Package A Chlld Abbildung 8 Reverse Abbildung 9 Typ ndern Abbildung 10 Bidirektional Direction machen Die empfohlene Vorgehensweise zur Durchf hrung dieser nderungen ist wie folgt i Get All Latest anwenden um sicherzustellen dass Sie ber das gesamte Modell verf gen Best Practice 9 ii Package A und Package B auschecken iii Beziehung modifizieren iv Package A und Package B einchecken mittels Check in Branch Best Practice 10 4 Den Connector l schen Nehmen wir nun an wir haben unseren Connector im urspr nglichen Zustand wie in Abbildung 7 modelliert und wir wollen ihn l schen Derzeit ist es in Enterprise Architect notwendig dass wir den gleichen Prozess wie oben anwenden d h beide Packages m ssen augecheckt werden Obwohl wir
25. lgenden Szenarien beschreiben Situationen in denen Modell Updates mehrere versionskontrollierter Pakete beeinflussen aufgrund von vorhandenen Abh ngigkeiten Die Abh ngigkeit kann explizit sein wie eine UML Vererbungsbeziehung oder implizit beispielsweise wenn auf einen Classifier aus einem separat gesteuerten Versions Package verwiesen wird um einen Attribut Typ anzugeben Modellierung von Verbindungen zwischen zwei versionskontrollierten Packages Angenommen wir haben zwei unabh ngig gesteuerte versionskontrollierte Pakete A und B wie in den Abbildungen 5 und 6 modelliert Nehmen Sie nun an wir wollen die folgenden Bearbeitungsvorg nge zwischen den Elementen in den beiden Pakete durchf hren Erstellen Sie einen Verbinder aus einem Element in Paket A zu Paket B ndern Sie das Zielelement des Verbinders auf ein anderes Element Kehren Sie die Verbindungsrichtung um und ndern Sie die Typ und Modell Bidirektionalit t Den Verbinder l schen F r jede der oben genannten Modell Bearbeitungen definieren wir ein empfohlenes Verfahren zur Aktualisierung der entsprechenden Pakete Mithilfe des empfohlenen Verfahrens wird daf r gesorgt dass alle anderen Modell Editoren unsere Updates korrekt empfangen k nnen Das hei t die Bearbeitungen die wir in unser lokalen Kopie des Modells sehen spiegelt sich in den entsprechenden XMI Dateien wieder die f r die Aktualisierungen von allen anderen Modellen mit dem gleichen Version Control Repository
26. nst ndige projekt bergreifende Komponenten dienen und von einer beliebigen Anzahl von Verbrauchern wiederverwendet werden k nnen 1 Das Whitepaper Unternehmensweiter Einsatz von Enterprise Architect zeigt wie das Modellierungs Tool in verschiedenen Team Szenarien einzusetzen ist Szenario 1 Zentralisiertes Team In diesem Szenario sind alle Teammitglieder ber einen High Speed Netzwerk miteinander verbunden Sollten mehr als 5 Teammitglieder gleichzeitig Zugriff auf das Modell haben k nnen wir nicht mehr sicher auf eine einzige EAP Datei die sich auf einem Netzlaufwerk befindet zugreifen Stattdessen wird empfohlen mit einen dedizierten DBMS unser Modell zu hosten Der Vorteil der Verwendung einer gemeinsamen DBMS in dieser Situation im Gegensatz zu lokalen Kopien des Modells ist dass alle Teammitglieder das aktuelle Modell sehen und bearbeiten ohne eine separate Get Latest Synchronisation durchf hren zu m ssen deployment Centralized Team User 1 Us A y lt gt EA Client 1 N EA Client 2 A EA Cilent n Shared Model Repository Version Control Repoeltory Abbildung 3 ein zentrales Team linkt zu ein gemeinsames DBMS um das Modell zu bearbeiten Deshalb ist die Rolle des Version Control Repositories in dieser Situation nicht einen Mechanismus um die Verteilung der Modelldaten zu erm glichen dies ist eine Funktion die bereits durch das DBMS erreicht wird Stattdessen hilft das Ver
27. on Control System Ein Produkt von Drittanbietern das Ihrer Modell Daten Revisionen verwaltet Enterprise Architect unterst tzt mehrere Version Control Systemen wie CVS Subversion und SCC konformen Produkten und stellt die n tige Benutzeroberfl che zur Verf gung um Daten zwischen dem Model Repository und dem Version Control Repository verschieben zu k nnen Working Copy Der Datensatz auf Ihrem lokalen Rechner den Sie von der Version Control Repository abgerufen haben Enterprise Architect verwendet Ihren Arbeitskopie Dateien um das Modell und die Version Control Repositories zu aktualisieren XMI XML Meta Data Interchange Ein offenes Standard Dateiformat das den Austausch von Informationen zwischen Modell Tools erm glicht Enterprise Architect nutzt dieses Dateiformat um Informationen von einem Paket Modell zu serialisieren um eine Ablage in der Version Control Repository zu erm glichen Wenn die Versionskontrolle auf ein Paket in Enterprise Architect angewendet wird ist eine XMI Datei f r dieses Package und den darin enthaltenen Elementen erstellt und dem Version Control Repository beigef gt Einleitung Dieses Dokument erl utert wie sich Konzepte der Versionskontrolle auf Sparx Systems Enterprise Architect anzuwenden sind und empfiehlt Best Practice Methoden f r die Versionskontrolle in gemeinsamen sowie verteilten Modell Umgebungen Die folgenden Informationen sind f r Enterprise Architect Anwender konzipiert die
28. r das Generieren von Code und Rich Text Format RTF Dokumentation Element Status Types und Stereotyp Definitionen Wenn solche Meta Daten verwendet werden um die Eigenschaften eines Pakets oder seiner Bestandteile zu definieren werden diese Daten exportiert und zusammen mit dem XMI importiert Somit bleiben die Daten w hrend einer Paket Aktualisierung mit Versionskontrolle erhalten Es kann aber auch vom Nutzen sein die Referenzdaten in der Versionsverwaltung bereitzustellen Dies erm glicht es allen zugeh rigen Enterprise Architect Modell Repositories die gleichen Definitionen und Vorlagen wirksam einzusetzen Sie k nnen Enterprise Architect s integrierte Tools nutzen um Reference Data zu exportieren Anschlie end k nnen Sie die resultierende Datei zu Ihrem Version Control Repository legen Andere Benutzer k nnen anschlie end die Referenzdaten abrufen und sie in ihre Projekte zu importieren Die Export und Import Prozesse werden im Enterprise Architect Handbuch definiert Anhang B Built In Collaboration und Change Management Tools Wir haben in erster Linie an die Verwendung eines Version Control Systems von einem Drittanbieter konzentriert um Informationen f r verteilte Teams zu replizieren und Model Revisionen zu verwalten Es gibt zahlreiche erg nzende Tools von Enterprise Architect die einem gro en Team das Modellieren erleichtert und ohne fremdes System verwendet werden kann Einige werden unten beschrieben Audit Diese F h
29. rolle auf einzelne Pakete an innerhalb von Enterprise Architect an Siehe Appendix C f r Details L Verteilen Sie das Modell an den Rest des Teams a Sobald das Modell mit angewendeter Version Control erstellt ist verteilen Sie die EAP Datei auf den Rest des Teams b Jedes Teammitglied das auf versionskontrollierte Pakete von Enterprise Architect zugreifen soll muss eine Arbeitskopie wie in Schritt 1c erstellen c Wenn Teammitglieder das Modell zum ersten Mal ffnen werden sie von Enterprise Architect aufgefordert f r alle Version Control Konfigurationen die von dem Modell verwendet werden eine Definition festzulegen Geben Sie einfach den Pfad zu den lokalen Arbeitskopie Dateien und speichern die Definition d Das Modell wird nun an Version Control angeschlossen und einsatzbereit Best Practice 5 Wie in einem zentralisierten Team k nnen Sie Parallelarbeiten maximieren indem Sie Versionskontrollen auf alle Pakete in der Modell Hierarchie anwenden einschlie lich sub Pakete und Root Knoten Auch wenn Sie Cross Package Abh ngigkeiten sorgf ltig verwaltet haben beschrieben im folgenden Abschnitt ist dies weiterhin angemessen In einer verteilten Umgebung hat dieser Ansatz einen zus tzlichen Leistungsvorteil da beim Abgeben und Abrufen der aktuellsten nderungen jeder Benutzer kleine XMI Dateien zwischen der Version Control und den Modell Repositories bertragen wird Die Bearbeitung kann jedoch durch eine Verringerung der Abh n
30. rt 4 Mit der zuvor erstellten Baseline Restore to Baseline ausf hren P Das wiederhergestellte Paket einchecken 6 Nach Bedarf k nnen Sie die Basline von Schritt 2 l schen Szenario 2 Verteiltes Team und lokale Modelle In diesem Szenario bearbeiten mehrere Personen das Modell ohne jedoch ber ein gemeinsames Model Repository verbunden zu sein Stattdessen verwaltet jeder Editor ein lokale Kopie des Modells als eine EAP Datei und aktualisiert regelm ig ihre Kopie von einem gemeinsamen Version Control Repository Dieser Ansatz erleichtert umfassende Vervielf ltigungen des Modells ohne die Notwendigkeit der Verwaltung eines DBMS Empfohlene Verfahren zur Versionskontrolle von Modellen 1 Einrichten eines ersten versionskontrollierten Enterprise Architect Modells a Erstellen Sie ein Version Control Repository b Erstellen Sie einen Eintrag in Ihrem Version Control Repository mit Ihrem Version Control System das zum Speichern Ihrer Enterprise Architect Paket Dateien verwendet wird c Erstellen Sie eine Arbeitskopie in einem lokalen Ordner beispielsweise in CVS und Subversion das Auschecken des im vorherigen Schritts erstellten Eintrag erforderlich d Ein bestimmter Benutzer soll eine Enterprise Architect Projekt EAP Datei erstellen und eine Versionskontroll Konfiguration definieren Die Konfiguration erm glicht den Zugriff auf die Dateien der Arbeitskopie innerhalb von Enterprise Architect e Wenden Sie die Versionskont
31. son Control Repository Revisionen zu verwalten und das Roll back von nderungen zu erm glichen Im Folgenden sind einige Fragen aufgelistet die h ufig bei der Verwaltung von Versionskontrolle in einem solchen Szenario gestellt werden Bei welcher Granularit t soll ich Version Control anwenden Model Ebene Paket oder Unterpaket Ebene etc Wie kann ich verhindern dass ein Teammitglied die Arbeit eines anderen berschreibt Wenn jemand einen Fehler macht wie kann der vorherige Zustand des Pakets sicher wiederhergestellt werden Antworten auf diese Fragen werden in den folgenden empfohlenen Prozessen und Best Practices zur Verf gung gestellt Empfohlener Vorgang f r Version Control Modelle 1 DBMS Repository einrichten a Einrichtung eines dedizierten DBMS Server der von Enterprise Architect unterst tzt wird und f r alle Teammitglieder zug nglich ist b F hren Sie die SQL Skripte f r das Enterprise Architect Datenbankschema aus und bertragen Sie dann alle vorhandenen Starter Modelle Ausf hrliche Anweisungen zur Verwendung der Skripte sind ber den obigen Link verf gbar c Wahlweise kann User Security auf das Enterprise Architect Modell aktiviert werden So k nnen Sie kontrollieren wer Zugriff auf bestimmte Funktionen von Enterprise Architect in diesem Modell hat 2 Version Control Repository einrichten a Installieren Sie die Server Komponente Ihres bevorzugten Version Control Anwendung und stellen S
32. t ausgecheckt werden Kurz gesagt die XMI f r beide Pakete enth lt die Classifier Referenzinformationen Wenn wir die XMI nur von einem Pakt aktualisieren w rden ber die Check out Check in Prozess g be es widerspr chliche Informationen zwischen den jeweiligen XMI Dateien Beim anschlie enden Ausf hrung eines Get All Latest Befehls auf ein Paket dass als Zweites aktualisiert wird werden Classifier Informationen im ersten Paket berschrieben Es ist jedoch n tzlich die Classifier Informationen in beiden XMI Dateien zu haben Betrachten wir zum Beispiel das Best cken eines Modells aus dem Nichts Wenn wir Paket A erst in ein leeres Modell importieren Paket B sowie sein Classifier Y existiert noch nicht und daher w rde eine Referenz von Element X auf Y verloren gehen Nur durch die Einbeziehung der abh ngigen Verweise auf Y in die XMI von Paket B l sen wir solche Dangling References beim sp teren Import von Paket B Hinweis Bei k nftigen Versionen von Enterprise Architect wird das Auschecken des abh ngigen Pakets Paket A und des Ziel Pakets Paket B durch erneutes Scanning der richtigen XMI Dateien und einem Get All Latest vermieden werden Verschieben eines Elements zwischen zwei Versionskontrollierte Pakete Nun nehmen wir an wir m ssen Element X aus Paket A in Paket B hineintauschen In diesem Fall ist klar dass wir das semantische Modell beider Pakete beeinflussen Der Aktualisierungsvorgang l uft wie folgt
33. t bildet auch die Grundlage der von Enterprise Architects Vergleichen und Zusammenf hren Funktionalit t Bei der Entscheidung ber Ans tze zur Versionskontrolle sollte die Verwendung von Model Baselines ber cksichtigt werden insbesondere wenn Revisionsverlauf f r Roll Back Zusammenf hrungs und Vergleichszwecken erhalten werden soll 2 Version Control Integration Enterprise Architect unterst tzt die Integration von Version Control Systemen von Drittanbietern die es erm glichen das Benutzer Paket Revisionen in ihrem bevorzugten Werkzeug speichern k nnen Version Control Tools die von Enterprise Architect unterst tzt werden sind unter anderem Subversion CVS Microsoft TFS und SCC kompatible Tools wie AccuRev und Visual Source Safe F r gro e geographisch versteute Teams ist es oft notwendig eine eigene Version eines Control Systems zu verwenden um breit angelegte Vervielf ltigung und Austausch von Modelldaten zu erm glichen Dieses Dokument konzentriert sich auf den letztgenannten Ansatz das Erreichen von Versionskontrolle mit integrierten Drittanbieter Werkzeugen Leser die an verwandten Change Management Features und einfachen Alternativen interessiert sind werden an Anhang B Built In Collaboration und Change Management Tools verwiesen Abbildung 2 stellt ein High Level Schema der Beziehung zwischen Enterprise Architect und dem externen System zur Versionskontrolle dar Beachten Sie dass Versionen als XMI Dateien sowoh
34. tellen Dies ist aus UML Modellierung Perspektive semantisch korrekt und verhindert auch m gliche Verluste von Informationen ber die Anschluss Diagramme beim Roundtrip von Paketen ber version control Einchecken Auschecken Sequenz und Kommunikations Diagramm Nachrichten werden nur in die XMI des Pakets exportiert welches das Diagramm enth lt Sind Ihre Instanz Elemente und Diagramme in dem gleichen Paket werden alle Connector Informationen w hrend des sp teren Imports erhalten Abbildung 14 zeigt den empfohlenen Modellierungsansatz f r ein Sequenz Diagramm das aus dem oben genannten Modell gebaut wurde sd Diagram1 2 Ainsance Casa Bingance Class 3 amp Model a Cusomerinstance 54 Model View Customer T a M Use Cases 1 H S Actors l 0 a ta tion20 il operation20 int Administrator 000 MN ps peraion2d int _ _ Customer g Domain Model tA Domain Model a E Classa a E ClassB 40 Sequence Diagrams PF Diagrami E Alnstance ClassA E Binstance ClassB l i l i 1 1 l l l 1 1 l 1 Customerinstance Customer 1 1 Abbildung 14 Die Anwendung von Instanzen um Classifier zu referenzieren ist semantisch korrekt und hilft Modellintegrit t zu bewahren Best Practice 12 Bei der Erstellung von Sequenz und Kommunikation Diagrammen sollten Sie am besten die Instanzen einsetzen die auf Classifier verweisen Verwenden Sie keine Classifier Elemente direkt Dies ist semant
35. verhindern die nicht als Modell Autoren benannt sind Anhang C Anwendung von Version Control auf Paketen Basierend auf Ihrem Einsatzszenario und Modellstrukturen ber die Sie bereits verf gen schlagen wir in diesem Anhang Ans tze f r die Anwendung der Versionskontrolle von Paketen vor Wir verweisen auf einige Enterprise Architect Versionskontroll Features die ausf hrlicher in der Bedienungsanleitung zur Konfiguration eines versiongesteuerten Pakets erl utert sind Prozesse f r r ckwirkende Anwendung von Versionskontrolle auf bestehenden Pakete Wie man jedes Paket im Modell versionskontrolliert Vielleicht m chten Sie jedes Paket zur Versionskontrolle hinzuf gen um das Potenzial f r die parallele Bearbeitung zu maximieren Sollte das der Fall sein verwenden Sie einfach den Enterprise Architect Add Branch to Version Control Befehl beim Modell Root Knoten In diesem Kontext bezieht sich branch auf den Unterbaum welcher bei dem ausgew hlten Paket beginnt wenn Sie also Add Branch to Version Control auf den Root Knoten anwenden dann ist das gesamte Projekt betroffen Als Ergebnis wird die Versionskontrolle rekursiv auf alle Pakete und deren Sub Pakete angewendet Die entsprechenden XMI Dateien werden automatisch auf Basis der Paket GUID benannt welches sp tere Umbenennungen von Paketen berlebt XMI Dateien f r bergeordnete Pakete enthalten nur Stub Informationen f r untergeordnete Pakete dabei wird die Gr
36. verwendet werden Aup 1 Erstellen Sie eine Beziehung aus einem Element aus Paket A nach Paket B Wir wollen die Situation in Abbildung 7 modellieren Wir k nnen annehmen dass die Klasse Child diese Beziehung besitzt da die Vererbung die Klasse Parent semantisch nicht ver ndert Wir brauchen also nur Paket A auszuchecken um die nderungen Be BB are vorzunehmen class Inheritance AB Der Prozess zum Erstellen einer uni direktionalen Verbindung ist wie folgt Mit Get All Latest stellen Sie sicher dass Sie ber das gesamte Modell verf gen Best Practice 9 ii Package A auschecken iii Beziehung erstellen Package A Chlid Figure 7 Create Connector iv Package A einchecken Hinweis Wenn Sie die Beziehung mit Hilfe eines Diagramms in einem anderen Paket erstellen wollen muss das Diagramm zusammen mit Paket A ausgecheckt und eingeckeckt werden 2 ndern Sie das Zielelement des Connectors auf ein anderes Element Diese nderung ist im Wesentlichen mit unserer vorherigen nderung identisch weil wir weder das urspr ngliche Zielelement noch das neue Zielelement durch Re Routing des Connectors semantisch ver ndern Wir k nnen daher die gleichen Verfahren einsetzen indem Schritt 3 mir einer nderung der Zielelement ersetzt wird 3 Umkehrung der Richtung eines Connectors nderungs des Connector Typs und Modell Bidirektionalit t Wenn wir nun das gleiche Modell editieren wol
37. zer und Gruppensperren auf versionskontrollierte Pakete anzuwenden Best Practice 3 Es ist sinnvoll regelm ig das gesamte Modell zu archivieren als Backup und f r Offlinearbeiten In Enterprise Architect k nnen Sie ein DBMS Projekt ins EAP Format bertragen nutzen Sie die DBMS to EAP Option Der Modell Transfer soll zus tzlich zu Ihrem Standard DBMS Backup Verfahren durchgef hrt werden und nicht als Ersatz Best Practice 4 Stets aussagekr ftige Kommentare beim Package Check In Enterprise Architect fordert Sie auf einen Kommentar ber Ihr Version Control System Check In abzugeben Ein Kommentar der sinnvoll die Art der nderungen beschreibt kann sp ter bei Nachpr fen sehr hilfreich sein Solche Kommentare sind auch n tzliche Indikatoren des letzten guten Zustandes falls das Paket aufgrund eines aufgetretenen Fehlers zu einem fr heren Status wiederhergestellt werden muss Empfohlene Vorgehensweise f r nderungen zur ckzusetzen Rollback 4 Finden Sie eine fr here Revision der letzte gute Zustand des Pakets aus der Versionskontrolle Verwenden Sie die Package File History in Enterprise Architect um die jeweilige Revision auszuw hlen um sie dann in das Modell zu importieren 2 Erstellen Sie eine Baseline des abgerufenen Pakets EN Das Paket in das Modell auschecken Somit wird das Paket zum Bearbeitung entsperrt die Head Revision des Pakets aus der Versionskontrolle wird damit jedoch abgerufen und importie
Download Pdf Manuals
Related Search