Widget Oluşturma — Genel Bakış
Cartography'de KPI widget'ı çok adımlı bir sihirbaz üzerinden oluşturulur. Sihirbazın adımları CartographyInsertGuard route middleware'i tarafından zorlanır; seçtiğiniz chart grubu ve chart tipi'ne göre farklı sub-flow'lar çalışır.
Her sub-flow kendi numaralı adım sayfa setine sahiptir. Sub-flow'un kendi index.md'sine giderek o akışın adım dizilimini görebilirsiniz.
Ön Koşul
Static Text dışındaki tüm widget'lar için Compass modülünde en az bir kayıtlı sorgu olmalıdır. Compass sorgusu yoksa: → Compass
1. Sub-Flow Seçim Tablosu
Her chart tipi için ilgili sub-flow'a ve numaralı adım sayfalarına buradan ulaşabilirsiniz.
| Chart Tipi (Grup) | Sub-Flow | Çalışan Adımlar | Sub-Flow Sayfası |
|---|---|---|---|
| Line / Area / Spline / Column / Bar / Step Line (Cartesian) | Standart | 1-9 (tümü) | Standart Cartesian |
| Stacked* (8 chart) (Cartesian) | Stacked | 1-5, 7-9 (06 atlanır) | Stacked Cartesian |
| Range Column (Cartesian) | Range Column | 1-4, 7-9 (05, 06 atlanır) | Range Column |
| Waterfall (Cartesian) | Waterfall | 1-5, 7-9 (06 atlanır) | Waterfall |
| Pie / Doughnut / Radial Bar (Circular) | Circular | 1-5, 7-9 (06 atlanır) | Circular Adımları |
| Radial Gauge (Gauge) | Radial Gauge | 1-4, 8-9 (05, 06, 07 atlanır) | Radial Gauge |
| Linear Gauge (Gauge) | Linear Gauge | 1-4, 8-9 (05, 06, 07 atlanır) | Linear Gauge |
| Static Text (Text) | Static Text | 1-2, 7-9 (03, 04, 05, 06 atlanır) | Static Text |
| Dynamic Text (Text) | Dynamic Text | 1-4, 7-9 (05, 06 atlanır) | Dynamic Text |
| Table (DataGrid) | DataGrid | 1-3, 7-9 (04, 05, 06 atlanır) | DataGrid Adımları |
| Two-Column List (Other) | Other | 1-4, 7-9 (05, 06 atlanır) | Two-Column List Adımları |
Funnel & Pyramid
Funnel ve Pyramid grupları arayüzde görünür ancak henüz aktif değildir. Seçilirse "This chart type is not available yet" uyarısı gelir.
2. Sub-Flow ve Bireysel Chart Sayfaları
İki farklı yerden bilgiye erişebilirsiniz:
| Hedef | Sayfa Tipi | Ne Bulursunuz |
|---|---|---|
| Yeni widget oluşturuyorum | Sub-flow'un index.md ve numaralı adım sayfaları |
1-9 sıhirbaz adımlarının uçtan uca anlatımı |
| Belirli bir chart için detay arıyorum | Bireysel chart sayfası (örn. Line, Pie) | Kullanım senaryoları, veri yapısı, chart-özel ayarlar + chart-özel 9-adım özeti |
Bireysel chart sayfaları chart-özel 9-adım özet tablosu içerir; tablodan ilgili sub-flow adım sayfasına link verir.
3. Sihirbaz Davranışı
- Adım atlama: Bir adımı tamamlamadan ileri rotaya gitmeye çalışırsanız sihirbaz sizi en yakın eksik adıma geri yönlendirir.
- Geri butonu: Her adımın sol üst köşesinde bulunur; bir önceki adıma döner. Geri dönüş, doldurduğunuz alanları silmez.
- Sıfırlama: Sihirbazdan çıkıp tekrar girerseniz
CartographyInsertFlowStatesıfırlanır ve baştan başlamış olursunuz. - Kaydetme: Widget yalnızca 9. Görüntüleme Bilgileri adımındaki Save butonuyla kalıcı olur. Bundan önce hiçbir adım otomatik kayıt yapmaz.
Sihirbazı Hızlandırma
Compass'ta anlamlı tag'ler ve açıklayıcı kayıt adları kullanırsanız 3. adımda doğru kaydı çok daha hızlı bulursunuz. Ayrıca aynı kayıttan farklı chart'lar üretmeniz gerekiyorsa, ilk widget'ı bitirdikten sonra Düzenleme ile aynı şablonu çoğaltıp ufak değişiklikler yapmak daha hızlıdır.
4. Sonraki Adım
Hangi chart'ı oluşturacağınıza karar verdiyseniz, ilgili sub-flow'un Adım 1'inden başlayın. Karar veremiyorsanız önce Cartography Genel Bakış sayfasındaki "Desteklenen Chart Grupları" tablosuna göz atın.