3. Compass Kaydı Seçimi — Waterfall
Bu adımda Waterfall widget'ının çalışacağı Compass kaydı seçilir. Kayıt sıralı bir delta serisi döndürmelidir: kategori (X) ve delta değer (Y).
Sihirbaz rotası: /cartography/add/selectcompass
1. Compass Kayıt Listesi
2. Waterfall'a Uygun Kayıt Yapısı
-- Çeyrek kar/zarar akışı (kategori bazlı delta)
SELECT kategori, delta, sira
FROM (
VALUES
('Açılış', 1000, 1),
('Q1 Satış', 250, 2),
('Q1 Maliyet', -120, 3),
('Q2 Satış', 300, 4),
('Q2 Kayıp', -80, 5),
('Toplam', 1350, 6)
) AS t(kategori, delta, sira)
ORDER BY sira;
| Kolon | Adım 4'teki rol | Tip |
|---|---|---|
kategori |
X Axis Column (CategoryAxis) | TEXT |
delta |
Y Axis Column (NumericAxis) | NUMERIC |
Sıra Kolonu
Waterfall sırası kritiktir. Sorgunuzun deterministik sıra döndürdüğünden emin olun. SQL'de ORDER BY sira_no veya UNION ALL kullanın; aksi halde her refresh'te kategoriler farklı sırada gelir ve grafik anlamsızlaşır.
Total Kategorisini Seçenek Yapın
Son satırı 'Toplam' adıyla yazın ve Adım 5'te Treat Last Point As Total = On seçeneğini açın. Total çubuğu özel renkle gösterilir (Total Sum Color).
3. Waterfall'a Uygun Veri Kaynakları
| Veri Kaynağı | Waterfall'a Uygunluk | Notlar |
|---|---|---|
| PostgreSQL / MSSQL / MySQL | ✅ İdeal | Aggregate + sıralı union ile pratik |
| REST API | ✅ Uygun | API sıralı array dönmeli |
| MQTT | ❌ Uygun değil | Tek snapshot waterfall sergileyemez |
| Excel Offline | ✅ Uygun | Sheet'te sıralı satırlar olmalı |
4. Kayıt Arama ve Tag Filtresi
| Aksiyon | Etki |
|---|---|
| Arama kutusu | Anlık filtre |
| Tag filtresi | Sadece kullanılan tag'ler |
| Clear | Filtreleri temizle |
Waterfall Tag'i
Waterfall sorgular için Compass'ta waterfall, pnl, delta tag'leri kullanın.
5. Kaydı Onaylayın
Bir kayda tıklandığında satır vurgulanır. Sağ üstteki Next butonuyla ilerleyin.
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ında ek olarak Sheet dropdown'ı belirir.
| Adım | Açıklama |
|---|---|
| 1 | Excel kaydını seçin |
| 2 | Açılan sheet listesinden bir sheet adı seçin |
| 3 | 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 |
|---|---|---|
| Çubuklar farklı sırada gelir | ORDER BY eksik |
Sorguya ORDER BY sira_no ekleyin |
| Total çubuğu görünmez | Kategori adı 'Toplam' ama setting kapalı |
Adım 5'te Treat Last Point As Total = On |
| Negatif değer pozitif renkte | Sorgu mutlak değer dönüyor | Negatif değerleri olduğu gibi (negatif) bırakın |