Sayaç ve metrik verisi beş yoldan dışarı çıkar: sayfaların kendi indirmeleri, Excel raporları (sayaç takip listesi), Raporlar sayfası (tablo, grafik, PDF), erişim anahtarıyla REST ve dış veritabanına yazma. Ayrıca her değer tag olarak yayınlanır (OPC UA, Veri Köprüsü). Bu sayfa hangisinin ne zaman kullanılacağını anlatır.
Hangi yol, ne zaman
| İhtiyaç | Yol |
|---|---|
| Gün gün / ay ay tüketime hızlı bakış | Sayaçlar ve Metrikler › Dönem raporu sekmesi |
| Sayaçları grup grup, son endeks ve farkla gösteren tablo | Sayaçlar ve Metrikler › Excel raporları sekmesi (sayaç takip listesi) |
| Grafikli, PDF'li rapor; duvar ekranı | Eklentiler › Raporlar |
| ERP ya da BI aracı raporu gelip okusun | Rapor için erişim anahtarı (REST, JSON) |
| MergenHub raporu belirli zamanlarda kendisi göndersin | Veri Köprüsü rapor ajanı (REST ya da MQTT) |
| Dönem değerleri SQL ile sorgulansın | Sayaç verisini dış veritabanına yaz |
| SCADA ekranı, alarm, OPC UA istemcisi | _Counters. ve _Metrics. tag'leri |
Sayfaların kendi indirmeleri
Dönem raporu, Su Ayak İzi, Su Verimliliği ve Su Akış Şeması sayfalarında Excel ve CSV düğmeleri vardır. Excel dosyaları çok sayfalı, başlıklı ve sayı biçimlidir (sayılar toplanabilir).
Sayaç takip listesi (gruplu Excel raporu)
Sayaçları grup grup yan yana gösteren dönem tablosudur: en üstte renkli grup başlıkları (ör. ÜRETİM, TÜKETİM, GERİ KAZANIM), her sayacın altında Son endeks ve Fark sütunları, her üst grubun sonunda toplam sütunu, en altta TOPLAM satırı. Tablo dinamiktir: gruba yeni bir sayaç eklediğinizde rapora kendiliğinden girer.
- Sayaçlarınızın grubu doğru olsun; grup ağacı raporun başlık yapısıdır.
- Excel raporları sekmesinde Yeni rapor'a basın. Düzenleyici bütün grupları işaretli açılır; önizleme hemen çizilir.
- İstemediğiniz grubun ya da sayacın işaretini kaldırın; sırayı satırdaki oklarla değiştirin.
- Bir gruba tıklayıp Başlık rengini seçin. Renk grubun rengidir ve bütün raporlarda aynıdır.
- Sütunları seçin: Son endeks, Fark (dönem tüketimi), grup toplamı, son satırda toplam.
- Kaydet.
Rapor açıkken dönem (saat, gün, hafta, ay, yıl), aralık ve tarihler tablonun üstündeki çubuktan seçilir; her dönem için ayrı rapor gerekmez. Excel indir ekrandaki tabloyu birleştirilmiş, renkli üst başlıklarla yazar.
.json) indirilir ve Şablondan ekle ile başka bir sisteme ya da tesise uygulanır; sayaçlar şablonda kimlikle değil kodla yazılır.Raporlar sayfası (rapor tasarımcısı)
Eklentiler › Raporlar, sistemdeki kayıtlardan rapor kurar: canlı değerler, veri kaydı geçmişi, alarm geçmişi, olay ve denetim günlükleri, sayaç ve metrik dönem değerleri.
- Tablo raporu: liste ya da özet tablo (gruplama ve hesap), yan yana sütunlar, grafik; Excel, PDF ve CSV olarak iner.
- Rapor sayfası: görsel düzenleyicide ızgaraya yerleştirilen paneller; anlık kartlar tag ve metrik değerlerini canlı gösterir ve Tam ekran kipinde duvar ekranına yansıtılır.
Erişim anahtarıyla dış sistemden okuma (REST)
Excel raporu dış sisteme yalnız bir erişim anahtarıyla açılır; kullanıcı adı ve parola dış sisteme verilmez.
- Rapor satırındaki fiş simgesine basın; Yeni anahtar bölümünde anahtarın adını yazın (ör. ERP gece aktarımı).
- Kapsam (Yalnız bu rapor önerilir) ve Geçerlilik (30 gün, 90 gün, 1 yıl, süresiz) seçin.
- Anahtar oluştur. Anahtar bir kez gösterilir; hemen kopyalayın. Sunucu yalnız özetini saklar.
- Dış sistem her istekte şu başlığı gönderir:
Authorization: Bearer mhkey_…
GET /config/v1/meteringreports/<rapor kimliği>/run?shape=records&grain=Day&range=Custom&from=2026-01-01&to=2026-01-31
| Kural | Açıklama |
|---|---|
| Yalnız okur | Anahtar raporu okur; başka adrese, ayara ya da yazma işlemine erişemez. |
| HTTPS | İnternetten gelen istek yalnız HTTPS ile kabul edilir; yerel ağdan gelen istek HTTP ile de okunur. |
| İptal | Anahtar pencereden silinince anında geçersiz olur. |
Raporu MergenHub'ın kendisinin göndermesi için Veri Köprüsü'nde rapor ajanı tanımlanır (bkz. Data Bridge).
Sayaç verisini dış veritabanına yazma
Ayarlar › Veri kaynakları'nda adlandırılmış bir veritabanı bağlantısı tanımlayın (MySQL 8+ / MariaDB, SQL Server ya da ODBC), sonra aynı sayfadaki Sayaç verisini dış veritabanına yaz kartını açın.
- Veri kaynağını ve tablo önekini seçin (varsayılan
mh_). Tablolar yoksa kendiliğinden oluşturulur:mh_counter_period,mh_metric_period. - Yazılacak dönemleri işaretleyin: saat, gün, hafta, ay, yıl. İsterseniz dönem metriklerini de yazdırın.
- Yazma aralığını girip kaydedin; ilk tur hemen başlar.
Asıl kayıt MergenHub'ın kendi veritabanında kalır: dış veritabanı bir kopyadır, ona ulaşılamazsa ölçüm kaybolmaz. Yazma tekrarlanabilirdir (aynı dönem güncellenir, çift kayıt oluşmaz); Tümünü yeniden yaz bütün geçmişi yeniden yazar.
-- Bu ayın günlük kuyu üretimi
SELECT period_start, counter_name, total, unit
FROM mh_counter_period
WHERE period_type = 'day' AND category = 'WATER_PRODUCTION'
ORDER BY period_start, counter_name;
Tag, OPC UA ve yapay zekâ
- Her sayaç ve metrik
_Counters.<Kod>ve_Metrics.<Kod>tag'i olarak yayınlanır; OPC UA sunucusunda aynı adlı klasörlerde görünür, Veri Köprüsü ajanlarıyla MQTT ya da REST üzerinden gönderilir. - Yapay zekâ asistanı ve MCP istemcileri sayaçları, metrikleri ve su raporlarını okur: "Geçen ay kuyudan ne kadar su çekildi?", "Geri kazanım oranı hedefin neresinde?".
- Sayaç, metrik, elle girdi tanımları, su profilleri ve raporlar proje paketine girer.
MergenHub