Anwendungsfalldiagramm
Ein Anwendungsfalldiagramm zeigt, wie externe Akteure mit einem System interagieren: wer was tut und welche Funktionen das System bereitstellt. Es bietet einen Überblick über die funktionalen Anforderungen und ist besonders in frühen Entwurfsphasen nützlich, um die Beteiligten auf einen gemeinsamen Stand zu bringen. In PlantUML beschreiben Sie Akteure, Anwendungsfälle und deren Verbindungen als Text. Das Diagramm wird automatisch erzeugt.- Text rein, Diagramm raus. Definieren Sie Akteure, Anwendungsfälle und Beziehungen in wenigen Zeilen.
- Einfach zu refaktorieren. Einen Akteur umbenennen oder einen Anwendungsfall verschieben heißt, eine Zeile zu ändern.
- Passt in Ihr Repository. Diagramme liegen neben dem Code, den sie dokumentieren, unter Versionsverwaltung.
Anwendungsfälle
Anwendungsfälle sind von zwei Klammern eingeschossen (da zwei Klammern
wie ein Oval aussehen).
Alternativ kann man das usecase Schlüsselwort verwenden, um einen Anwendungsfall zu definieren.
Außerdem ist es möglich, einen Alias mit dem as Schlüsselwort zu definieren. Dieser Alias wird dann verwendet
wenn die Beziehungen festgelegt werden.
Akteure
Die Namen von Akteuren werden von zwei Doppelpunkten umschlossen.
Mann kann aber auch das actor Schlüsselwort verwenden um einen Akteur zu definieren.
Außerdem ist es möglich, mit dem as Schlüsselwort einen Alias festzulegen. Dieser Alias wird dann später verwendet, wenn die Beziehungen festgelegt werden.
Wie wir sehen werden, ist die Definition eines Akteur nicht zwingend notwendig.
Change Actor style
You can change the actor style from stick man (by default) to:
- an awesome man with the
skinparam actorStyle awesomecommand; - a hollow man with the
skinparam actorStyle hollowcommand.
Stick man (by default)
Awesome man
Hollow man
Beschreibung der Anwendungsfälle
Falls sich eine Beschreibung über mehrere Zeilen ersterckt, kann diese mit Anführungsstrichen eingeschlossen werden.
Außerdem kann man die folgenden Seperatoren verwenden: --
.. == __.
Außerdem kann man Überschriften innerhalb der Seperatoren verwenden.
WARNING
This translation need to be updated. WARNING
Use package
You can use packages to group actors or use cases.
rectangle to change the display of the package.
Einfaches Beispiel
Um Akteure und Anwendungsfälle miteinander zu verbinden wird der Pfeil --> verwendet
Je mehr Bindestriche - der Pfeil enthält, desto länger wird der Pfeil.
Mit einem Doppelpunkt : kann dem Pfeil eine Beschreibung
hinzugefügt werden.
In diesem Beispiel kann man sehen, wie ein vorher nicht deklarierter User
automatisch als Akteur deklariert wird.
Erweiterungen / Generalisierungen
Wenn ein Akteur oder Anwendungsfall einen anderen erweitert, dann kann dies mit dem Symbol <|--.
Verwenden von Notizen
Mit den note left of , note right of ,
note top of , note bottom of Schlüsselwörtern kann man die Position der Notiz relativ zum Objekt festlegen.
Eine Notiz kann aber auch nur mit dem note Schlüsselwort erstellt werden und dann mit dem
.. Symbol den Objekten zugeordnet werden.
Stereotypen
Stereotypen könne während der Erstellung der Akteure und der Anwendungsfälle mit den << und >> Symbolen hinzugefügt werden .
Ändern der Pfeilrichtungen
Normalerweise haben die Verbindungen zwischen den Klassen zwei Striche -- und werden senkrecht gezeichnet.
Es ist aber möglich waagerechte Verbindungen zu erstellen in dem man einen einzelnen Strich (oder Punkt) eingibt:
left,
right, up oder down Schlüsselworte im Pfeil bestimmen:
-d- anstelle von -down-) oder man nimmt die ersten beiden
Buchstaben (-do-).
Diese Möglichkeit sollte aber nicht missbraucht werden: GraphViz
liefert normalerweise recht gute Ergebnisse, ohne das manuell eingeriffen werden muss.
Aufteilen von Diagrammen auf mehrere Seiten
Mit dem Befehl newpage kann das Diagramm auf mehrere Seiten oder Bilder verteilt werden.
Verändern der Richtung in der die Objekte angeordnet werden
Das voreingestellte verhalten bei der Erstellung des Diagramms ist von oben nach unten.
left to right direction Befehls verändern. Oft ist das Ergebnis mit dieser Einstellung besser.
Der Skinparam-Befehl
Mit dem skinparam Befehl kann die Farbe und die Schriftart der Zeichnung verändert werden.
Sie können den Befehl auf die folgenden Arten verwenden:
- Wie alle ander Befehle In einer Diagrammdefinition,
- in einer Include-Datei,
- In einer Konfigurationsdatei, die durch die Kommandozeile oder den ANT-Task übergeben wird.
WARNING
This translation need to be updated. WARNING
Vollständiges Beispiel
Business Use Case
You can add / to make Business Use Case.
Business Usecase
Business Actor
Change arrow color and style (inline style)
You can change the color or style of individual arrows using the inline following notation:
#color;line.[bold|dashed|dotted];text:color
Change element color and style (inline style)
You can change the color or style of individual element using the following notation:
#[color|back:color];line:color;line.[bold|dashed|dotted];text:color
Display JSON Data on Usecase diagram
Simple example