FÖLJ KONVERSATIONEN
Sekvensdiagram: guide
Skapa ordnade API- och tjänsteinteraktioner med deltagare, anrop, svar, förgreningar och anteckningar.
Följ konversationen
Sekvensdiagram är en oberoende visuell arbetsyta för interaktioner mellan personer, tjänster och system. Deltagare löper från vänster till höger; tiden löper nedåt på sidan. Flödesöversikten och diagrammet visar samma ordnade modell.
Välj API-förfrågningsmallen för att utforska en klient, Orders API, Auth-tjänst och databas. Mallen verifierar en token och använder en if/else-grupp för att returnera beställningar eller ett obehörigt svar. Välj Blankt diagram för att bygga din egen konversation.
Bygg en API-interaktion
- Lägg till deltagare för klienten och API:et. Välj en i flödespanelen eller i diagrammet för att redigera dess namn, symbol, färg och ordning från vänster till höger.
- Den tomma arbetsytan guidar dig genom deltagare och ditt första meddelande. Nya namn och meddelandetext är valda så att du kan skriva omedelbart. Välj Meddelande, redigera sedan Från, Till och Meddelande i Detaljer. Lägg till-fältet visar var det nya steget hamnar och vem som skickar meddelandet. Ett meddelande läggs till efter det valda steget, i samma gren. Att välja en deltagare startar nästa meddelande från den deltagaren; ett valt meddelande tillhandahåller dess slutpunkter. Anteckningar som läggs till från en vald deltagare använder det ankaret. Utan ett valt steg läggs det till i huvudflödet.
- Välj ett meddelande och använd Add reply after this message för att vända dess slutpunkter och lägga till en streckad retur. Dra steg för att placera dem i tid; förhandsgranskningen visar deras destination. Flows upp/ner-kontroller sorterar om inom den aktuella grenen.
- Använd Grupp → If / else, Optional, Loop eller Parallel. Välj en gren för att redigera dess villkor eller lägga till steg där. Lägg till gren infogar före en else-fallback. I Flöde har varje gren sin egen +-knapp.
- Kör kontroller, granska diagrammet och spara eller exportera resultatet. På telefoner, använd flikarna Flöde, Diagram och Detaljer; Redigera detaljer öppnar det valda elementet och Tillbaka till diagram återgår till arbetsytan.
Välj, flytta och lägg till i diagrammet
Klicka på en deltagarrubrik eller livslinje, meddelande, anteckning, gruppkant eller grenområde för att välja det. Tryck på Enter eller Mellanslag för att öppna Detaljer. Dra deltagarrubriker åt vänster eller höger för att justera avstånd och ordning; dra meddelanden, anteckningar eller hela grupper vertikalt för att ställa in deras tidsordning och lämna ett mellanrum. På pekskärmar, dra det synliga handtaget; svep någon annanstans för att rulla.
Förhandsgranskningen visar det föreslagna diagrammet och namnger dess destinationsgren. Släpp i en annan gren för att överföra ett steg, eller använd Flytta steg till i Detaljer. Skapande och förstörelse stannar i huvudflödet; grupper kan inte flyttas in i sig själva. Dragningar snäpper till 8 pixlar. Escape eller avbryt lämnar modellen oförändrad; släpp gör en ångringsbar ändring. Städa upp återställer automatisk avstånd samtidigt som din ordning och dina grenar bevaras.
Klicka på Lägg till-fältet, eller dra på skrivbordet en Deltagare, Meddelande, Anteckning eller en Grupp till diagrammet. Gruppval förklarar If / else, Optional, Loop och Parallel i klarspråk. Släpp-förhandsgranskningen och sidfoten på ytan namnger destinationsgrenen och visar dess position i tiden. Palettdragningar börjar med de två första deltagarna; riktningen visas under dragningen. Välj meddelandeslutpunkter i Detaljer; att släppa nära en livslinje ändrar dem inte.
Klicka på en tom yta för att rensa markeringen. Dra i den tomma ytan eller använd mittenknappen på musen för att utforska medan markeringen behålls. En grupp kan läggas till före deltagare; dess platshållare på ytan och "Flow +"-knappen lägger till den första deltagaren och erbjuder sedan det första meddelandet.
Deltagare och livslinjer
Deltagare, Aktör, Gräns, Kontroll, Entitet och Databas ändrar rubriksymbolen. De är roller i en interaktion, inte databastabeller. Namn och valfria opaka hex-accentfärger sparas med diagrammet.
Dra en deltagarrubrik för att positionera den; närliggande rubriker flyttar sig åt sidan för att förbli läsbara. Flytta vänster och Flytta höger byter plats på den i den visade ordningen. Meddelandeslutpunkter förblir oförändrade. Deltagardetaljer erbjuder åtgärderna Skicka meddelande och Lägg till anteckning. Ett meddelande till samma deltagare blir automatiskt ett själv-anrop; ett diagram med en deltagare erbjuder detta explicit. Att ta bort en deltagare tar även bort meddelanden som involverar den och tar bort dess ankare från anteckningar; Ångra återställer hela ändringen.
Anrop, svar och livslängder
| Typ | Betydelse |
|---|---|
| Synkront anrop | Heldragen linje och fylld pil. Avsändaren väntar på den anropade operationen. |
| Asynkront meddelande | Heldragen linje och öppen pil. Avsändaren kan fortsätta utan att vänta. |
| Svara / returnera | Streckad linje som återgår till anroparen. Lägg till svar vänder på de valda meddelandeändpunkterna. |
| Skapa deltagare | Skapande hör till den första interaktionen av mållivslinjen. Dess rubrik börjar vid detta meddelande. |
| Förstör deltagare | Ett X markerar målets förstörelse. Detta bör vara dess sista interaktion. |
Gruppera grenar utan att förlora deras betydelse
If / else (alt) innehåller 2–6 alternativa grenar; exakt en matchande operand väljs. Valfri (opt) innehåller en villkorlig gren. Loop innehåller en upprepad gren; skriv iterationsvillkoret. Parallell (par) innehåller 2–6 operander vars interaktioner kan varvas.
Grenmedlemskap är explicit. Flödesknappar och Alt+Upp/Ner behåller ett steg i dess nuvarande gren. Dragning kan överföra ett meddelande, en anteckning eller en hel grupp till grenen som namnges i förhandsgranskningen; Flytta steg till erbjuder samma val i Detaljer. Ogiltiga destinationer inaktiveras med en orsak, inklusive att flytta en grupp in i sig själv, överskrida fyra nästlade nivåer eller placera skapande/förstörelse inuti en gren.
Att ändra en grupp med flera grenar till Valfri eller Loop frågar innan endast den första grenen behålls. Att ta bort en gren frågar innan dess steg tas bort; om en gren återstår blir gruppen Valfri, och att ta bort den enda grenen tar bort gruppen. Att ta bort en grupp tar bort alla dess steg med bekräftelse. Ångra återställer hela ändringen. Vertikal placering av parallella grenar innebär inte exekveringsordning mellan dem.
Anteckningar, numrering och aktiveringar
Lägg till en anteckning och välj de deltagare den ska spänna över. Anteckningar radbryts inom sin ram och flyttas med sekvensordningen. Använd dem för begränsningar eller förklaringar istället för att placera ett stycke på en meddelandepil.
Vy-kontroller för meddelandenummer och automatiska aktiveringsfält. Dessa utseendealternativ sparas och inkluderas i bildexport. Nummer tillhandahåller en läsordning; de är inte uppmätta tidsstämplar eller en total exekveringsordning över parallella grenar.
Aktiveringsfält härleds från synkrona anrop och ritade svar. Självanrop kan nästlas. Alternativa grenar beräknas separat så att svar i en gren inte stänger anrop i en annan. Saknade svar lämnar en aktivering öppen till slutet av det omfånget; detta är ett visuellt hjälpmedel snarare än en exekveringsanalys.
Nya diagram startar i en läsbar skala; breda diagram kan rullas horisontellt. Anpassa diagrambredd ger en överblick samtidigt som vertikal läsning bevaras. Rulla för att utforska, använd zoomkontrollerna, eller Ctrl/Command plus rullning för att zooma runt pekaren. Sökfunktionen hittar deltagarnamn och typer, meddelanden och deras slutpunkter, anteckningar, gruppbeskrivningar och villkor. Matchande steg behåller sitt relevanta grensammanhang; ID:n och positioner exkluderas. Rensa eller Escape återställer hela flödet, och ett tomt resultat förklarar vad du kan prova. Att välja ett flödes- eller kontrollresultat, eller att lägga till ett element, för dess etikett i vyn utan att ändra zoom. På telefoner sker detta när du återgår till Diagram. Arbetsytans rullning, zoom och markering är vyer utanför dokumentet och ångra-historiken.
Spara, dela och importera
Nya diagram förblir i minnet. Spara loggar in vid behov och skapar en oberoende molnfil för sekvensdiagram. Arkiv → Öppna sekvensdiagram öppnar dess egen fillista. Spara de senaste ändringarna innan du delar en skrivskyddad offentlig länk. Offentliga tittare kan inspektera och exportera men kan inte redigera filen.
Arkiv → Ladda ner JSON behåller det kompletta redigerbara dokumentet, inklusive deltagarpositioner och stegavstånd. Molnsparningar och bildexporter behåller också denna placering. Importera JSON accepterar exporterade Erd Go-sekvensdiagramversion 1-filer upp till 4 MB, validerar hela filen före ersättning och stöder Ångra. Äldre filer behåller automatisk avståndshantering; överlappande importerade positioner visas säkert. SQL, Klassdiagram, Mermaid och PlantUML är inte importformat.
Arkiv → Nytt diagram öppnar väljaren för Tomt/Mall igen. Tomt och API-förfrågningsexempel ersätter en befintlig modell med bekräftelse och Ångra. Osparade diagram frågar innan du lämnar eller laddar om. Ingenting skrivs till webbläsarens lagring.
Exportera ett diagram eller källtext
Export skapar PNG, JPEG, WebP, fristående vektor-SVG eller bildbaserad PDF. Välj Hela diagrammet eller Aktuell vy (öppna Diagram-panelen först på telefoner) och en HD-, 2K- eller 4K-bredd. Rasterdimensioner är begränsade till 8192 pixlar per sida och 16 megapixlar; mycket höga diagram kan förminskas. Använd SVG för skalbara stora diagram, eller Aktuell vy för en läsbar sektion.
Arkiv → Exportera PlantUML / Mermaid förhandsgranskar, kopierar och laddar ner lokal text. Textrenderaren kontrollerar sin egen layout och utseende; deltagarsymboler eller färger kan skilja sig åt. JSON är det kompletta redigerbara formatet. Ingen källkod skickas till en tredjepartsrenderingsserver.
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
endGenvägar och begränsningar
| Åtgärd eller gräns | Beteende |
|---|---|
| Ctrl/Cmd+S | Spara till molnet; logga in när du blir ombedd. |
| Ctrl/Cmd+K | Öppna och fokusera Sök i Flödespanelen. |
| Ctrl/Cmd+Z / Shift+Z / Ctrl+Y | Ångra / Gör om utanför textfält. Textfält behåller inbyggda redigeringsgenvägar. |
| Enter / Mellanslag | Öppna Detaljer för det fokuserade diagramelementet. |
| Alt+Vänster / Höger | Flytta den valda deltagaren åt vänster eller höger. |
| Alt+Upp / Ner | Flytta det valda steget inom dess nuvarande gren. |
| Ta bort / Backsteg | Ta bort markeringen utanför textfält, eller använd papperskorgen på arbetsytan. Borttagning av deltagare och grupper/grenar kräver bekräftelse. |
| Escape under en dragning | Avbryt förhandsgranskningen utan att ändra modellen. |
| Städa upp | Återställ automatiskt avstånd utan att ändra ordning eller grenar; Ångra återställer placeringen. |
| Deltagare och steg | 30 deltagare och totalt 300 steg, inklusive fragment och anteckningar. |
| Text | 80 tecken per deltagarnamn, 240 per meddelande/villkor/gruppetikett, 2 000 per anteckning. |
| Filer och historik | 4 MB importerad JSON, 3–255 tecken långt molnfilnamn och 80 ångra-lägen. |
Granska och felsök
Kontroller flaggar tomma namn, dubbla deltagarnamn, saknade meddelandeetiketter, tomma grenar, saknade villkor och inkonsekvent skapande- eller förstörelseordning. Välj ett resultat för att visa dess Detaljer. Dessa kontroller exekverar inte konversationen eller bevisar API-beteende.
Om importen misslyckas förblir ditt nuvarande diagram intakt. En äldre väntande filinläsning kan inte ersätta ett nyare dokument, en nyare import eller en redigerad modell. Om molnsparning misslyckas, håll diagrammet öppet och ladda ner JSON innan du lämnar.
Använd OMG UML-specifikationen för betydelsen av interaktionsnotation. PlantUML och Mermaid har sin egen textsyntax; de genererade filerna är exporter för dessa verktyg, inte ett importspråk för Erd Go.