Hoppa till dokumentationen

FÖLJ KONVERSATIONEN

Sekvensdiagram: guide

Skapa ordnade API- och tjänsteinteraktioner med deltagare, anrop, svar, förgreningar och anteckningar.

Deltagare och meddelanden → SekvensdiagramÖppna sekvensdiagram

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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

Anrop, svar och livslängder
TypBetydelse
Synkront anropHeldragen linje och fylld pil. Avsändaren väntar på den anropade operationen.
Asynkront meddelandeHeldragen linje och öppen pil. Avsändaren kan fortsätta utan att vänta.
Svara / returneraStreckad linje som återgår till anroparen. Lägg till svar vänder på de valda meddelandeändpunkterna.
Skapa deltagareSkapande hör till den första interaktionen av mållivslinjen. Dess rubrik börjar vid detta meddelande.
Förstör deltagareEtt X markerar målets förstörelse. Detta bör vara dess sista interaktion.
Skapande och förstörelse stöds i huvudflödet, utanför fragment. Kontroller flaggar inkonsekvent livslängdsordning; ogiltig ordning håller hela livslinjen synlig så att senare interaktioner inte döljs.

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.

Mermaid / Exempel på text för API-anropsflöde
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
end
Bygg detta flöde visuellt eller använd API-förfrågningsmallen. Exemplet illustrerar textexport; det kan inte importeras till Erd Go.

Genvägar och begränsningar

Genvägar och begränsningar
Åtgärd eller gränsBeteende
Ctrl/Cmd+SSpara 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ögerFlytta den valda deltagaren åt vänster eller höger.
Alt+Upp / NerFlytta det valda steget inom dess nuvarande gren.
Ta bort / BackstegTa 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 dragningAvbryt 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 steg30 deltagare och totalt 300 steg, inklusive fragment och anteckningar.
Text80 tecken per deltagarnamn, 240 per meddelande/villkor/gruppetikett, 2 000 per anteckning.
Filer och historik4 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.