# Mit Umbrello arbeiten

Dieses Kapitel gibt eine Einführung in die Oberfläche von Umbrello und vermittelt alle Kenntnisse, um sofort mit Modellieren anzufangen. Wie normalerweise üblich, sind (fast) alle Aktionen über Umbrellos Menus und Werkzeugleisten erreichbar. Allerdings nutzt Umbrello ebenfalls sehr stark die über die rechte Maustaste erreichbaren Kontextmenus. Man kann fast auf jedes Element in Umbrellos Arbeitsbereich oder Baumansicht mit der rechten Maustaste klicken, um für das gewählte Element sinnvoll erscheinende Funktionen zu erreichen. Für einige Nutzer ist dies am Anfang sehr verwirrend, da sie meist die Arbeit über Menus und Werkzeugleisten gewöhnt sind. Aber hat man sich erst einmal an den Rechtsklick gewöhnt, kann man sein Arbeitstempo wesentlich erhöhen.

## Nutzeroberfläche

Umbrellos Hauptfenster unterteilt sich in 3 Bereiche, die dabei helfen den Überblick über das gesamte System zu wahren, verschiedene Diagramme schnell aufzurufen und letztendlich am Modell zu arbeiten.

Diese Bereiche werden folgendermaßen bezeichnet:

- Baumansicht

- Arbeitsplatz

- Dokumentationsfenster

Umbrellos Nutzeroberfläche Umbrellos Nutzeroberfläche

Umbrellos Nutzeroberfläche

### Baumansicht

Die Baumansicht befindet sich am oberen linken Rand des Fensters und zeigt alle Diagramme, Klassen, Akteure und Anwendungsfälle, aus denen das Modell besteht. Mit der Baumansicht bekommt man einen schnellen Überblick über die Elemente, die das System formen. Weiterhin kann man mit der Baumansicht sehr elegant zwischen den einzelnen Diagrammen wechseln und Elemente aus dem Modell in das aktuelle Diagramm einfügen.

Besteht das Modell aus vielen Klassen und Diagrammen, hilft die Baumansicht bei der Wahrung der Übersicht, indem man das Modell mittels Ordnern besser organisiert. Man kann Ordner anlegen, indem man vom Kontextmenu (Klick mit rechter Maustaste auf ein Ordnerelement in der Baumansicht) den entsprechenden Befehl wählt. Die Elemente kann man einfach in die gewünschten Ordner mittels Drag'n Drop (Ziehen und Ablegen) verschieben.

### Dokumentationsfenster

Das Dokumentationsfenster ist das kleine Fenster am unteren linken Rand des Umbrello Fensters. Es zeigt die für das aktuell gewählte Objekt hinterlegte Dokumentation. Das Dokumentationsfenster ist sehr klein, da es nur einen kurzen Einblick in die hinterlegte Dokumentation geben soll. Die komplette Dokumentation ist natürlich über die Eigenschaften des Elementes verfügbar.

### Arbeitsplatz

Der Arbeitsbereich ist der Hauptteil des Fensters. Hier findet die eigentliche Arbeit statt. Er wird zum bearbeiten und anschauen der im Modell hinterlegten Diagramme genutzt. Der Arbeitsbereich zeigt das aktuell aktive Diagramm. Momentan kann immer nur 1 Diagramm im Arbeitsbereich zu einem Zeitpunkt dargestellt werden.

## Erstellen, Laden und Speichern von Modellen

Um etwas Sinnvolles mit Umbrello machen zu können, muss man zuerst ein Modell anlegen, an dem man arbeiten kann. Während Umbrellos Start wird entweder das zuletzt bearbeitete Modell geladen oder ein neues leeres Modell angelegt. Die hängt von den Einstellungen im Einstellungsfenster ab. Dadurch kann man sofort mit der gewünschten Arbeit beginnen.

### Neues Modell

