FOLGEN SIE DER KONVERSATION
Sequenzdiagramm: Leitfaden
Erstellen Sie geordnete API- und Dienstinteraktionen mit Teilnehmern, Aufrufen, Antworten, Verzweigungen und Notizen.
Folgen Sie der Konversation
Das Sequenzdiagramm ist ein unabhängiger visueller Arbeitsbereich für Interaktionen zwischen Personen, Diensten und Systemen. Teilnehmer verlaufen von links nach rechts; die Zeit verläuft die Seite hinunter. Die Ablaufübersicht und das Diagramm zeigen dasselbe geordnete Modell.
Wählen Sie die API-Anforderungsvorlage, um einen Client, Orders API, Auth-Dienst und eine Datenbank zu untersuchen. Die Vorlage überprüft ein Token und verwendet eine If/Else-Gruppe, um Bestellungen oder eine nicht autorisierte Antwort zurückzugeben. Wählen Sie ein leeres Diagramm, um Ihre eigene Konversation zu erstellen.
Erstellen Sie eine API-Interaktion
- Fügen Sie Teilnehmer für den Client und die API hinzu. Wählen Sie einen im Fluss-Bedienfeld oder im Diagramm aus, um dessen Namen, Symbol, Farbe und Reihenfolge von links nach rechts zu bearbeiten.
- Die leere Arbeitsfläche führt Sie durch die Teilnehmer und Ihre erste Nachricht. Neue Namen und Nachrichtentexte sind ausgewählt, sodass Sie sofort tippen können. Wählen Sie Nachricht und bearbeiten Sie dann Von, An und Nachricht in den Details. Die Hinzufügen-Leiste zeigt, wo der neue Schritt eingefügt wird und wer die Nachricht sendet. Eine Nachricht wird nach dem ausgewählten Schritt im selben Zweig hinzugefügt. Das Auswählen eines Teilnehmers startet die nächste Nachricht von diesem Teilnehmer; eine ausgewählte Nachricht liefert ihre Endpunkte. Notizen, die von einem ausgewählten Teilnehmer hinzugefügt werden, verwenden diesen Anker. Wenn kein Schritt ausgewählt ist, wird sie zum Hauptablauf hinzugefügt.
- Wählen Sie eine Nachricht aus und verwenden Sie „Antwort nach dieser Nachricht hinzufügen“, um deren Endpunkte umzukehren und eine gestrichelte Rückgabe hinzuzufügen. Ziehen Sie Schritte, um sie zeitlich zu platzieren; die Vorschau zeigt ihr Ziel an. Die Auf-/Ab-Steuerelemente von Flow ordnen innerhalb des aktuellen Zweigs neu.
- Verwenden Sie Gruppe → If / else, Optional, Loop oder Parallel. Wählen Sie einen Zweig aus, um dessen Bedingung zu bearbeiten oder dort Schritte hinzuzufügen. Zweig hinzufügen fügt vor einem else-Fallback ein. Im Ablauf hat jeder Zweig seine eigene +-Schaltfläche.
- Führen Sie Prüfungen aus, überprüfen Sie das Diagramm und speichern oder exportieren Sie das Ergebnis. Verwenden Sie auf Mobiltelefonen die Registerkarten Flow, Diagramm und Details; Details bearbeiten öffnet das ausgewählte Element und Zurück zum Diagramm kehrt zur Arbeitsfläche zurück.
Auswählen, verschieben und im Diagramm hinzufügen
Klicken Sie auf einen Teilnehmer-Header oder eine Lebenslinie, eine Nachricht, eine Notiz, einen Gruppenrand oder einen Verzweigungsbereich, um diesen auszuwählen. Drücken Sie die Eingabetaste oder Leertaste, um die Details zu öffnen. Ziehen Sie Teilnehmer-Header nach links oder rechts, um den Abstand und die Reihenfolge anzupassen; ziehen Sie Nachrichten, Notizen oder ganze Gruppen vertikal, um deren zeitliche Reihenfolge festzulegen und eine Lücke zu hinterlassen. Ziehen Sie auf Touchscreens den sichtbaren Griff; wischen Sie an einer anderen Stelle, um zu scrollen.
Die Vorschau zeigt das vorgeschlagene Diagramm und benennt dessen Ziel-Branch. Ziehen Sie es in einen anderen Branch, um einen Schritt zu übertragen, oder verwenden Sie „Schritt verschieben nach“ in den Details. Erstellung und Zerstörung bleiben im Hauptfluss; Gruppen können nicht innerhalb ihrer selbst verschoben werden. Ziehvorgänge rasten an 8-Pixel-Rastern ein. Escape oder Abbrechen lässt das Modell unverändert; das Loslassen bewirkt eine rückgängig machbare Änderung. „Aufräumen“ stellt die automatische Abstandsregelung wieder her, während Ihre Reihenfolge und Branches beibehalten werden.
Klicken Sie auf die Leiste Hinzufügen oder ziehen Sie auf dem Desktop Teilnehmer, Nachricht, Notiz oder eine Gruppe in das Diagramm. Gruppenoptionen erklären If / else, Optional, Loop und Parallel in einfacher Sprache. Die Ablagevorschau und die Fußzeile der Zeichenfläche benennen den Zielzweig und zeigen dessen Position in der Zeit an. Paletten-Ziehaktionen beginnen mit den ersten beiden Teilnehmern; die Richtung wird während des Ziehens angezeigt. Wählen Sie Nachrichtendpunkte in den Details; das Ablegen in der Nähe einer Lebenslinie verändert diese nicht.
Klicken Sie auf die leere Zeichenfläche, um die Auswahl aufzuheben. Ziehen Sie die leere Zeichenfläche oder verwenden Sie die mittlere Maustaste, um sich umzusehen, während die Auswahl erhalten bleibt. Vor Teilnehmern kann eine Gruppe hinzugefügt werden; deren Platzhalter auf der Zeichenfläche und die Flow- + -Schaltfläche fügen den ersten Teilnehmer hinzu und bieten dann die erste Nachricht an.
Teilnehmer und Lebenslinien
Teilnehmer, Akteur, Grenze, Steuerung, Entität und Datenbank ändern das Kopfzeilensymbol. Sie sind Rollen in einer Interaktion, keine Datenbanktabellen. Namen und optionale undurchsichtige Hex-Akzentfarben werden mit dem Diagramm gespeichert.
Ziehen Sie einen Teilnehmer-Header, um ihn zu positionieren; benachbarte Header weichen aus, um die Lesbarkeit zu wahren. Nach links verschieben und Nach rechts verschieben tauschen seinen Platz in der angezeigten Reihenfolge. Nachrichtenenpunkte bleiben unverändert. Teilnehmerdetails bietet die Aktionen Nachricht senden und Notiz hinzufügen. Eine Nachricht an denselben Teilnehmer wird automatisch zu einem Selbstaufruf; ein Diagramm mit einem Teilnehmer bietet dies explizit an. Das Löschen eines Teilnehmer entfernt auch damit verbundene Nachrichten und entfernt dessen Anker aus Notizen; Rückgängig stellt die vollständige Änderung wieder her.
Aufrufe, Antworten und Lebensdauern
| Art | Bedeutung |
|---|---|
| Synchroner Aufruf | Durchgezogene Linie und ausgefüllter Pfeil. Der Sender wartet auf die aufgerufene Operation. |
| Asynchrone Nachricht | Durchgezogene Linie und offener Pfeil. Der Sender kann fortfahren, ohne zu warten. |
| Antwort / Rückgabe | Gestrichelte Linie, die zum Aufrufer zurückkehrt. Antwort hinzufügen kehrt die ausgewählten Nachrichtendenpunkte um. |
| Erstellen Sie Teilnehmer | Die Erstellung gehört zur ersten Interaktion des Ziel-Lebensbands. Ihre Kopfzeile beginnt bei dieser Nachricht. |
| Teilnehmer zerstören | Ein X markiert die Zerstörung des Ziels. Dies sollte seine letzte Interaktion sein. |
Gruppieren Sie Verzweigungen, ohne deren Bedeutung zu verlieren
If / else (alt) enthält 2–6 alternative Zweige; genau ein passender Operand wird ausgewählt. Optional (opt) enthält einen bedingten Zweig. Loop enthält einen wiederholten Zweig; schreiben Sie die Iterationsbedingung. Parallel (par) enthält 2–6 Operanden, deren Interaktionen sich verschränken können.
Die Verzweigungszugehörigkeit ist explizit. Flow-Buttons und Alt+Auf/Ab halten einen Schritt in seiner aktuellen Verzweigung. Ziehen kann eine Nachricht, eine Notiz oder eine ganze Gruppe in die im Vorschaubild benannte Verzweigung übertragen; Schritt verschieben nach bietet die gleiche Wahl in Details. Ungültige Ziele sind mit einer Begründung deaktiviert, einschließlich des Verschiebens einer Gruppe in sich selbst, des Überschreitens von vier verschachtelten Ebenen oder des Platzierens von Erstellung/Zerstörung innerhalb einer Verzweigung.
Das Ändern einer Gruppe mit mehreren Zweigen in "Optional" oder "Schleife" fragt nach, bevor nur der erste Zweig beibehalten wird. Das Löschen eines Zweiges fragt nach, bevor seine Schritte entfernt werden; wenn ein Zweig übrig bleibt, wird die Gruppe "Optional", und das Löschen des einzigen Zweiges entfernt die Gruppe. Das Löschen einer Gruppe entfernt alle ihre Schritte nach Bestätigung. "Rückgängig" stellt die vollständige Änderung wieder her. Die vertikale Anordnung paralleler Zweige impliziert keine Ausführungsreihenfolge zwischen ihnen.
Notizen, Nummerierung und Aktivierungen
Fügen Sie eine Notiz hinzu und wählen Sie die Teilnehmer aus, die sie umspannen soll. Notizen umschließen ihren Rahmen innerhalb und bewegen sich mit der Sequenzreihenfolge. Verwenden Sie sie für Einschränkungen oder Erklärungen, anstatt einen Absatz auf einen Nachrichtspfeil zu setzen.
Ansichtssteuerungen steuern Meldungsnummern und automatische Aktivierungsleisten. Diese Darstellungsoptionen werden gespeichert und in den Bildexport einbezogen. Nummern bieten eine Leserichtung; es sind keine gemessenen Zeitstempel oder eine Gesamtausführungsreihenfolge über parallele Verzweigungen hinweg.
Aktivierungsleisten werden aus synchronen Aufrufen abgeleitet und Antworten gezeichnet. Selbstaufrufe können verschachtelt werden. Alternative Zweige werden separat berechnet, sodass Antworten in einem Zweig keine Aufrufe in einem anderen schließen. Fehlende Antworten lassen eine Aktivierung bis zum Ende des Gültigkeitsbereichs offen; dies ist eine visuelle Hilfe und keine Ausführungsanalyse.
Neue Diagramme beginnen in einer lesbaren Skalierung; breite Diagramme können horizontal gescrollt werden. "Diagrammbreite anpassen" gibt einen Überblick, während die vertikale Lesbarkeit erhalten bleibt. Scrollen Sie zum Erkunden, verwenden Sie die Zoom-Steuerung oder Strg/Befehl plus Scrollen, um den Bereich um den Zeiger zu zoomen. "Suchen" durchsucht Teilnehmernamen und -typen, Nachrichten und ihre Endpunkte, Notizen, Gruppenbeschreibungen und Bedingungen. Übereinstimmende Schritte behalten ihren relevanten Zweigkontext bei; IDs und Positionen sind ausgeschlossen. "Löschen" oder "Escape" stellt den vollständigen Ablauf wieder her, und ein leeres Ergebnis erklärt, was Sie versuchen können. Die Auswahl eines Ablaufs oder einer Prüfung oder das Hinzufügen eines Elements bringt dessen Beschriftung in Sicht, ohne den Zoom zu ändern. Auf Telefonen geschieht dies, wenn Sie zum Diagramm zurückkehren. Das Scrollen, Zoomen und Auswählen der Leinwand sind Arbeitsbereichsansichten außerhalb des Dokuments und der Rückgängig-Historie.
Speichern, teilen und importieren
Neue Diagramme bleiben im Speicher. "Speichern" meldet sich bei Bedarf an und erstellt eine unabhängige Sequenzdiagramm-Cloud-Datei. "Datei" → "Sequenzdiagramme öffnen" öffnet seine eigene Dateiliste. Speichern Sie die letzten Änderungen, bevor Sie einen schreibgeschützten öffentlichen Link teilen. Öffentliche Betrachter können die Datei inspizieren und exportieren, aber nicht bearbeiten.
Datei → JSON herunterladen behält das vollständige bearbeitbare Dokument, einschließlich Teilnehmerpositionen und Schrittlücken. Cloud-Speicherungen und Bild-Exporte behalten diese Platzierung ebenfalls bei. JSON importieren akzeptiert exportierte Erd Go Sequenzdiagramm-Version 1-Dateien bis zu 4 MB, validiert die gesamte Datei vor dem Ersetzen und unterstützt Rückgängigmachen. Ältere Dateien behalten automatische Abstände bei; überlappende importierte Positionen werden sicher angezeigt. SQL, Klassendiagramm, Mermaid und PlantUML sind keine Importformate.
Datei → Neues Diagramm öffnet erneut die Auswahl für Vorlagen. Leer und API-Anfragebeispiel ersetzen ein bestehendes Modell mit einer Bestätigung und der Option „Rückgängig“. Nicht gespeicherte Diagramme fordern vor dem Verlassen oder Neuladen zum Speichern auf. Es werden keine Daten im Browserspeicher abgelegt.
Ein Diagramm oder eine Textquelle exportieren
Der Export erstellt PNG, JPEG, WebP, eine eigenständige Vektor-SVG oder ein bildbasiertes PDF. Wählen Sie Gesamtes Diagramm oder Aktuelle Ansicht (öffnen Sie das Diagramm-Panel auf Smartphones zuerst) und eine HD-, 2K- oder 4K-Breite. Rasterabmessungen sind auf 8192 Pixel pro Seite und 16 Megapixel beschränkt; sehr hohe Diagramme werden möglicherweise verkleinert. Verwenden Sie SVG für skalierbare große Diagramme oder Aktuelle Ansicht für einen lesbaren Ausschnitt.
Datei → PlantUML / Mermaid exportieren zeigt Vorschauen, kopiert und lädt lokalen Text herunter. Der Text-Renderer steuert sein eigenes Layout und Aussehen; Teilnehmersymbole oder Farben können abweichen. JSON ist das vollständige bearbeitbare Format. Es werden keine Quellen an einen externen Rendering-Server gesendet.
sequenceDiagram
participant Client
participant API
participant Auth
participant Database
Client ->> API: GET /orders
API ->> Auth: verify token
Auth -->> API: identity
alt valid token
API ->> Database: SELECT orders
Database -->> API: orders[]
API -->> Client: 200 OK
else invalid token
API -->> Client: 401 Unauthorized
endVerknüpfungen und Limits
| Aktion oder Limit | Verhalten |
|---|---|
| Strg/Cmd+S | In der Cloud speichern; melden Sie sich an, wenn Sie dazu aufgefordert werden. |
| Strg/Cmd+K | Öffnen Sie Suchen im Fluss-Panel und fokussieren Sie es. |
| Strg/Cmd+Z / Umschalt+Z / Strg+Y | Rückgängig / Wiederherstellen außerhalb von Textfeldern. Textfelder behalten native Bearbeitungskürzel bei. |
| Enter / Leertaste | Details für das fokussierte Diagrammelement öffnen. |
| Alt+Links / Rechts | Verschieben Sie den ausgewählten Teilnehmer nach links oder rechts. |
| Alt+Oben / Unten | Verschieben Sie den ausgewählten Schritt innerhalb seines aktuellen Zweigs. |
| Löschen / Rücklöschtaste | Die Auswahl außerhalb von Textfeldern löschen oder die Papierkorbschaltfläche der Zeichenfläche verwenden. Teilnehmerkaskaden und Gruppen-/Zweigentfernung bitten um Bestätigung. |
| Escape während eines Ziehvorgangs | Die Vorschau abbrechen, ohne das Modell zu ändern. |
| Aufräumen | Automatische Abstände wiederherstellen, ohne die Reihenfolge oder Verzweigungen zu ändern; Rückgängig macht die Platzierung rückgängig. |
| Teilnehmer und Schritte | 30 Teilnehmer und 300 Gesamtschritte, einschließlich Fragmente und Notizen. |
| Text | 80 Zeichen pro Teilnehmername, 240 pro Nachrichten-/Bedingungs-/Gruppenbeschriftung, 2.000 pro Notiz. |
| Dateien und Verlauf | 4 MB importiertes JSON, 3–255 Zeichen langer Cloud-Dateiname und 80 Rückgängig-Zustände. |
Überprüfen und Fehler beheben
Prüfungen kennzeichnen leere Namen, doppelte Teilnehmernamen, fehlende Nachrichtenbeschriftungen, leere Zweige, fehlende Bedingungen und inkonsistente Erstellungs- oder Zerstörungsreihenfolgen. Wähle einen Befund, um seine Details anzuzeigen. Diese Prüfungen führen die Konversation nicht aus und beweisen kein API-Verhalten.
Wenn der Import fehlschlägt, bleibt Ihr aktuelles Diagramm intakt. Ein älterer, ausstehender Dateilesevorgang kann kein neueres Dokument, keinen neueren Import und kein bearbeitetes Modell ersetzen. Wenn das Cloud-Speichern fehlschlägt, lassen Sie das Diagramm geöffnet und laden Sie JSON herunter, bevor Sie es verlassen.
Verwende die OMG-UML-Spezifikation für die Bedeutung der Interaktionsnotation. PlantUML und Mermaid haben ihre eigene Textsyntax; die generierten Dateien sind Exporte für diese Tools und keine Erd-Go-Import-Sprache.