3. Compass Kaydı Seçimi — Radial Gauge

Bu adımda Radial Gauge widget'ın çalışacağı Compass kaydı seçilir. Kaydınız tek satır, tek sayısal değer döndürmelidir; gauge bu değeri ibreyle gösterir.

Sihirbaz rotası: /cartography/add/selectcompass

Ön Koşul

(Gauge) ve 2. (Radial Gauge) adımlar tamamlanmış olmalıdır.

→ 02 — Chart Tipi Seçimi

1. Compass Kayıt Listesi

2. Radial Gauge'a Uygun Kayıt Yapısı

-- Anlık OEE
SELECT ROUND(oee_yuzde, 1) AS oee
FROM oee_hesap
ORDER BY ts DESC
LIMIT 1;

-- Anlık fırın sıcaklığı (MQTT/TimescaleDB)
SELECT sicaklik
FROM sensor_log
WHERE makine_id = 1
ORDER BY ts DESC
LIMIT 1;

Kolon	Adım 4'teki rol	Tip
Tek sayısal kolon	Value Source	NUMERIC

Tek Satır Şart

Sorgu birden fazla satır dönerse gauge yalnızca ilk satırı kullanır. ORDER BY ts DESC LIMIT 1 ile garanti altına alın.

MQTT için Gauge

MQTT topic'i her güncellemede tek değer push'ladığı için Radial Gauge için ideal veri kaynağıdır. Compass'ta MQTT kaydını seçin; gauge canlı akar.

3. Radial Gauge'a Uygun Veri Kaynakları

Veri Kaynağı	Radial Gauge'a Uygunluk	Notlar
MQTT (canlı)	✅ İdeal	Tek mesajda tek değer; gauge canlı
PostgreSQL / MSSQL / MySQL	✅ Uygun	`LIMIT 1` ile en güncel değer
REST API	✅ Uygun	API tek nesne / tek değer dönmeli
Excel Offline	⚠️ Sınırlı	Sheet'ten tek hücre okuma; canlı değil

4. Kayıt Arama ve Tag Filtresi

Aksiyon	Etki
Arama kutusu	Anlık filtre
Tag filtresi	Sadece kullanılan tag'ler
Clear	Filtreleri temizle

Gauge Tag'i

Gauge sorguları için Compass'ta gauge, kpi, anlık 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.

6. Excel Offline Sheet Seçimi

Excel kaydında ek olarak Sheet dropdown'ı belirir.

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
Gauge'da değer 0	Kayıt boş satır dönüyor	Kayıdı Compass'ta test edin
Birden çok değer	`LIMIT 1` eksik	SQL'e `LIMIT 1` ekleyin
Adım 4'te Value Source dropdown'u boş	Sayısal kolon yok	`ROUND`, `CAST(... AS NUMERIC)` ile sayısal kolon dönün

9. Sonraki Adım

→ 04 — Radial Gauge Axis Design