Um zu irgendeinem Zeitpunkt ein neues Modell anzulegen, wählt man Neu aus dem Dateimenu oder klickt auf das Neusymbol in der horizontalen Werkzeugleiste. Arbeitet man gerade an einem Modell, fragt Umbrello zuerst nach, ob man das aktuelle Modell nicht speichern will, bevor man ein neues Element anlegt.

### Modell speichern

Man kann zu jedem Zeitpunkt das Modell speichern indem man den Speichern Eintrag aus dem Dateimenu wählt, oder auf das entsprechende Symbol in der horizontalen Werkzeugleiste klickt. Soll das Modell unter einem anderen Dateinamen gespeichert werden, wählt man den Eintrag Speichern unter aus dem Dateimenu.

Zur Absicherung bietet Umbrello die Möglichkeit, das Modell automatisch nach einem bestimmten Zeitabschnitt zu speichern. Man kann diese Möglichkeit und das Zeitintervall in Umbrellos Einstellungen definieren.

### Modell laden

Um ein bereits existierendes Modell zu laden, muss man Öffnen aus dem Dateimenu oder das entsprechende Symbol aus der horizontalen Werkzeugleiste wählen. Die zuletzt bearbeiteten Modelle sind ebenfalls über das Untermenu Zuletzt geöffnete Dateien im Dateimenu verfügbar. Dadurch kann man häufig verwendete Modelle wesentlich schneller aufrufen.

Mit Umbrello kann man immer nur an einem Modell gleichzeitig arbeiten. Fordert man das Programm zum Laden eines anderen Modells auf und wurde das momentan bearbeitete Modell seit dem letzten Speichern verändert, fragt Umbrello nach, ob man die Änderungen nicht zuerst speichern will. Dadurch wird ein möglicher Datenverlust verhindert.

## Modelle bearbeiten

In Umbrello gibt es prinzipiell 2 Möglichkeiten die Elemente des Modells zu verändern.

- Man kann die Elemente direkt in der Baumansicht bearbeiten.

- Man kann die Elemente in den Diagrammen bearbeiten.

Über das mit der rechten Maustaste erreichbare Kontextmenu kann man in der Baumansicht fast alle Elemente des Modells hinzufügen, entfernen oder verändern. Klickt man zum Beispiel mit der rechten Maustaste auf einen Ordner in der Baumansicht, kann man eines der verschiedenen Diagramme sowie Akteure, Klassen und Anwendungsfälle anlegen, je nachdem ob der Ordner der logischen Sicht oder der Anwendungsfallsicht untergeordnet ist.

Nachdem man ein Element dem Modell hinzugefügt hat, kann man seine Eigenschaften über den Eigenschaftendialog ändern. Diesen erreicht man über den Punkt Eigenschaften aus dem Kontextmenu des jeweiligen Elements.

Weiterhin kann man das Modell durch das Anlegen und Ändern von Elementen in den Diagrammen bearbeiten. Weitere Details, wie das geht, sind in den folgenden Abschnitten zu finden.

## Diagramme hinzufügen und entfernen

Das UML Modell besteht aus UML Elementen und den Assoziationen zwischen diesen. Man kann aber das Modell nicht direkt sehen, sondern man nutzt Diagramme, um es zu betrachten.

### Diagramme anlegen

Um ein neues Diagramm dem Modell hinzufügen, muss man lediglich den Diagrammtyp aus dem Untermenu Neu aus dem Diagrammmenu wählen und dem Kind einen Namen geben. Das Diagramm wird angelegt und als aktives Diagramm für den Arbeitsplatz ausgewählt. Es taucht sofort in der Baumansicht auf.

Man sollte sich daran erinnern, dass Umbrello sehr starken Gebrauch von den Kontextmenus, erreichbar über die rechte Maustaste, macht. So kann man auf einen Ordner in der Baumansicht mit der rechten Maustaste klicken und aus dem Untermenu Neu den gewünschten Typ auswählen. Es ist zu beachten, dass man in der Anwendungsfallsicht lediglich Anwendungsfalldiagramme hinzufügen kann und in der logischen Sicht alle anderen Diagrammtypen.

