HTML Rapor

HTML rapor, sayfayı kendiniz yazdığınız rapor ailesidir. Pivot rapor tabloyu yapılandırarak kurar; burada düzeni, biçimi ve hesabın nasıl görüneceğini siz belirlersiniz.

İki yarım

Rapor bilinçli olarak ikiye ayrılmıştır ve ayrımın kendisi anlamlıdır:

Yarım	Nerede çalışır	Ne yapar
Datasource	Sunucuda	Veriyi hazırlar ve döndürür
HTML · CSS · JS	Tarayıcıda	Yalnızca sunum; veriyi hazır alır

Datasource bir script’tir ve platformun ins API’sine erişir. Sayfanın kendisi uygulamaya geri çağrı yapmaz — belge render edilmeye başladığında veri zaten içine gömülmüştür.

Sayfadan API çağrısı yapılamaz, ve bu bir eksiklik değil

Custom HTML sayfalarında tarayıcıdan veri okuyabilirsiniz; HTML raporda okuyamazsınız. Sebebi şu: raporu basan tarayıcının kendi kimliği yoktur ve ağ erişimi kapalıdır; eline hazır bir belge verilir.

Alternatifi — sayfanın render sırasında kendi verisini çekmesi — uygulamaya kimlik doğrulamalı bir kanal, bir servis hesabı, bir anahtar ve o anahtarın satır erişimine bağlanması demekti. Hiçbiri gerekmiyor, çünkü veri zaten çekildi: sunucuda, işlemi tetikleyen kişinin yetkisiyle.

Veri hangi yetkiyle çekilir

Datasource, ins API’sine render’ı tetikleyen kimin yetkisiyle erişir: önizlemeye bakan kişinin, ya da zamanlanmış koşumda space’in otomasyon kimliğinin. Raporu yazanın veya sahibinin yetkisiyle değil.

Pratik sonucu, adresli gönderimde görülür: farklı satır erişimine sahip alıcılar için rapor ayrı ayrı üretilir, dolayısıyla herkes kendi görebildiği veriyi alır.

Datasource script’i

Script’e dört değer hazır gelir:

Bağ	Tipi	Açıklama
startDate · endDate	Epoch milisaniye	Raporun kapsadığı aralık
isAuto	Boolean	Zamanlanmış koşumda true, elle çalıştırmada false
lang	Metin	Rapor için seçilen dil; verilmemişse boş

Döndürdüğünüz değer istediğiniz şekilde olabilir — aşağısı onu incelemez, olduğu gibi sayfaya taşır.

// Datasource: dilimin saatlik ortalamalarını hazırla
var rows = ins.getLoggedHourlyVariableValueStats(
    ['Temperature_C'], ins.getDate(startDate), ins.getDate(endDate));
return { baslik: 'Sıcaklık özeti', otomatik: isAuto, satirlar: rows };

Script sunucu tarafında çalışır; dolayısıyla script motorunun kuralları burada da geçerlidir — sözdizimi, sınırlar ve ins.* imzaları dahil.

Veri sayfaya nasıl ulaşır

Datasource’un döndürdüğü değer belgeye window.__reportData olarak gömülür. Sayfanın JavaScript’i onu doğrudan okur:

var d = window.__reportData;
document.getElementById('baslik').textContent = d.baslik;

Alanlar ve zamanlama

Alan	Açıklama
Name · Description	Ad ve açıklama
HTML · CSS · JS	Sunum; her biri en çok 1 MB
Datasource	Veri script’i
Period · Report time	Pivot rapordaki ile aynı — Hourly, Monthly, Minutes
Print · Mail	Yazdırma ve e-posta için ayrı gün/saat, tek tek açılıp kapanır

Zamanlama, yazdırma, e-posta ve çıktı biçimleri pivot raporla aynı çalışır; alıcıların raporun kendi Mail To alanından geldiği kuralı da öyle. Ayrıntı: Pivot Rapor.

Çıktı HTML ve PDF’tir; PDF sunucudaki başsız tarayıcıyla basılır.

İlgili

• HTML Rapor Editörü — bu raporu yazdığınız ekran
• Pivot Rapor — yapılandırarak kurulan diğer aile
• Script Engine — datasource’un uyduğu kurallar