3. Compass Kaydı Seçimi — Standart Cartesian
Bu adımda standart Cartesian widget'ının çalışacağı Compass kaydı seçilir. Cartesian akışı için kayıt en az iki kolon (X ekseni + Y değer) döndürmelidir; çoklu seri kullanılacaksa kolonlar 6. adımda mapping yapılarak kullanılacaktır.
Sihirbaz rotası: /cartography/add/selectcompass
Ön Koşul
- (Cartesian) ve 2. (Line/Area/Spline/Column/Bar/Step Line) adımlar tamamlanmış olmalıdır. Compass'ta kayıtlı en az bir öğe bulunmalıdır.
Compass'ta hiç kayıt yoksa: → Compass
1. Compass Kayıt Listesi Yüklenir
Adıma girdiğinizde Compass kayıt listesi otomatik yüklenir. Liste şu sütunları içerir:
| Sütun | Açıklama |
|---|---|
| Name | Compass kaydı adı |
| Description | Kaydın açıklaması |
| Datasource | Bağlı veri kaynağı tipi (SQL / MQTT / REST / Excel) |
| Tags | Kayda atanmış tag'ler |
2. Standart Cartesian'a Uygun Veri Kaynakları
Standart Cartesian için tüm Compass kayıt türleri kullanılabilir; ancak her birinin avantajları farklıdır.
| Veri Kaynağı | Standart Cartesian'a Uygunluk | Notlar |
|---|---|---|
| PostgreSQL / MSSQL / MySQL (SQL) | ✅ İdeal | GROUP BY + ORDER BY ile sıralı X ekseni hazırlanır |
| REST API | ✅ Uygun | JSON yanıt array kolonlarına çevrilir |
| MQTT | ⚠️ Sınırlı | Anlık snapshot tek satır döner; trend için TimescaleDB tercih edilir |
| Excel Offline | ✅ Uygun | Sheet ilk satırı header alınır; Sheet ek dropdown'ı 5. alt-adımda gelir |
X Ekseninde Sıralama
Sorgunuz X ekseni kolonunu sıralı döndürmelidir. SQL'de ORDER BY ts ASC, REST'te API'den dönen array sırası, Excel'de sheet'teki satır sırası kullanılır. Aksi halde Line/Area/Spline'larda çizgi geri-ileri zigzag çizer.
Y Kolonu Sayısal Olmalı
Standart Cartesian Y eksenine yalnızca sayısal kolon bağlanabilir. SQL tarafında value::NUMERIC cast'i veya CAST(value AS DECIMAL) ekleyin. REST yanıtında string sayılar dönüyorsa Compass kayıtının post-processing aşamasında Number'a çevirin.
3. Kayıt Arama
Arama kutusuna yazdığınız metin kayıt adı ve açıklama üzerinde anlık filtre uygular.
Tip
Compass tarafında kayıtlarınızı tesis_hat_tip formatında adlandırırsanız (örn: tesis1_hat3_saatlik_uretim) burada saniyeler içinde bulursunuz.
4. Tag Filtresi
Listenin üst tarafındaki filter ikonuna tıkladığınızda sağdan açılan paneldeki tüm tag'lerden seçim yapabilirsiniz. Sadece Compass kayıtlarında gerçekten kullanılan tag'ler listede görünür — kullanılmayan tag'ler bu listeye gelmez.
| Aksiyon | Etki |
|---|---|
| Bir tag seç | Sadece o tag'i içeren kayıtlar kalır |
| Birden çok tag seç | Hepsini içeren kayıtlar kalır (AND mantığı) |
| Clear | Tüm tag filtrelerini kaldırır |
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". (UI metni "query" diye geçse de seçilen şey herhangi bir Compass kaydı olabilir.)
6. Excel Offline Özel Durumu
Eğer seçtiğiniz kaydın veri kaynağı Excel Offline ise ek olarak sheet seçimi istenir. Kayıt satırı seçildiğinde altında bir 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 |
Sheet Seçilmezse
Excel kaydı seçili olup sheet seçilmezse Next uyarı verir: "Please select an Excel sheet first".
7. Önizleme Çalıştırması
Next butonuna basıldığında widget'ın eksen / kolon mapping'inin doğru kurulabilmesi için kayıt bir kez çalıştırılır ve sonuç bellekte tutulur.
| Veri Kaynağı | İşlem |
|---|---|
| SQL (PostgreSQL/MSSQL/MySQL) | Sorgu doğrudan veritabanında çalışır |
| MQTT | Topic'ten anlık mesaj snapshot'ı alınır |
| REST API | Endpoint'e HTTP isteği yapılır |
| Excel Offline | Sheet okunur ve hücreler array'a dönüştürülür |
Yükleme Sırasında ESC
İşlem uzun sürerse Esc tuşuyla iptal edebilirsiniz. İptal sonrası kayıt seçimine geri dönersiniz.
8. Sık Karşılaşılan Hatalar
| Belirti | Olası Neden | Çözüm |
|---|---|---|
| Kayıt listesi boş | Compass'ta hiç kayıt yok ya da yetkiniz yok | Compass'ta kayıt oluşturun → Compass |
| Aradığım kayıt görünmüyor | Tag filtresi aktif olabilir | Filtre panelinden Clear ile temizleyin |
| Excel'de sheet listesi boş | Dosya bozuk veya boş sheet'lerden oluşuyor | Excel dosyasını Port'ta kontrol edin |
| Next'te uzun süre dönüyor | SQL sorgusu yavaş, REST endpoint yanıt vermiyor | Compass'ta kaydı test edin, gerekirse LIMIT ekleyin |
| Y axis sayısal kolon yok hatası (sonraki adımda) | Sorgu sayısal kolon dönmüyor | SQL'de CAST(value AS NUMERIC) ekleyin |