### Diagramme entfernen

Will man ein Diagramm aus dem Modell entfernen, muss man es aktivieren und dann Löschen aus dem Diagrammmenu aufrufen. Man kann dies ebenfalls über den Löschen Eintrag im Kontextmenu des entsprechenden Diagramms in der Baumansicht machen.

Da das Löschen eines Diagramms ein ernster Eingriff ist, der Datenverlust verursachen kann, falls es unbeabsichtigt passiert, fragt Umbrello um Bestätigung, bevor die Löschoperation ausgeführt wird. Wurde das Diagramm einmal gelöscht und die Datei gespeichert, gibt es keine Möglichkeit, die Aktion rückgängig zu machen!

### Diagramme umbenennen

Will man ein Diagramm umbenennen, kann man dies durch den Umbenennen Eintrag im Kontextmenu des Diagramms in der Baumansicht erreichen.

Ein anderer Weg ist der Eigenschaftendialog des Diagramms, der durch den Eintrag Eigenschaften aus dem über die rechte Maustaste erreichbaren Kontextmenus des Diagramms aufgerufen werden kann. Weiterhin kann man in der Baumansicht mit einem Doppelklick auf das Diagramm den Eigenschaftendialog ebenfalls aufrufen.

## Diagramme bearbeiten

Während der Arbeit mit Diagrammen versucht Umbrello einen durch die Anwendung einfacher Regeln zu unterstützen, indem nur die möglichen Elemente in einem Diagramm zur Verfügung stehen und nur die sinnvollen Beziehungen zwischen diesen angelegt werden können. Als UML Experte wird man dies vielleicht gar nicht bemerken, für Anfänger ist es eine große Unterstützung bei der Erstellung von standardkonformen Diagrammen.

Nachdem man ein Diagramm angelegt hat, kann man es bearbeiten. Es ist dabei der Unterschied zwischen Diagramm- und Modellbearbeitung, für Anfänger schwieriger verständlich, zu beachten. Wie bereits dargelegt wurde, sind Diagramme eine Sicht auf das Modell. Legt man zum Beispiel in einem Klassendiagramm eine Klasse an, dann bearbeitet man eigentlich sowohl Modell wie auch Diagramm. Ändert man hingegen lediglich die Farbe oder andere Darstellungsoptionen einer Klasse in einem Klassendiagramm, dann wird dadurch lediglich das Diagramm, aber nicht das Modell verändert.

### Elemente einfügen

Eines der ersten Dinge mit einem neuen Diagramm ist es, Elemente wie Klassen, Akteure oder Anwendungsfälle einzufügen. Es gibt prinzipiell 2 Möglichkeiten, wie das geschehen kann.

- Existierende Elemente aus der Baumansicht in das Diagramm schieben.

- Ein neues Element mithilfe der Werkzeuge in der vertikalen Werkzeugleiste anlegen und gleichzeitig dem aktiven Diagramm hinzuzufügen.

Um ein im Modell bereits existierendes Element in das aktuelle Diagramm einzufügen, muss man es lediglich von der Baumansicht in das Diagramm an die gewünschte Stelle ziehen. Man kann das Element jederzeit mit dem Auswahlwerkzeug im Diagramm verschieben.

Die zweite Möglichkeit Elemente hinzuzufügen ist es, eines der Werkzeuge aus der vertikalen Werkzeugleiste am rechten Bildschirmrand zu benutzen. Dabei wird das Element ebenfalls dem Modell hinzugefügt.

Die vertikale Werkzeugleiste befindet sich standardmäßig am rechten Fensterrand des Anwendungsfensters, man kann sie allerdings an andere Stellen verschieben oder sie über allen anderen Bereichen schwebend positionieren. Die in dieser Werkzeugleiste verfügbaren Werkzeuge, dargestellt durch die verschiedenen Knöpfe, ändern sich je nach momentan bearbeiteten Diagrammtyp. Das momentan gewählte Werkzeug wird hervorgehoben in der Werkzeuglaste dargestellt. Mittels der Shift-Taste kann man zum vorherigen Werkzeug zurückwechseln. Über die Escape-Taste kann man das Auswahl-Werkzeug auswählen.

