Belgelere geç

SOHBETİ TAKİP ET

Sıra diyagramı kılavuzu

Katılımcılar, çağrılar, yanıtlar, dallar ve notlarla sıralı API ve hizmet etkileşimleri oluşturun.

Katılımcılar ve iletiler → Sıra diyagramıSıralama Diyagramı'nı aç

Konuşmayı takip et

Sıra Diyagramı, insanlar, hizmetler ve sistemler arasındaki etkileşimler için bağımsız bir görsel çalışma alanıdır. Katılımcılar soldan sağa doğru ilerler; zaman sayfanın aşağısına doğru akar. Akış taslağı ve diyagram aynı sıralı modeli gösterir.

Bir istemciyi, Siparişler API'sini, Kimlik doğrulama hizmetini ve veritabanını keşfetmek için API istek şablonunu seçin. Şablon bir belirteci doğrular ve siparişleri veya yetkisiz bir yanıtı döndürmek için bir if/else grubu kullanır. Kendi konuşmanızı oluşturmak için Boş diyagramı seçin.

Bir API etkileşimi oluşturun

  1. Client ve API için katılımcılar ekleyin. Adını, sembolünü, rengini ve soldan sağa sırasını düzenlemek için Akış panelinde veya diyagram üzerinde birini seçin.
  2. Boş tuval, katılımcılar ve ilk mesajınız boyunca size rehberlik eder. Yeni isimler ve mesaj metni seçilidir, böylece hemen yazmaya başlayabilirsiniz. Mesaj'ı seçin, ardından Ayrıntılar kısmından Kimden, Kime ve Mesaj alanlarını düzenleyin. Ekle çubuğu, yeni adımın nereye gideceğini ve mesajı kimin gönderdiğini gösterir. Bir mesaj, seçilen adımdan sonra aynı dalda eklenir. Bir katılımcı seçmek, bir sonraki mesajı o katılımcıdan başlatır; seçilen bir mesaj ise uç noktalarını sağlar. Seçilen bir katılımcıdan eklenen notlar o çapayı kullanır. Seçili bir adım olmadığında, ana akışa eklenir.
  3. Bir ileti seçin ve uç noktalarını tersine çevirmek ve kesikli bir dönüş eklemek için Bu iletiden sonra yanıt ekle'yi kullanın. Adımları zaman içinde yerleştirmek için sürükleyin; önizleme varış noktalarını gösterir. Flow'un yukarı/aşağı kontrolleri mevcut dal içinde yeniden sıralama yapar.
  4. Grup → Eğer / değilse, İsteğe bağlı, Döngü veya Paralel kullanın. Koşulunu düzenlemek veya oraya adımlar eklemek için bir dal seçin. Dal ekle, bir else geri dönüşünden önce ekleme yapar. Akışta, her dalın kendi + düğmesi vardır.
  5. Kontrolleri Çalıştırın, diyagramı gözden geçirin ve sonucu Kaydedin veya Dışa aktarın. Telefonlarda Akış, Diyagram ve Ayrıntılar sekmelerini kullanın; Ayrıntıları düzenle seçilen öğeyi açar ve Diyagrama geri dön tuvale geri döner.

Diyagram üzerinde seçin, taşıyın ve ekleyin

Seçmek için bir katılımcı başlığına veya yaşam çizgisine, mesaja, nota, grup kenarlığına veya dal alanına tıklayın. Ayrıntıları açmak için Enter veya Space tuşuna basın. Boşluğu ve sırayı ayarlamak için katılımcı başlıklarını sola veya sağa sürükleyin; zaman sırasını ayarlamak ve boşluk bırakmak için mesajları, notları veya tüm grupları dikey olarak sürükleyin. Dokunmatik ekranlarda, görünür tutamacı sürükleyin; kaydırmak için başka bir yere kaydırın.

Önizleme, önerilen diyagramı gösterir ve hedef dalını adlandırır. Bir adımı aktarmak için başka bir dala bırakın veya Detaylar kısmındaki Adımı taşı seçeneğini kullanın. Oluşturma ve yok etme ana akışta kalır; gruplar kendi içlerine taşınamaz. Sürüklemeler 8 piksele hizalanır. Escape tuşu veya iptal işlemi modeli değiştirmeden bırakır; bırakma işlemi geri alınabilir tek bir değişiklik yapar. Düzenle (Tidy up) özelliği, sıralamanızı ve dallarınızı korurken otomatik boşluklandırmayı geri yükler.

