Compass

Compass, Pirivision'da veri kaynaklarına bağlı Compass kayıtları (sorgu, MQTT topic, REST endpoint, Excel sheet) oluşturulan ve yönetilen modüldür.

Port modülünde eklenen bir veri kaynağı (PostgreSQL, MSSQL, MySQL, MQTT, REST API veya Excel) Compass üzerinden anlamlı bir veri tanımına dönüştürülür. Kaydedilen Compass kayıtları, Cartography modülünde chart / KPI widget'ına dönüştürülür.

flowchart LR
    A[Port<br/>Veri Kaynağı] --> B[Compass<br/>Kaydı]
    B --> C[Cartography<br/>Chart / KPI]
    C --> D[Horizon<br/>Sayfa / Board]
    D --> E[Atlas<br/>Dashboard]

Terminoloji

Pirivision'da farklı veri kaynakları farklı tarzda Compass kayıtları üretir:

SQL (PostgreSQL / MSSQL / MySQL) → Sorgu (yazılan SQL kodu)
MQTT → Topic Seçimi (broker'daki topic'in path'i)
REST API → Endpoint Tanımı (HTTP path + metot + parametreler)
Excel → Sheet Seçimi (yüklü dosyadaki çalışma sayfası)

Hepsi aynı listede görünür ve aynı şekilde Cartography'ye beslenir; sadece tanımlama tarzları farklıdır.

Compass Kayıt Tipleri

Tip	Veri Kaynağı	Tanımlama Tarzı	Kayıt Eylemi
SQL	PostgreSQL, MSSQL, MySQL	Standart SQL / T-SQL kodu	Save Query
MQTT	MQTT Broker	Topic path seçimi (`fabrika/hat1/sicaklik`)	Save
REST API	REST API	HTTP method + path + parametreler	Save
Excel	Excel Offline	Sheet seçimi + önizleme	Save

Compass'ta Yapılabilecekler

İşlem	Veri Kaynağı	Açıklama
SQL Sorgusu Yazma	PostgreSQL, MSSQL, MySQL	SELECT, JOIN, WHERE, GROUP BY ile veri filtreleme ve dönüştürme
MQTT Topic Seçimi	MQTT	Gerçek zamanlı sensör verisi için topic kayıt ve izleme
REST Endpoint Tanımlama	REST API	HTTP GET/POST endpoint'lerini tanımlama
Excel Sheet Seçimi	Excel Offline	Yüklü dosyanın belirli sheet'ini Compass kaydı olarak tanımlama
Global Değişkenler / Parametreler	SQL · REST	Tanımlamalarda `{{param}}` sözdizimli parametre kullanma — datepicker, dropdown, textbox tipleri
Test Etme	Tümü	Kaydetmeden önce dönen veriyi önizleme
Klasör Organizasyonu	Tümü	Compass kayıtlarını klasörlerle gruplama

Compass Oluşturma Rehberleri

Tip	Oluşturma	Düzenleme
SQL	PostgreSQL Sorgu Oluşturma · MSSQL Sorgu Oluşturma · MySQL Sorgu Oluşturma	PostgreSQL Sorgu Düzenleme · MSSQL Sorgu Düzenleme · MySQL Sorgu Düzenleme
MQTT	MQTT Topic Seçimi	MQTT Topic Düzenleme
REST API	REST Endpoint Tanımlama	REST Endpoint Düzenleme
Excel	Excel Sheet Seçimi	Excel Sheet Düzenleme

Parametreler (Tüm Tipler İçin Ortak)

SQL sorgularında, REST endpoint'lerinde ve query parameter / header alanlarında {{parametre_adi}} sözdizimiyle dinamik değer kullanılabilir. Sözdizimi, parametre tipleri (Textbox / Datepicker / Dropdown), varsayılan değerler ve dialekt-özel davranışlar (PostgreSQL $1, MySQL ?, MSSQL @name) için ayrıntılı rehber:

→ Compass Parametreleri — Detaylı Rehber

Global Variables ile Fark

Compass Parametreleri ({{param}}), sorgu çalıştırıldığında kullanıcının anlık girdiği değerlerdir (tarih aralığı, dropdown seçimi vb.). Global Variables (${değişken}) ise Settings'den önceden tanımlanan kullanıcı bazlı sabitlerdir; her sorguda otomatik yerine geçer.

→ Features — Global Variables

Yapay Zeka ile SQL Yazma

SQL tipi Compass kayıtlarında (PostgreSQL, MSSQL, MySQL), sorgu editörü üzerindeki Yapay Zeka ile Yaz butonu Makinist asistanını açar. Doğal dilde isteğinizi yazın, çalıştırılabilir SQL geri gelsin; tek tıkla editöre aktarın.

→ Makinist — SQL Asistanı

Compass Yönetimi

İşlem	Açıklama
Taşıma	Compass kaydını veya klasörü farklı konuma taşıma
Çoğaltma	Mevcut kaydı aynı ayarlarla kopyalama
Silme	Kullanılmayan kaydı kaldırma

Önerilen Başlangıç

Compass'ı kullanmadan önce Port modülünde en az bir veri kaynağı eklenmiş olmalıdır.

→ Port — Veri Kaynağı Ekleme

Sonraki Adım

Compass'ta kayıt oluşturulduktan sonra Cartography modülünde chart / KPI oluşturulur.

→ Cartography