문서로 건너뛰기

대화 팔로우

시퀀스 다이어그램 가이드

참여자, 호출, 응답, 분기, 노트를 사용해 순서가 있는 API 및 서비스 상호 작용을 만드세요.

참여자 및 메시지 → 시퀀스 다이어그램시퀀스 다이어그램 열기

대화 팔로우하기

시퀀스 다이어그램은 사람, 서비스 및 시스템 간의 상호 작용을 위한 독립적인 시각적 작업 공간입니다. 참여자는 왼쪽에서 오른쪽으로 배치되며, 시간은 페이지 아래로 흐릅니다. 흐름 개요와 다이어그램은 동일한 순서의 모델을 보여줍니다.

클라이언트, Orders API, Auth 서비스 및 데이터베이스를 탐색하려면 API 요청 템플릿을 선택하세요. 이 템플릿은 토큰을 확인하고 if/else 그룹을 사용하여 주문 또는 승인되지 않은 응답을 반환합니다. 자신만의 대화를 구축하려면 빈 다이어그램을 선택하세요.

API 상호작용 구축

  1. Client 및 API에 대한 참여자를 추가하세요. Flow 패널이나 다이어그램에서 하나를 선택하여 이름, 기호, 색상 및 왼쪽에서 오른쪽 순서를 편집하세요.
  2. 빈 캔버스는 참여자와 첫 번째 메시지를 안내합니다. 즉시 입력할 수 있도록 새 이름과 메시지 텍스트가 선택됩니다. 메시지를 선택한 다음 세부 정보에서 보낸 사람, 받는 사람 및 메시지를 편집하십시오. 추가 표시줄은 새 단계가 이동할 위치와 메시지를 보내는 사람을 보여줍니다. 선택한 단계 뒤의 동일한 브랜치에 메시지가 추가됩니다. 참여자를 선택하면 해당 참여자로부터 다음 메시지가 시작됩니다. 선택한 메시지는 엔드포인트를 제공합니다. 선택한 참여자로부터 추가된 노트는 해당 앵커를 사용합니다. 선택한 단계가 없으면 메인 흐름에 추가됩니다.
  3. 메시지를 선택하고 '이 메시지 뒤에 회신 추가'를 사용하여 끝점을 반전시키고 점선 반환을 추가하세요. 단계를 드래그하여 시간 순서대로 배치하세요. 미리보기에 목적지가 표시됩니다. Flow의 위/아래 컨트롤은 현재 분기 내에서 순서를 변경합니다.
  4. 그룹 → If / else, Optional, Loop 또는 Parallel을 사용하세요. 분기를 선택하여 조건을 편집하거나 단계를 추가하세요. 분기 추가는 else 폴백 앞에 삽입됩니다. Flow에서 각 분기에는 자체 + 버튼이 있습니다.
  5. 검사를 실행하고 다이어그램을 검토한 다음 결과를 저장하거나 내보내기 하세요. 휴대폰에서는 흐름, 다이어그램 및 세부 정보 탭을 사용하세요. 세부 정보 편집은 선택한 요소를 열고 다이어그램으로 돌아가기는 캔버스로 돌아갑니다.

다이어그램에서 선택, 이동 및 추가

참여자 헤더나 생명선, 메시지, 노트, 그룹 테두리 또는 분기 영역을 클릭하여 선택하세요. Enter 또는 Space를 눌러 상세 정보를 엽니다. 참여자 헤더를 왼쪽이나 오른쪽으로 드래그하여 간격과 순서를 조정하고, 메시지, 노트 또는 전체 그룹을 수직으로 드래그하여 시간 순서를 설정하고 간격을 둡니다. 터치스크린에서는 보이는 그립을 드래그하고, 다른 곳을 스와이프하여 스크롤하세요.

미리보기는 제안된 다이어그램을 보여주고 대상 브랜치의 이름을 지정합니다. 단계를 전송하려면 다른 브랜치로 드롭하거나, 상세 정보에서 '단계 이동'을 사용하십시오. 생성 및 파괴는 메인 흐름에 유지되며, 그룹은 그룹 내부로 이동할 수 없습니다. 드래그는 8픽셀 단위로 스냅됩니다. Escape를 누르거나 취소하면 모델이 변경되지 않은 상태로 유지되며, 마우스를 놓으면 실행 취소 가능한 변경 사항이 하나 생성됩니다. '정리'는 순서와 브랜치를 유지하면서 자동 간격을 복원합니다.

