Ein UML-Sequenzdiagramm zeichnen

Schreiben Sie das Szenario als Satz, bevor Sie irgendetwas zeichnen. "Ein Gast bucht ein Zimmer, das frei ist" ist ein Szenario. "Buchung" ist keines - das ist ein Anwendungsfall, der jeden Ablauf abdeckt, auch die fehlschlagenden, und ein Diagramm, das sie alle sein will, ist das, welches achtzig Nachrichten lang endet. Enthält Ihr Satz das Wort "oder", haben Sie zwei Szenarien oder ein alt-Fragment, und Sie sollten entscheiden, welches, bevor Sie weitermachen.

Listen Sie dann die Teilnehmer auf, die das Szenario tatsächlich berührt, und setzen Sie sie von links nach rechts in der Reihenfolge, in der es sie erreicht. Der Akteur steht ganz links. Vier oder fünf ist der Arbeitsbereich; haben Sie sieben, sind mindestens zwei davon Implementierungsdetails, über die der Ablauf nicht nachdenkt, und sie zu löschen verliert nichts, was eine Leserin brauchte.

Zeichnen Sie den Ablauf, in dem alles klappt, von oben nach unten, ganz ohne Fragmente. Das ist das Diagramm oben im Artikel, und als Arbeitsergebnis ist es fertig, auch wenn es als Diagramm nicht fertig ist - die Reihenfolge steht, und das ist der teure Teil.

Zwei Konventionen tragen den meisten Sinn. Eine Nachrichtenbeschriftung ist eine Operation mit ihren Argumenten, keine Beschreibung: isFree(dates, roomType)sagt einer Leserin, was der Empfänger anbieten muss, während "prüft Verfügbarkeit" ihr eine Geschichte erzählt, die sie schon kannte. Und jede Antwort ist gestrichelt - ein durchgezogener Pfeil zurück ist ein zweiter Aufruf und bedeutet etwas anderes.

Aktivierungsbalken sind in UML 2.5.1 optional und lohnen sich. Sie sind das Einzige auf dem Diagramm, das zeigt, dass ein synchroner Aufruf seinen Aufrufer für den gesamten verschachtelten Austausch darunter blockiert - und das ist meist genau die Tatsache, derentwegen das Diagramm gezeichnet wurde.

Erst jetzt ergänzen Sie die Fragmente, und zwar eines nach dem anderen, mit der Frage an jedes: ändert dieser Zweig, was gebaut werden muss? Ein Zweig, der einen Fehler zurückgibt und endet, tut das selten und ist im Text des Anwendungsfalls besser aufgehoben. Ein Zweig, der andere Arbeit tut - wie das Anbieten alternativer Termine oben -, tut es immer und gehört auf das Diagramm.

Legen Sie den Rahmen um die Stelle, an der die Pfade auseinandergehen, nicht um das ganze Diagramm. Das alt oben beginnt, nachdem das Verfügbarkeitsurteil zurückkommt, weil alles davor beiden Ausgängen gemeinsam ist; ein Rahmen um alle neun Nachrichten wäre technisch legal und würde der Leserin nichts darüber sagen, wo die Entscheidung liegt.

Dann hören Sie bei einem Bildschirm auf. Das ist keine weiche Empfehlung: ein Sequenzdiagramm existiert, um eine Reihenfolge auf einen Blick sichtbar zu machen, und ein Diagramm, das gescrollt werden muss, hat das aufgegeben und alle Kosten behalten. Passt ein Ablauf nicht, teilen Sie ihn an einer natürlichen Naht, benennen Sie beide Hälften und verweisen Sie aus der ersten mit einem ref-Fragment auf die zweite - oder zeichnen Sie über den Satz ein Interaktionsübersichtsdiagramm.

Drei fertige Abläufe zum Abschauen: die durchgearbeiteten Beispiele.