Hat man ein Bearbeitungswerkzeug aus der Werkzeugleiste ausgewählt, zum Beispiel um eine Klasse einzufügen, ändert sich der Mauszeiger in ein Kreuz. Man kann nun das Element in das Diagramm über einen einzelnen Klick mit der linken Maustaste im Diagramm einfügen. UML Elemente müssen immer eindeutige Namen haben. Gibt es zum Beispiel in einem Diagramm die Klasse KlasseA, dann kann man in einem anderen Diagramm keine neue Klasse mit dem gleichen Namen einfügen. Soll es sich bei den beiden Klassen um unterschiedliche Elemente handeln, dann müssen diese auch unterschiedliche Namen haben. Um das gleiche Element nochmal einzufügen, ist das Werkzeug Klasse einfügen nicht das richtige Hilfsmitteln. Man muss in solch einem Fall lediglich die gewünschte Klasse aus der Baumansicht in das Diagramm ziehen.

### Elemente löschen

Man kann jedes Element über den Eintrag Löschen aus dem Kontextmenu entfernen. Anders gesagt, man klickt mit der rechten Maustaste auf das zu löschende Element und wählt den entsprechenden Eintrag aus dem erscheinenden Menu.

Hier zeigt sich wiederum der große Unterschied zwischen einem Element aus einem Diagramm und einem Element aus dem Modell zu entfernen. Löscht man ein Element in einem Diagramm, dann wird es nur aus diesem speziellen Diagramm entfernt. Das Element ist aber weiterhin Teil des Modells und falls es in anderen Diagrammen genutzt wird, werden diese nicht verändert. Löscht man hingegen das Element in der Baumansicht, dann löscht man das Element im ganzen Modell . Da das Element dann nicht länger im Modell existiert, wird es ebenfalls in allen Diagrammen gelöscht, in denen es verwendet wird.

### Elemente bearbeiten

Man kann die meisten UML Elemente des Modells ändern, indem man den Eigenschaftdialog öffnet und die gewünschten Änderungen vornimmt. Um zum Beispiel ein Objekt zu verändern, ist es auszuwählen und dann Eigenschaften aus seinem Kontextmenu (Rechtsklick) zu wählen. Jedes Element verfügt über solch einen Dialog, der aus mehreren Seiten besteht, abhängig vom Typ des zu bearbeitenden Elementes. Für einige Elemente, wie Akteure, kann man lediglich einige wenige Parameter wie den Namen oder die Dokumentation ändern. Für andere Elemente hingegen, wie Klassen, kann man viele Einstellungen vornehmen wie Attribute und Operationen, Sichtbarkeit und die Darstellung im Diagramm (nur Operationen oder komplette Signatur der Operationen). Man kann sogar die Linienfarben und die Füllfarbe für die Visualisierung der Klasse im Diagramm einstellen.

Für die meisten UML Elemente kann man diesen Eigenschaftendialog durch einen Doppelklick auf das entsprechende Element mit dem Auswahlwerkzeug (Pfeil) aufrufen. Die Ausnahme bilden Assoziationen. Ein Doppelklick fügt ihnen einen neuen Ankerpunkt hinzu. Den Eigenschaftendialog erreicht man für Assoziationen über das Kontextmenu per rechter Maustaste.

Man kann den Eigenschaftendialog auch über das Kontextmenu in der Baumansicht erreichen. Dadurch kann man die Eigenschaften für Diagramme bearbeiten, zum Beispiel ob der Raster anzuzeigen ist oder nicht.

### Klassen bearbeiten

