Veri tablosu

Yaklaşık 6 dk okuma

TwDataTable · Kategori: Trend Grafikleri

Ayarlar

Bu ayarlar widget seçiliyken sağ özellikler panelinde, çoğunlukla Veri Tablosu Ayarları bölümünde yer alır. Varsayılan değer, widget sayfaya ilk eklendiğindeki değerdir.

Veri kaynağı

Ayar	Tip	Varsayılan	Açıklama
Veri kaynağı modu dataSourceMode	Seçim	consumptionPivot	Tüketim pivotu: dönem başına tüketim farkı toplamı. Geçmiş pivotu: dönem başına toplanmış geçmiş değeri. Canlı taglar: tag başına bir satır, anlık değerler. Statik: elle yazılan satır ve sütunlar. Seçenekler: consumptionPivot Tüketim pivotu, historyPivot Geçmiş pivotu, liveTags Canlı taglar, static Statik tablo
Tag kaynakları seriesConfigJson	Seri yapılandırması	[]	Tabloya gelen tagları seçin. Pivot modlarında her tag bir sütun (veya transpoze edilince satır) olur; canlı tag modunda her tag bir satırdır. En fazla 50 kaynak.
Canlı tag sütunları liveTagFields	Metin	name,value,unit,timestamp	Virgülle ayrılmış sütun listesi: name, tagName, description, value, unit, quality, timestamp. Yalnız canlı tag modunda kullanılır.
Statik satırlar (JSON) staticRowsJson	Kod	[]	Statik modda satır listesi (JSON dizi). Her satır sütun anahtarlarına göre değer tutar. Hücre düz metin/sayı olabilir ya da type ve value alanlı bir nesne: type text, tag (tag değeri) veya expression (ifade). En fazla 200 satır.

Zaman aralığı ve periyot

Ayar	Tip	Varsayılan	Açıklama
Zaman kaynağı timeSource	Özel düzenleyici	local	Yerel: tablo kendi aralık ayarlarını kullanır. Sayfa zamanı: tüketim ve geçmiş pivotları sayfa zaman seçicisini izler; canlı ve statik tablolar etkilenmez.
Periyot bucketUnit	Seçim	month	Pivot satırlarının zaman periyodu (saat, gün, hafta, ay, çeyrek, yıl). Otomatik, aralık uzunluğuna göre seçer. Hafta (pazartesi başlangıçlı) ve çeyrek takvime hizalıdır; gün ve ay olarak yüklenip tabloda birleştirilir. Seçenekler: hour Saatlik, day Günlük, week Haftalık, month Aylık, quarter Çeyreklik, year Yıllık, auto Otomatik
Takvime hizala alignToCalendar	Onay kutusu	Açık	Açıkken periyotlar takvim sınırlarında başlar (ör. ayın 1i). Kapalıyken ilk ölçümden itibaren sayılır.
Aralık türü rangeMode	Seçim	calendar	Takvim: içinde bulunulan veya önceki gün, hafta, ay, çeyrek ya da yıl. Göreli: son N dakika ve hazır aralıklar. Seçenekler: calendar Takvim, relative Göreli
Periyot kaydırma calendarOffset	Sayı	0	0 içinde bulunulan periyot, -1 bir önceki periyot. En az -120.
Hazır aralıklar rangePresetsJson	Çok satırlı metin	[ { "label": "1h", "minutes": 60, "enabled": true }, { "label": "6h", "minutes": 360, "enabled": true }, { "label": "24h", "minutes": 1440, "enabled": true } ]	Göreli aralık türünde araç çubuğunda gösterilen hazır aralık düğmeleri.
Araç çubuğunu göster showToolbar	Onay kutusu	Açık	Pivot modlarında önceki/sonraki periyot, güncel aralık ve yenile düğmelerini gösterir.
Toplama türü sampleValueType	Seçim	2	Geçmiş pivotunda periyot başına hesaplanan değer: minimum, maksimum, ortalama, toplam veya adet. Haftalık ve çeyreklik periyotlar günlük veya aylık değerleri birleştirir (ortalama, bu ortalamaların ortalamasıdır). Seçenekler: 0 Minimum, 1 Maksimum, 2 Ortalama, 3 Toplam, 4 Adet
Boş periyotları göster fillEmptyBuckets	Onay kutusu	Açık	Verisi olmayan periyotlar için boş satır ekler; örneğin yıllık tabloda 12 ayın tümü görünür. Yalnız satır sınırına sığan en yeni periyotlar doldurulur.
Takvim periyodu calendarPeriod	Seçim	year	Takvim aralık türünde gösterilen periyot. Hafta pazartesi başlar. Seçenekler: day Gün, week Hafta, month Ay, quarter Çeyrek, year Yıl
Göreli aralık (dk) timeRangeMinutes	Sayı	1440	Göreli aralık türünde şimdiye kadar geriye bakılan dakika sayısı.
Otomatik yenileme (sn) autoRefreshSeconds	Sayı	0	0 kapalı. Aksi halde en az 30 saniyede bir, yalnız aralık şimdiki zamanı içerirken veriyi yeniden yükler.

