İçeriğe atla

Ücretsiz araç

Structurizr DSL’den C4 model diyagramına

Bir Structurizr DSL workspace’ini ya da workspace JSON dışa aktarımını yapıştırın; C4 modelinin görünümlerini düzenleyebileceğiniz diyagramlar olarak görün: kişiler, yazılım sistemleri, container’lar, component’ler ve deployment node’ları, ilişkiler açıklamalarıyla etiketli. Bir görünüm seçin ya da hepsini ayrı diyagramlar olarak açın.

Örnek çıktı

Structurizr örneğinden çizilmiş örnek diyagram
Bir örnek deneyinÇevrim içi bankacılık (DSL)Kargo takibi (JSON)

Nasıl çalışır

  1. Workspace’inizi yapıştırın ya da bırakın

    Bir workspace.dsl dosyası, Structurizr playground’dan kopyalanan DSL ya da Structurizr’ın dışa aktardığı JSON. model ve views blokları okunur; styles metinde kalabilir.

  2. Her C4 görünümünü görün

    Workspace’teki her görünüm, sistem manzarasından component ve deployment görünümlerine kadar listelenir. Birini seçtiğinizde önizleme onu C4 kartları, sınırlar ve etiketli oklarla yeniden çizer.

  3. Archboard’da açın

    Görünümü yeni bir diyagram olarak kaydedin; yeniden düzenleyin, not ekleyin, bağlantı paylaşın ya da SVG ve PNG olarak dışa aktarın. Kaydolmak için bir Google ya da GitHub hesabı yeterli.

Bir Structurizr workspace’inden neler çizilir

Seçili görünüm modelin şu parçalarından kurulur:

  • person

    Kişiler, açıklamalarıyla C4 kişi kartı olarak. External tag’i taşıyan ya da JSON dışa aktarımında location External olan kişi dış kişi olur.

  • softwareSystem

    Yazılım sistemleri, açıklamalarıyla C4 sistem kartı olarak. External tag’li sistemler yalnız adı gösteren dış sistem kartına dönüşür.

  • container

    Container’lar, teknolojisi ve açıklamasıyla kart olarak. Database tag’li container, yalnız adı gösteren veritabanı kartı olur. Queue tag’li container, External tag’li container ve component’ler ve enterprise bloğu kendi C4 tipleriyle çizilir: queue container, external container ve component kartları, enterprise sınırı.

  • component

    Component’ler, teknolojileriyle, ait oldukları container’ın içinde kart olarak.

  • ->

    İlişkiler, açıklamasıyla etiketlenmiş ok olarak; teknoloji köşeli parantez içinde ardından gelir. Görünüm yalnız ebeveynleri gösteriyorsa çocukları arasındaki ilişki ebeveynler arasında bir kez çizilir.

  • container bankingcomponent banking.api

    Container ve component görünümünün kapsamı çerçeve olur: container görünümünde yazılım sistemi, component görünümünde container.

  • group

    Gruplar, içerdikleri kişi, sistem ya da container’ların çevresinde çerçeve olarak. Boş grup çizilmez.

  • deploymentNodeinfrastructureNodecontainerInstance

    Deployment görünümleri: iç içe deployment node’ları çerçeve, container ve yazılım sistemi örnekleri temsil ettikleri kart, altyapı node’ları deployment node kartı olarak.

  • systemLandscapesystemContextdeployment

    Sistem manzarası, sistem bağlamı, container, component ve deployment görünümleri; her biri ayrı bir diyagram. Görünümü olmayan workspace’e bir manzara, her sistem için bir bağlam görünümü ve container’ı olan her sistem için bir container görünümü üretilir.

  • autoLayout lrinclude *

    Her görünüm türündeki anlamıyla include *, tanımlayıcı listeli include ve exclude, ve autoLayout yönü; yön verilmemişse yukarıdan aşağıya.

Bir workspace, birçok görünüm