Obwohl das Bearbeiten der Eigenschaften von Objekten bereits im letzten Abschnitt erörtert wurde, folgt ein weiterer Abschnitt zu Klassen, da sie komplizierter als alle anderen UML Elemente sind.

Im Eigenschaftendialog der Klassen kann man alles von der Farbe bis zu den Operationen und Attributen bearbeiten.

#### Allgemeine Klasseneinstellungen

Die Seite im Eigenschaftendialog für die allgemeinen Einstellungen ist selbsterklärend. Dort kann man den Klassennamen, die Sichtbarkeit, die Dokumentation usw. ändern. Diese Seite ist immer verfügbar.

#### Attributeinstellungen von Klassen

Auf der Seite für die Attributeinstellungen kann man Attribute der Klassehinzufügen, bearbeiten und löschen. Um ein neues Attribut hinzuzufügen, muss man lediglich den Neues Attribut Knopf nutzen. Um ein Attribut zu bearbeiten oder zu löschen, wählt man das gewünschte Attribut und betätigt den entsprechenden Knopf. Man kann weiterhin die Attribute in der Liste nach oben und nach unten über die Pfeile verschieben. Diese Seite ist ebenfalls immer verfügbar.

#### Operationseinstellungen von Klassen

Wie in der Seite für die Attributeinstellungen, kann man auf der Seite für die Operationseinstellungen Operationen hinzufügen, bearbeiten und aus der Klasse entfernen. Fügt man eine Operation hinzu oder verändert eine bestehende, dann geschieht dies über den Operationseigenschaften Dialog. Um einen neuen Parameter zu einer Operation hinzuzufügen, muss man den Knopf Neuer Parameter benutzen, der den Paramtereigenschaften Dialog aufruft. Diese Seite ist immer verfügbar.

#### Seite der Klassenassoziationen

Die Seite Assoziationen zeigt alle mit der Klasse verbundenen Assoziationen im aktuellen Diagramm. Ein Doppelklick auf eine Assoziation zeigt den entsprechenden Eigenschaftsdialog. Je nach Assoziationstyp kann man einige Parameter wie Multiplizität und Rollennamen ändern. Verfügt die gewählte Assoziation nicht über solche Parameter, dann ist der Eigenschaftdialog nicht änderbar und man kann lediglich die Dokumentation der Assoziation ändern.

Diese Seite ist nur verfügbar, wenn man die Klasseneigenschaften aus einem Diagramm heraus aufruft. Erfolgt hingegen der Aufruf aus der Baumansicht, ist diese Seite nicht verfügbar.

#### Seite Anzeige

In der Seite Anzeige kann man einstellen, wie die Klasse im Diagramm dargestellt wird. Eine Klasse kann zum Beispiel als einfaches Rechteck mit dem Namen dargestellt werden. Dies ist besonders nützlich, wenn man sehr viele Klassen im Diagramm hat, oder sich noch nicht für Details interessiert. Man kann aber auch die komplette Klasse mit Paketen, Stereotypen, Attributen und Operationen mit Signatur und Sichtbarkeit anzeigen lassen.

Je nach gewünschtem Informationsumfang, kann man die entsprechenden Optionen auf dieser Seite wählen. Die hier gemachten Einstellungen sind lediglich Anzeigeeinstellungen für das aktuelle Diagramm. Das bedeutet, ausgeblendete Operationen im Diagramm sind trotzdem weiterhin Teil des gesamten Modells. Diese Seite ist nur verfügbar, wenn der Eigenschaftendialog der Klasse aus einem Diagramm heraus aufgerufen wurde. Wird der Eigenschaftendialog lediglich aus der Baumansicht aufgerufen, fehlen die Darstellungseinstellungen logischerweise.

#### Seite Farbe

Auf der Seite Farbe kann man die Linienfarben und die Füllfarbe einstellen. Auch diese Seite ist nur verfügbar, wenn die Eigenschaften der Klasse aus einem Diagramm aufgerufen wurden und nicht aus der Baumansicht.