Tablo düzeni

Ayar	Tip	Varsayılan	Açıklama
Satır/sütun çevir transpose	Onay kutusu	Kapalı	Pivot modlarında satırlar taglar, sütunlar periyotlar olur. En fazla 100 periyot sütunu gösterilir.
Toplam sütunu showTotalColumn	Onay kutusu	Kapalı	Her satırın veri hücrelerini seçilen hesaplama ile birleştiren bir sütun ekler.
Toplam başlığı totalColumnHeader	Metin	—	Boş bırakılırsa dile göre Toplam yazılır. Çeviri anahtarı da girilebilir.
En fazla satır maxRows	Sayı	400	Gösterilen satır sınırı (1-1000). Yalnız en yeni periyotlar yüklenir; aralıkta daha fazlası varsa tablo altında not çıkar.
Sıralamaya izin ver allowSorting	Onay kutusu	Açık	Kullanıcı sütun başlığına tıklayarak sıralayabilir. Sütun bazında sortable ile kapatılabilir.
Periyot sırası bucketOrder	Seçim	asc	Periyotların ilk sıralaması: eskiden yeniye veya yeniden eskiye. Seçenekler: asc Eskiden yeniye, desc Yeniden eskiye
Toplam hesabı totalColumnAggregate	Seçim	sum	Toplam sütununda kullanılacak hesap: toplam, ortalama, minimum veya maksimum. Seçenekler: sum Toplam, avg Ortalama, min Minimum, max Maksimum
Satır başlığı rowHeaderCaption	Metin	—	İlk sütunun başlığı. Boşsa Dönem veya Tag yazılır. Çeviri anahtarı da girilebilir.
Sayfa boyutu pageSize	Sayı	0	0 tüm satırları kaydırılabilir tek liste olarak gösterir; 0dan büyükse sayfalama açılır.

Biçimlendirme ve sütunlar

Ayar	Tip	Varsayılan	Açıklama
Ondalık basamak numberDecimals	Sayı	2	Sayısal hücrelerin varsayılan ondalık basamak sayısı (0-6). Sütun ayarı bunu ezer.
Birim gösterimi unitDisplay	Seçim	header	Birim sütun/satır başlığında, her hücrede ya da hiç gösterilmez. Seçenekler: header Başlıkta, cell Hücrede, none Gösterme
Sütun ayarları (JSON) columnsJson	Kod	[]	Sütun listesi (JSON dizi). Alanlar: key, header, dataType, decimals, useGrouping, unit, alignment, width, visible, sortable, rules. Pivotta key tag kaynağının id değeri, __rowHeader veya __total olur. rules en fazla 5 kural: op (gt, gte, lt, lte, eq, neq, between), value, value2, tone (success, warning, danger, info, accent, muted). Statik modda tüm sütunları tanımlar.
Binlik ayırıcı useThousandsSeparator	Onay kutusu	Açık	Sayıları dile uygun binlik ayırıcı ile gösterir.
Boş tablo metni emptyText	Metin	—	Veri yokken gösterilen metin. Boşsa varsayılan metin kullanılır.

Özetler ve dışa aktarma