Ekle çubuğuna tıklayın veya masaüstünde Katılımcı, Mesaj, Not veya bir Grubu diyagramın üzerine sürükleyin. Grup seçenekleri If / else, Optional, Loop ve Parallel kavramlarını sade bir dille açıklar. Bırakma önizlemesi ve tuval alt bilgisi, hedef dalı adlandırır ve zamandaki konumunu gösterir. Palet sürüklemeleri ilk iki katılımcıyla başlar; sürükleme sırasında yön gösterilir. Ayrıntılar'da mesaj uç noktalarını seçin; bir yaşam çizgisine yakın bırakmak onları değiştirmez.

Seçimi temizlemek için boş tuvale tıklayın. Seçimi korurken keşfetmek için boş tuvali sürükleyin veya orta fare düğmesini kullanın. Katılımcılardan önce bir grup eklenebilir; tuval yer tutucusu ve Akış + düğmesi ilk katılımcıyı ekler, ardından ilk mesajı sunar.

Katılımcılar ve yaşam çizgileri

Katılımcı, Aktör, Sınır, Kontrol, Varlık ve Veritabanı başlık sembolünü değiştirir. Bunlar veritabanı tabloları değil, bir etkileşimdeki rollerdir. İsimler ve isteğe bağlı opak onaltılık vurgu renkleri diyagramla birlikte kaydedilir.

Konumlandırmak için bir katılımcı başlığını sürükleyin; okunabilirliği korumak için yakındaki başlıklar yana kayar. Sola Taşı ve Sağa Taşı, görüntülenen sıradaki yerini değiştirir. Mesaj uç noktaları değişmeden kalır. Katılımcı Detayları, mesaj gönder ve not ekle eylemleri sunar. Aynı katılımcıya gönderilen bir mesaj otomatik olarak kendi kendine çağrıya dönüşür; tek katılımcılı bir diyagram bunu açıkça sunar. Bir katılımcıyı silmek, onu içeren mesajları da kaldırır ve notlardaki bağlantısını siler; Geri Al işlemi değişikliğin tamamını geri yükler.

Çağrılar, yanıtlar ve yaşam süreleri

Çağrılar, yanıtlar ve yaşam süreleri
TürAnlam
Senkron çağrıDüz çizgi ve dolu ok. Gönderen, çağrılan işlemin bitmesini bekler.
Asenkron mesajDüz çizgi ve açık ok. Gönderen, beklemeden devam edebilir.
Yanıtla / döndürÇağırana dönen kesikli çizgi. Yanıt ekle, seçilen ileti uç noktalarını tersine çevirir.
Katılımcı oluşturOluşturma, hedef yaşam çizgisinin ilk etkileşimine aittir. Başlığı bu mesajda başlar.
Katılımcıyı yok etBir X, hedefin yok oluşunu işaret eder. Bu onun son etkileşimi olmalıdır.
Oluşturma ve yok etme, parçaların dışında ana akışta desteklenir. Denetimler tutarsız yaşam süresi sıralamasını işaretler; geçersiz sıralama, sonraki etkileşimlerin gizlenmemesi için tüm yaşam çizgisini görünür tutar.

Dalları anlamlarını kaybetmeden gruplandırın

If / else (alt) 2–6 arası alternatif dal içerir; tam olarak bir eşleşen işlenen seçilir. İsteğe bağlı (opt) bir koşullu dal içerir. Döngü (loop) bir tekrarlanan dal içerir; yineleme koşulunu yazın. Paralel (par) etkileşimleri iç içe geçebilen 2–6 işlenen içerir.

Dal üyeliği açıktır. Akış düğmeleri ve Alt+Yukarı/Aşağı, bir adımı mevcut dalında tutar. Sürükleme işlemi; bir mesajı, notu veya tüm grubu önizlemede adlandırılan dala aktarabilir; Adımı şuraya taşı seçeneği, Ayrıntılar kısmında aynı seçeneği sunar. Geçersiz hedefler; bir grubu kendi içine taşımak, dört iç içe geçmiş seviyeyi aşmak veya oluşturma/yok etme işlemini bir dalın içine koymak dahil olmak üzere bir nedenle devre dışı bırakılır.