추가 바를 클릭하거나, 데스크톱에서 참여자, 메시지, 노트 또는 그룹을 다이어그램으로 드래그하세요. 그룹 선택지는 If / else, Optional, Loop 및 Parallel을 쉬운 언어로 설명합니다. 드롭 미리보기와 캔버스 바닥글은 대상 분기 이름을 지정하고 시간상 위치를 표시합니다. 팔레트 드래그는 처음 두 참여자로 시작하며, 드래그하는 동안 방향이 표시됩니다. 상세 정보에서 메시지 끝점을 선택하세요. 생명선 근처에 드롭해도 끝점은 변경되지 않습니다.

빈 캔버스를 클릭하여 선택을 해제하세요. 빈 캔버스를 드래그하거나 마우스 가운데 버튼을 사용하여 선택을 유지한 채 탐색하세요. 참여자 앞에 그룹을 추가할 수 있습니다. 캔버스 자리 표시자와 Flow + 버튼이 첫 번째 참여자를 추가한 다음 첫 번째 메시지를 제안합니다.

참여자 및 생명선

참여자, 액터, 경계, 제어, 엔티티 및 데이터베이스는 헤더 기호를 변경합니다. 이들은 상호작용에서의 역할이며 데이터베이스 테이블이 아닙니다. 이름과 선택적인 불투명 16진수 강조 색상은 다이어그램과 함께 저장됩니다.

참여자 헤더를 드래그하여 위치를 조정하세요. 가독성을 유지하기 위해 근처의 헤더가 옆으로 이동합니다. 왼쪽으로 이동 및 오른쪽으로 이동은 표시 순서에서 위치를 바꿉니다. 메시지 엔드포인트는 변경되지 않은 상태로 유지됩니다. 참여자 상세 정보는 메시지 보내기 및 노트 추가 작업을 제공합니다. 동일한 참여자에게 보내는 메시지는 자동으로 셀프 호출이 되며, 참여자가 한 명인 다이어그램에서는 이를 명시적으로 제공합니다. 참여자를 삭제하면 해당 참여자가 포함된 메시지도 제거되고 노트에서 앵커가 제거됩니다. 실행 취소는 전체 변경 사항을 복구합니다.

호출, 응답 및 수명

호출, 응답 및 수명
종류의미
동기 호출실선과 채워진 화살표. 발신자는 호출된 작업이 완료될 때까지 기다립니다.
비동기 메시지실선과 열린 화살표. 발신자는 기다리지 않고 계속할 수 있습니다.
회신 / 반환호출자에게 돌아가는 점선입니다. 회신 추가는 선택한 메시지 엔드포인트를 반전시킵니다.
참여자 생성생성은 대상 생명선의 첫 번째 상호작용에 속합니다. 헤더는 이 메시지에서 시작됩니다.
참여자 소멸X는 대상의 파괴를 표시합니다. 이것은 대상의 마지막 상호작용이어야 합니다.
생성 및 소멸은 프래그먼트 외부의 메인 흐름에서 지원됩니다. 일관되지 않은 수명 주기 순서를 확인하여 플래그를 표시합니다. 잘못된 순서의 경우 전체 생명선이 표시된 상태로 유지되어 이후의 상호작용이 숨겨지지 않습니다.

의미를 잃지 않고 브랜치를 그룹화하십시오.

If / else (alt)는 2~6개의 대체 분기를 포함하며, 정확히 하나의 일치하는 피연산자가 선택됩니다. Optional (opt)은 하나의 조건부 분기를 포함합니다. Loop는 하나의 반복 분기를 포함하며, 반복 조건을 작성합니다. Parallel (par)는 상호 작용이 겹칠 수 있는 2~6개의 피연산자를 포함합니다.

브랜치 멤버십은 명시적입니다. 흐름 버튼과 Alt+Up/Down은 단계를 현재 브랜치에 유지합니다. 드래그를 통해 메시지, 메모 또는 전체 그룹을 미리보기에 이름이 표시된 브랜치로 이동할 수 있습니다. '단계 이동'은 '세부 정보'에서 동일한 선택을 제공합니다. 그룹을 자기 자신 내부로 이동하거나, 4단계 중첩 수준을 초과하거나, 생성/소멸을 브랜치 내부에 넣는 등의 잘못된 대상은 이유와 함께 비활성화됩니다.

