Ana içeriğe geç

3. Compass Kaydı Seçimi — Circular

Bu adımda Circular widget'ın çalışacağı Compass kaydı seçilir. Kaydınız en az iki kolon döndürmelidir: dilim adı (etiket) ve dilim değeri (sayısal).

Sihirbaz rotası: /cartography/add/selectcompass

Ön Koşul

  1. (Circular) ve 2. (Pie/Doughnut/Radial Bar) adımlar tamamlanmış olmalıdır.

02 — Chart Tipi Seçimi


1. Compass Kayıt Listesi

Sorgu seçim ekranı


2. Circular'a Uygun Kayıt Yapısı

-- Vardiya bazlı üretim payı
SELECT
    vardiya         AS dilim_adi,    -- X (etiket)
    SUM(adet)       AS dilim_degeri   -- Y (değer)
FROM uretim_log
WHERE DATE(ts) = CURRENT_DATE
GROUP BY vardiya
ORDER BY dilim_degeri DESC;
Kolon Adım 4'teki rol Tip
dilim_adi X Axis Column (etiket) TEXT
dilim_degeri Y Axis Column (değer) NUMERIC

Sıralama

Pie / Doughnut için dilimleri büyükten küçüğe sıralayın (ORDER BY deger DESC); en büyük dilim genelde "12 saat" konumundan başlar ve görsel hiyerarşi oluşur.

6+ Dilim

Pie'da 6'dan fazla dilim okunabilirliği düşürür. SQL'de top-N + "Diğer" gruplaması yapın:

SELECT
    CASE WHEN urun_kodu IN (top5_subquery) THEN urun_kodu
         ELSE 'Diğer' END AS dilim_adi,
    SUM(adet) AS dilim_degeri
FROM uretim_log
GROUP BY 1;

3. Circular'a Uygun Veri Kaynakları

Veri Kaynağı Circular'a Uygunluk Notlar
PostgreSQL / MSSQL / MySQL ✅ İdeal GROUP BY ile dağılım hazır
REST API ✅ Uygun JSON yanıt label/value array
MQTT ⚠️ Kısıtlı Snapshot tek satır; pay analizi için anlamlı değil
Excel Offline ✅ Uygun Sheet'te etiket + değer kolonları

4. Kayıt Arama ve Tag Filtresi

Aksiyon Etki
Arama kutusu Kayıt adı + açıklama üzerinde anlık filtre
Tag filtresi Filter ikonundan tag seçimi
Clear Filtreleri temizle

Circular Tag'i

Circular sorguları için Compass'ta pay, dagilim, pie tag'leri kullanın.


5. Kaydı Onaylayın

Bir kayda tıklandığında satır vurgulanır. Sağ üstteki Next butonuyla ilerleyin.

Compass kaydı seçili

Kayıt Seçilmeden İlerleme

Hiçbir kayıt seçili değilse Next uyarı verir: "Please select a Compass query first".


6. Excel Offline Sheet Seçimi

Excel kaydı seçildiyse altında Sheet dropdown'ı belirir. Bir sheet seçtikten sonra Next.


7. Önizleme Çalıştırması

Next butonuna basıldığında kayıt çalıştırılır ve sonuç bellekte tutulur.


8. Sık Karşılaşılan Hatalar

Belirti Olası Neden Çözüm
Tek dilim görünüyor Sorgu tek satır dönüyor GROUP BY ile aggregate edin
Y kolonu sayısal değil SUM/COUNT eksik Numeric kolon ekleyin
Çok fazla dilim (12+) Yüksek kategori sayısı Top-N + "Diğer" grupla

9. Sonraki Adım

04 — Axis Configuration