### Assoziationen

Assoziationen bringen 2 UML Elemente miteinander in Verbindung. Normalerweise werden Assoziationen zwischen Klassen definiert, aber einige können auch zwischen Anwendungsfällen und Akteuren angelegt werden.

Um eine Assoziation anzulegen, ist das entsprechende Werkzeug aus der vertikalen Werkzeugleiste auszuwählen (zum Beispiel allgemeine Assoziation, Verallgemeinerung, Aggregation, usw.) und auf das Ausgangselement zu klicken. Danach muss man auf den 2. Partner der Assoziation klicken. Es handelt sich dabei um 2 Klicks und nicht um einen Klick mit anschließendem Ziehen von einem Element zum anderen!

Versucht man eine Assoziation anzulegen, die nicht mit den UML Spezifikationen vereinbar ist, dann verhindert dies Umbrello und gibt einen entsprechenden Hinweis aus. Dies ist zum Beispiel der Fall, wenn zwischen Klasse A und B eine Verallgemeinerung existiert und nun versucht wird, eine Verallgemeinerung von B nach A anzulegen.

Durch einen Rechtsklick auf eine Assoziation erscheint ein Menu mit den Einträgen, die man auf die Assoziation anwenden kann. Um zum Beispiel eine Assoziation zu löschen, muss man den Eintrag Löschen aus dem Kontextmenu auswählen. Man kann über den Eintrag Eigenschaften je nach Typ der Assoziation in einem Dialog die Attribute der Assoziation wie Rollenname und Multiplizität ändern.

#### Ankerpunkte

Assoziationen werden standardmäßig als gerade Linie zwischen den beiden verbundenen Elementen gezeichnet. Möchte man eine Assoziation wegen der besseren Übersicht im Diagramm biegen, dann kann man weitere Ankerpunkte einfügen und so die Assoziation in mehrere Teilbereiche unterteilen.

Man kann solch einen zusätzlichen Ankerpunkt durch einen Doppelklick auf die Assoziation an einer beliebigen Stelle einfügen. Diesen eingefügten Ankerpunkt (dargestellt durch einen blauen Punkt, wenn die Assoziation ausgewählt ist) kann man nun verschieben, um der Assoziation die gewünschte Form zu geben.

Um einen Ankerpunkt zu entfernen, muss man diesen lediglich doppelt mit der linken Maustaste anklicken.

Es ist zu beachten, dass man den Eigenschaftsdialog einer Assoziation lediglich über ihr Kontextmenu aufrufen kann. Ein Doppelklick, wie bei anderen UML Elementen, fügt einen Ankerpunkt ein.

### Textnotizen und Anmerkungen

Textnotizen und Textzeilen sind Elemente, die in allen Diagrammtypen verfügbar sind. Sie haben keine inhaltliche Bedeutung für das Modell, sie können aber hilfreiche Kommentare und Erklärungen enthalten, die ein Diagramm leichter lesbar machen.

Um eine Textnotiz oder eine Textzeile einzufügen, wählt man das entsprechende Werkzeug aus der vertikalen Werkzeugleiste und klickt im Diagramm an die Stelle, wo das Kommentar erscheinen soll. Man kann den Text über das Kontextmenu ändern oder im Fall von Textnotizen durch einen Doppelklick auf den Text.

#### Anker

Mit Ankern kann man ein UML Element mit einer Textnotiz verbinden. Möchte man zum Beispiel mit einer Textnotiz einige Hinweise über eine Klasse angeben, dann verbindet man diese Textnotiz mit der Klasse. Dadurch ist ersichtlich, dass die Textnotiz sich auf das entsprechende Element bezieht.

Um einen Anker zwischen einer Textnotiz und einem UML Element einzufügen, muss man das entsprechende Werkzeug von der vertikalen Werkzeugleiste wählen. Zuerst klickt man auf die gewünschte Textnotiz und mit dem zweiten Klick auf das zu verlinkende UML Element.