다중 분기 그룹을 선택 사항 또는 루프로 변경하면 첫 번째 분기만 유지하기 전에 확인 메시지가 표시됩니다. 분기를 삭제하면 해당 단계를 제거하기 전에 확인 메시지가 표시됩니다. 분기가 하나만 남으면 그룹은 선택 사항이 되며, 유일한 분기를 삭제하면 그룹이 제거됩니다. 그룹을 삭제하면 확인 후 모든 단계가 제거됩니다. 실행 취소는 전체 변경 사항을 복구합니다. 병렬 분기의 수직 배치는 분기 간의 실행 순서를 의미하지 않습니다.

노트, 번호 매기기 및 활성화

노트를 추가하고 해당 노트가 걸쳐야 할 참여자를 선택하세요. 노트는 프레임 내에서 줄바꿈되며 시퀀스 순서에 따라 이동합니다. 메시지 화살표에 긴 문장을 넣는 대신 제약 조건이나 설명을 위해 노트를 사용하세요.

뷰는 메시지 번호와 자동 활성화 바를 제어합니다. 이러한 모양 옵션은 저장되며 이미지 내보내기에 포함됩니다. 번호는 읽기 순서를 제공하며, 측정된 타임스탬프나 병렬 분기 전체의 총 실행 순서가 아닙니다.

활성화 바는 동기 호출 및 그려진 응답에서 유추됩니다. 자체 호출은 중첩될 수 있습니다. 대체 분기는 별도로 계산되므로 한 분기의 응답이 다른 분기의 호출을 닫지 않습니다. 누락된 응답은 해당 범위가 끝날 때까지 활성화를 열어 둡니다. 이는 실행 분석이라기보다는 시각적 도움말입니다.

새 다이어그램은 읽기 쉬운 배율로 시작하며, 넓은 다이어그램은 가로로 스크롤할 수 있습니다. 다이어그램 너비 맞춤은 세로 읽기를 유지하면서 개요를 제공합니다. 스크롤하여 탐색하거나, 확대/축소 컨트롤을 사용하거나, Ctrl/Command와 스크롤을 함께 사용하여 포인터 주변을 확대/축소하세요. 찾기는 참여자 이름 및 유형, 메시지 및 엔드포인트, 노트, 그룹 설명 및 조건을 검색합니다. 일치하는 단계는 관련 브랜치 컨텍스트를 유지하며, ID와 위치는 제외됩니다. 지우기 또는 Escape는 전체 Flow를 복원하며, 결과가 없으면 시도해 볼 내용이 설명됩니다. Flow 또는 Checks 결과를 선택하거나 요소를 추가하면 확대/축소를 변경하지 않고 해당 레이블이 보기로 들어옵니다. 휴대폰에서는 다이어그램으로 돌아갈 때 이 작업이 수행됩니다. 캔버스 스크롤, 확대/축소 및 선택은 문서 및 실행 취소 기록 외부의 워크스페이스 뷰입니다.

저장, 공유 및 가져오기

새 다이어그램은 메모리에 남아 있습니다. 저장을 클릭하면 필요한 경우 로그인을 진행하고 독립적인 시퀀스 다이어그램 클라우드 파일을 생성합니다. 파일 → 시퀀스 다이어그램 열기를 선택하면 전용 파일 목록이 열립니다. 읽기 전용 공개 링크를 공유하기 전에 최신 변경 사항을 저장하세요. 공개 뷰어는 파일을 검사하고 내보내기할 수 있지만 편집할 수는 없습니다.

파일 → JSON 다운로드는 참여자 위치와 단계 간격을 포함하여 편집 가능한 전체 문서를 유지합니다. 클라우드 저장 및 이미지 내보내기에서도 이 배치가 유지됩니다. JSON 가져오기는 내보낸 Erd Go 시퀀스 다이어그램 버전 1 파일을 최대 4MB까지 수락하며, 교체 전 전체 파일을 검증하고 실행 취소를 지원합니다. 이전 파일은 자동 간격을 유지하며, 겹치는 가져온 위치는 안전하게 표시됩니다. SQL, 클래스 다이어그램, Mermaid 및 PlantUML은 가져오기 형식이 아닙니다.