Çok dallı bir grubu İsteğe Bağlı veya Döngü olarak değiştirmek, yalnızca ilk dalını tutmadan önce sorar. Bir dalı silmek, adımlarını kaldırmadan önce sorar; eğer bir dal kalırsa grup İsteğe Bağlı hale gelir ve tek dalı silmek grubu kaldırır. Bir grubu silmek, tüm adımlarını onay ile kaldırır. Geri al, değişikliğin tamamını geri yükler. Paralel dalların dikey yerleşimi, aralarındaki yürütme sırasını ima etmez.

Notlar, numaralandırma ve etkinleştirmeler

Bir not ekleyin ve kapsaması gereken katılımcıları seçin. Notlar çerçeveleri içinde kaydırılır ve sıra düzeniyle birlikte hareket eder. Bunları, bir mesaj okunun üzerine paragraf koymak yerine kısıtlamalar veya açıklamalar için kullanın.

Görünüm kontrolleri mesaj numaralarını ve otomatik aktivasyon çubuklarını yönetir. Bu görünüm seçenekleri kaydedilir ve görüntü dışa aktarımına dahil edilir. Numaralar bir okuma sırası sağlar; bunlar ölçülen zaman damgaları veya paralel dallar genelinde toplam bir yürütme sırası değildir.

Etkinleştirme çubukları, eşzamanlı çağrılardan ve çizilen yanıtlardan çıkarılır. Kendi kendine yapılan çağrılar iç içe geçebilir. Alternatif dallar ayrı ayrı hesaplanır, böylece bir daldaki yanıtlar diğerindeki çağrıları kapatmaz. Eksik yanıtlar, bir etkinleştirmeyi o kapsamın sonuna kadar açık bırakır; bu, yürütme analizinden ziyade görsel bir yardımcıdır.

Yeni diyagramlar okunabilir bir ölçekte başlar; geniş diyagramlar yatay olarak kaydırılabilir. Diyagram genişliğine sığdır seçeneği, dikey okumayı korurken genel bir bakış sağlar. Keşfetmek için kaydırın, yakınlaştırma kontrollerini kullanın veya işaretçi etrafında yakınlaştırmak için Ctrl/Command tuşu ile birlikte kaydırın. Bul özelliği katılımcı adlarını ve türlerini, mesajları ve uç noktalarını, notları, grup açıklamalarını ve koşulları arar. Eşleşen adımlar ilgili dal bağlamlarını korur; kimlikler ve konumlar hariç tutulur. Temizle veya Escape tuşu tam Akışı geri yükler ve boş bir sonuç neyi denemeniz gerektiğini açıklar. Bir Akış veya Kontrol sonucu seçmek ya da bir öğe eklemek, yakınlaştırmayı değiştirmeden etiketini görünür hale getirir. Telefonlarda bu, Diyagrama geri döndüğünüzde gerçekleşir. Tuval kaydırma, yakınlaştırma ve seçim, belge ve Geri Al geçmişinin dışındaki çalışma alanı görünümleridir.

Kaydet, paylaş ve içe aktar

Yeni diyagramlar bellekte kalır. Kaydet, gerektiğinde oturum açar ve bağımsız bir sıra diyagramı bulut dosyası oluşturur. Dosya → Sıra diyagramlarını aç, kendi dosya listesini açar. Salt okunur bir genel bağlantı paylaşmadan önce en son değişiklikleri kaydedin. Genel izleyiciler dosyayı inceleyebilir ve dışa aktarabilir ancak düzenleyemez.

Dosya → JSON İndir, katılımcı konumları ve adım boşlukları dahil olmak üzere düzenlenebilir belgenin tamamını korur. Bulut kayıtları ve görüntü dışa aktarımları da bu yerleşimi korur. JSON İçe Aktar, 4 MB'a kadar dışa aktarılmış Erd Go sıra diyagramı sürüm 1 dosyalarını kabul eder, değiştirmeden önce dosyanın tamamını doğrular ve Geri Al'ı destekler. Eski dosyalar otomatik aralıkları korur; çakışan içe aktarılan konumlar güvenli bir şekilde görüntülenir. SQL, Sınıf Diyagramı, Mermaid ve PlantUML içe aktarma formatları değildir.