Bir workspace genellikle aynı modelin birden çok görünümünü taşır. Dosyadaki ilk görünüm önce çizilir; önizlemenin üstündeki görünüm seçici aynı metnin başka bir görünümüne geçer. Her görünümü saklamak için Tüm görünümleri aç, çalışma alanınızda her görünüme bir diyagram oluşturur; seçili görünüm ilk sırada. Free planda diyagram sınırınıza sığmayan görünümler sessizce düşmez: araç kaçının açıldığını ve kaçının kaldığını söyler.

Structurizr içe aktarmasında olmayanlar

  • Workspace’in gösterdiği dosya ve betikler: !include, !docs, !adrs, !script, !plugin ve workspace extends izlenmez, çalıştırılmaz. Bir uyarıda sayılırlar; yapıştırılan metinde yazılı her şey yine çizilir.
  • Öğe ve ilişki stilleri, temalar ve marka ayarları. Şekil, renk ve simgeler C4 kartlarından gelir; diyagram Archboard’da açıldıktan sonra stilleri değiştirebilirsiniz.
  • Dynamic, filtered, custom ve image görünümleri ile ifade olarak yazılmış include ya da exclude kuralları. Bunlar atlanıp sayılır; diğer görünümler yine listelenir.
  • JSON dışa aktarımında kayıtlı öğe konumları. Structurizr ölçüleri C4 kartlarına uymadığı için her görünüm yeniden otomatik yerleştirilir.
  • Belge bölümleri, karar kayıtları, properties, perspectives ve URL’ler. Yalnız model ve görünümleri okunur.

Structurizr ile ilgili sorular

Structurizr DSL’den hangi C4 düzeylerini çizebilirim?

Bir Structurizr workspace’inin modellediği her düzeyi: 1. düzey için sistem bağlamı ve sistem manzarası, 2. düzey için container, 3. düzey için component görünümleri, ayrıca deployment görünümleri. Kod düzeyi diyagramlar bir Structurizr workspace’inin parçası değildir, onlar için çizilecek bir şey yoktur.

DSL yerine workspace JSON dışa aktarımını yapıştırabilir miyim?

Evet. Structurizr’ın kaydettiği ya da dışa aktardığı JSON aynı şekilde okunur: her görünümde listelenen öğe ve ilişkiler çizilir; kişiler, sistemler, container’lar ve deployment node’ları dahil. Kayıtlı konumlar yok sayılır, her görünüm yeni bir otomatik yerleşim alır.

Bütün görünümleri tek seferde açabilir miyim?

Evet. Workspace’te iki ya da daha fazla görünüm varsa Tüm görünümleri aç, seçtiğiniz görünümden başlayarak her biri için ayrı bir diyagram oluşturur. Planınızın diyagram sınırı işlemi erken durdurursa açılan görünümler kalır, kalanlar sayılır; hiçbir şey haber verilmeden kaybolmaz.

Workspace’im !include kullanıyor. Ne yapmalıyım?

Dahil edilen dosyaları !include satırlarının yerine aynı metin kutusuna yapıştırın. Araç yalnız verdiğiniz metni okuduğu için yönerge izlenmez, bir uyarıda sayılır.

Diyagramı Archboard’da açınca ne kaydedilir?

Önizleme kaydedilmez. Archboard’da aç’ı seçtiğinizde gördüğünüz görünüm, C4 kartları, sınırları, çerçeveleri ve etiketli oklarıyla çalışma alanınızda yeni bir diyagram olarak kaydedilir. DSL ya da JSON’da sonradan yaptığınız değişiklikler onu güncellemez.

Structurizr’dan diyagram aracı ücretsiz mi?

Evet. Workspace yapıştırmak ve diyagramlarını görmek hesap gerektirmez. Bir görünümü ya da hepsini Archboard’da açmak için ücretsiz bir hesap gerekir.

Bir dakikada canvas açın

Google veya GitHub ile giriş yapın. Tek koltuk ücretsiz; ekip katılınca planı yükseltin.