파일 → 새 다이어그램은 빈 페이지/템플릿 선택기를 다시 엽니다. 빈 페이지 및 API 요청 예제는 확인 및 실행 취소와 함께 기존 모델을 대체합니다. 저장되지 않은 다이어그램은 페이지를 떠나거나 새로 고침하기 전에 확인 메시지를 표시합니다. 브라우저 저장소에는 아무것도 기록되지 않습니다.

다이어그램 또는 텍스트 소스 내보내기

내보내기를 통해 PNG, JPEG, WebP, 독립형 벡터 SVG 또는 이미지가 포함된 PDF를 생성합니다. 전체 다이어그램 또는 현재 보기(휴대폰에서는 먼저 다이어그램 패널을 여십시오)를 선택하고 HD, 2K 또는 4K 너비를 선택하십시오. 래스터 크기는 측면당 8192픽셀 및 16메가픽셀로 제한됩니다. 매우 긴 다이어그램은 축소될 수 있습니다. 확장 가능한 대형 다이어그램에는 SVG를 사용하고, 읽기 쉬운 섹션에는 현재 보기를 사용하십시오.

파일 → 내보내기 PlantUML / Mermaid는 로컬 텍스트를 미리 보고, 복사하고, 다운로드합니다. 텍스트 렌더러는 자체 레이아웃과 모양을 제어하며, 참여자 기호나 색상이 다를 수 있습니다. JSON은 완전한 편집 가능 형식입니다. 소스는 제3자 렌더링 서버로 전송되지 않습니다.

Mermaid / API 요청 흐름 텍스트 예시
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
이 흐름을 시각적으로 구축하거나 API 요청 템플릿을 사용하세요. 이 예제는 텍스트 내보내기를 보여주며, Erd Go로 가져올 수 없습니다.

바로가기 및 제한 사항

바로가기 및 제한 사항
작업 또는 제한동작
Ctrl/Cmd+S클라우드에 저장. 메시지가 표시되면 로그인하세요.
Ctrl/Cmd+K플로우 패널에서 찾기를 열고 포커스를 맞추세요.
Ctrl/Cmd+Z / Shift+Z / Ctrl+Y텍스트 필드 외부에서의 실행 취소 / 다시 실행. 텍스트 필드는 기본 편집 단축키를 유지합니다.
Enter / Space포커스된 다이어그램 요소의 세부 정보 열기.
Alt+왼쪽 / 오른쪽선택한 참여자를 왼쪽이나 오른쪽으로 이동합니다.
Alt+위 / 아래선택한 단계를 현재 브랜치 내에서 이동합니다.
삭제 / 백스페이스텍스트 필드 외부에서 선택 항목을 삭제하거나 캔버스 휴지통 버튼을 사용하세요. 참여자 연계 삭제 및 그룹/브랜치 제거 시 확인 메시지가 표시됩니다.
드래그 중 Escape모델을 변경하지 않고 미리보기를 취소합니다.
정리하기순서나 분기를 변경하지 않고 자동 간격을 복원합니다. 실행 취소하면 배치가 복원됩니다.
참여자 및 단계30명의 참가자와 프래그먼트 및 노트를 포함한 총 300개의 단계.
텍스트참가자 이름당 80자, 메시지/조건/그룹 레이블당 240자, 노트당 2,000자.
파일 및 기록4 MB 가져온 JSON, 3–255자 클라우드 파일 이름, 80개의 실행 취소 상태.

검토 및 문제 해결

검사는 빈 이름, 중복된 참여자 이름, 누락된 메시지 레이블, 빈 분기, 누락된 조건, 일관되지 않은 생성 또는 소멸 순서를 표시합니다. 결과를 선택하여 세부 정보를 확인하세요. 이러한 검사는 대화를 실행하거나 API 동작을 증명하지 않습니다.

가져오기에 실패하더라도 현재 다이어그램은 그대로 유지됩니다. 오래된 보류 중인 파일 읽기는 최신 문서, 최신 가져오기 또는 편집된 모델을 대체할 수 없습니다. 클라우드 저장에 실패하면 다이어그램을 열어두고 나가기 전에 JSON을 다운로드하세요.

상호작용 표기법의 의미에 대해서는 OMG UML 사양을 사용하세요. PlantUML과 Mermaid는 고유한 텍스트 구문을 가집니다. 생성된 파일은 해당 도구를 위한 내보내기용이며, Erd Go 가져오기 언어가 아닙니다.