Dosya → Yeni diyagram, Boş/Şablon seçiciyi tekrar açar. Boş ve API isteği örneği, mevcut bir modeli onay ve Geri Al ile değiştirir. Kaydedilmemiş diyagramlar, ayrılmadan veya yeniden yüklemeden önce uyarır. Tarayıcı depolama alanına hiçbir şey yazılmaz.

Bir diyagramı veya metin kaynağını dışa aktarın

Dışa aktarma; PNG, JPEG, WebP, bağımsız vektör SVG veya resim destekli PDF oluşturur. Tüm diyagram veya Mevcut görünüm (telefonlarda önce Diyagram panelini açın) ve HD, 2K veya 4K genişlik seçin. Raster boyutları taraf başına 8192 piksel ve 16 megapiksel ile sınırlıdır; çok uzun diyagramlar küçültülebilir. Ölçeklenebilir büyük diyagramlar için SVG'yi veya okunabilir bir bölüm için Mevcut görünümü kullanın.

Dosya → PlantUML / Mermaid Dışa Aktar, yerel metni önizler, kopyalar ve indirir. Metin oluşturucu kendi düzenini ve görünümünü kontrol eder; katılımcı sembolleri veya renkleri farklılık gösterebilir. JSON, tam düzenlenebilir formattır. Üçüncü taraf bir oluşturma sunucusuna hiçbir kaynak gönderilmez.

Mermaid / API istek akışı metin örneği
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
Bu akışı görsel olarak oluşturun veya API istek şablonunu kullanın. Örnek, metin dışa aktarımını göstermektedir; Erd Go'ya aktarılamaz.

Kısayollar ve sınırlar

Kısayollar ve sınırlar
Eylem veya sınırDavranış
Ctrl/Cmd+SBuluta Kaydet; istendiğinde oturum açın.
Ctrl/Cmd+KAkış panelinde Bul'u açın ve odaklanın.
Ctrl/Cmd+Z / Shift+Z / Ctrl+YMetin alanlarının dışında Geri Al / Yinele. Metin alanları yerel düzenleme kısayollarını korur.
Enter / BoşlukOdaklanılan diyagram öğesi için Ayrıntıları açın.
Alt+Sol / SağSeçili katılımcıyı sola veya sağa taşıyın.
Alt+Yukarı / AşağıSeçili adımı mevcut dalı içinde taşıyın.
Sil / Geri alMetin alanlarının dışındaki seçimi silin veya tuval çöp kutusu düğmesini kullanın. Katılımcı kademeli silmeleri ve grup/dal kaldırma işlemleri onay ister.
Sürükleme sırasında EscapeModeli değiştirmeden önizlemeyi iptal edin.
DüzenleSıralamayı veya dalları değiştirmeden otomatik aralığı geri yükleyin; Geri Al, yerleşimi geri yükler.
Katılımcılar ve adımlar30 katılımcı ve parçalar ile notlar dahil toplam 300 adım.
MetinKatılımcı adı başına 80 karakter, mesaj/koşul/grup etiketi başına 240, not başına 2.000 karakter.
Dosyalar ve geçmiş4 MB içe aktarılan JSON, 3–255 karakterlik bulut dosya adı ve 80 geri alma durumu.

Gözden geçirin ve sorun giderin

Kontroller boş isimleri, yinelenen katılımcı isimlerini, eksik mesaj etiketlerini, boş dalları, eksik koşulları ve tutarsız oluşturma veya yok etme sırasını işaretler. Ayrıntılarını ortaya çıkarmak için bir bulguyu seçin. Bu kontroller konuşmayı yürütmez veya API davranışını kanıtlamaz.

İçe aktarma başarısız olursa, mevcut diyagramınız bozulmadan kalır. Bekleyen eski bir dosya okuması, daha yeni bir belgeyi, daha yeni bir içe aktarmayı veya düzenlenmiş bir modeli değiştiremez. Buluta kaydetme başarısız olursa, diyagramı açık tutun ve ayrılmadan önce JSON'u indirin.

Etkileşim notasyonunun anlamı için OMG UML spesifikasyonunu kullanın. PlantUML ve Mermaid'in kendi metin sözdizimi vardır; oluşturulan dosyalar bu araçlar için dışa aktarımlardır, bir Erd Go içe aktarma dili değildir.