Ayar	Tip	Varsayılan	Açıklama
Özet satırları summariesJson	Özel düzenleyici	[]	Tablonun altında gösterilen satırlar. Satırını eklemek için bir hesaplamayı işaretleyin. Sütun listesini boş bırakırsanız tüm sayısal sütunlar kullanılır; isterseniz uygulanacağı sütunları seçin. Değerler yuvarlanmamış veriden hesaplanır ve her sütunun sayı biçimini kullanır. Pay % her sütunun toplamını, seçili sütunların toplamına oranla yüzde olarak gösterir; Toplam sütunu bu tabana katılmaz. İlk ve son, ayarlanan satır sırasına göre belirlenir.
İzleyici özet seçebilsin allowRuntimeSummaryPick	Onay kutusu	Kapalı	Araç çubuğuna Σ menüsü ekler; izleyiciler özet satırlarını gösterip gizleyebilir. Seçim sayfa yeniden yüklenene kadar geçerlidir ve kaydedilmez.
Dışa aktarma dosya adı exportFileName	Metin	—	Uzantısız dosya adı şablonu. Yer tutucular: [title] widget başlığı, [page] sayfa başlığı, [start] ve [end] aralık tarihleri, [range] aralık etiketi, [date] dışa aktarma tarihi. Boş bırakılırsa zaman aralıklarında [title]_[start]_[end], diğer durumlarda [title]_[date] kullanılır. Dosya adında izin verilmeyen karakterler değiştirilir ve .xlsx eklenir.
Excel dışa aktarma düğmesi exportEnabled	Onay kutusu	Kapalı	Araç çubuğunda Excel düğmesi gösterir. Görünen sütunları geçerli sıralamayla, sayı biçimleri, birimler ve özet satırlarıyla birlikte dışa aktarır. Editörde önizleme verisini dışa aktarır.

Görünüm

Ayar	Tip	Varsayılan	Açıklama
Kenarlıklar showBorders	Onay kutusu	Açık	Tablonun dış kenarlığını gösterir.
Satır renklerini değiştir rowAlternation	Onay kutusu	Açık	Okunabilirlik için satırları dönüşümlü renklendirir.
Sütun çizgileri showColumnLines	Onay kutusu	Açık	Sütunlar arasında dikey çizgi gösterir.

Diğer ayarlar

Ayar	Tip	Varsayılan	Açıklama
Enable Flashing enableFlashing	Onay kutusu	Kapalı	Bileşeni yanıp söndürür (saniyede bir saydamlık darbesi). Genellikle bir alarm koşuluna bağlanır.
Log Button logButton	Onay kutusu	Kapalı	Çalışma zamanında bileşenin üzerine gelince bir grafik ikonu gösterir; tıklanınca bileşene bağlı Tag'ler log Tag listesine eklenir.

Bağlantılar

Özellikler panelinin İlişkiler (Binding) bölümünde, Direct bağlantıda bir Tag bu widget'ın aşağıdaki özelliklerine bağlanabilir. Bağlantı tipleri (Direct, IntRange, FloatRange, Boolean, Bit) tüm widget'larda aynıdır; açıklamaları Widget Referansı sayfasındadır.

title, visible, authorization, x, y, width, height, rotation, class, foregroundColor, backgroundColor, borderColor, borderStyle, borderWidth, borderRadius, borderTopLeftRadius, borderTopRightRadius, enableFlashing, logButton, tableSchemaVersion, dataSourceMode, seriesConfigJson, bucketUnit, sampleValueType, alignToCalendar, fillEmptyBuckets, bucketOrder, rangeMode, calendarPeriod, calendarOffset, timeRangeMinutes, rangePresetsJson, timeSource, showToolbar, autoRefreshSeconds, maxRows, transpose, showTotalColumn, totalColumnAggregate, totalColumnHeader, rowHeaderCaption, liveTagFields, columnsJson, staticRowsJson, numberDecimals, useThousandsSeparator, unitDisplay, allowSorting, pageSize, showBorders, showColumnLines, rowAlternation, emptyText, summariesJson, allowRuntimeSummaryPick, exportEnabled, exportFileName

Ortak bölümler

Bu widget seçiliyken özellikler panelinde şu ortak bölümler de görünür: Genel, Yerleşim, Görünüm, İlişkiler (Binding). Bu bölümler Sayfa Editörü sayfasında anlatılır.