Datentabelle

Ca. 6 Min. Lesezeit

TwDataTable · Kategorie: Diagramme

Einstellungen

Diese Einstellungen finden Sie bei ausgewähltem Widget rechts im Eigenschaftenbereich, meist im Abschnitt Datentabellen-Einstellungen. Der Standardwert ist der Wert, den das Widget beim ersten Einfügen in eine Seite hat.

Datenquelle

Einstellung	Typ	Standardwert	Beschreibung
Datenquellenmodus dataSourceMode	Auswahl	consumptionPivot	Verbrauchspivot: Verbrauch (Differenzsumme) je Periode. Historienpivot: aggregierter Historienwert je Periode. Live-Tags: eine Zeile je Tag mit aktuellen Werten. Statisch: manuell erstellte Zeilen und Spalten. Optionen: consumptionPivot Verbrauchspivot, historyPivot Historienpivot, liveTags Live-Tags, static Statische Tabelle
Tag-Quellen seriesConfigJson	Reihenkonfiguration	[]	Wählen Sie die Tags der Tabelle. In Pivotmodi wird jedes Tag eine Spalte (transponiert eine Zeile); im Live-Tag-Modus ist jedes Tag eine Zeile. Höchstens 50 Quellen.
Live-Tag-Spalten liveTagFields	Text	name,value,unit,timestamp	Kommagetrennte Spaltenliste: name, tagName, description, value, unit, quality, timestamp. Nur im Live-Tag-Modus.
Statische Zeilen (JSON) staticRowsJson	Code	[]	Zeilenliste für den statischen Modus (JSON-Array). Jede Zeile enthält Werte je Spaltenschlüssel. Eine Zelle ist Text/Zahl oder ein Objekt mit type und value: type text, tag (Tagwert) oder expression (Ausdruck). Höchstens 200 Zeilen.

Zeitraum und Intervalle

Einstellung	Typ	Standardwert	Beschreibung
Zeitquelle timeSource	Eigener Editor	local	Lokal: Die Tabelle nutzt ihre eigenen Zeitraumeinstellungen. Seitenzeit: Verbrauchs- und Verlaufspivots folgen der Seitenzeitauswahl; Live- und statische Tabellen sind nicht betroffen.
Intervall bucketUnit	Auswahl	month	Zeitintervall der Pivotzeilen (Stunde, Tag, Woche, Monat, Quartal, Jahr). Automatisch wählt nach Zeitraumlänge. Wochen (ab Montag) und Quartale sind kalenderbasiert; sie werden als Tage bzw. Monate geladen und in der Tabelle zusammengefasst. Optionen: hour Stündlich, day Täglich, week Wöchentlich, month Monatlich, quarter Vierteljährlich, year Jährlich, auto Automatisch
Am Kalender ausrichten alignToCalendar	Kontrollkästchen	Ein	Wenn aktiv, beginnen Intervalle an Kalendergrenzen (z. B. Monatserster). Sonst ab der ersten Messung.
Zeitraumtyp rangeMode	Auswahl	calendar	Kalender: aktueller oder vorheriger Tag, Woche, Monat, Quartal oder Jahr. Relativ: letzte N Minuten mit Voreinstellungen. Optionen: calendar Kalender, relative Relativ
Periodenversatz calendarOffset	Zahl	0	0 ist die aktuelle Periode, -1 die vorherige. Minimum -120.
Zeitraum-Voreinstellungen rangePresetsJson	Mehrzeiliger Text	[ { "label": "1h", "minutes": 60, "enabled": true }, { "label": "6h", "minutes": 360, "enabled": true }, { "label": "24h", "minutes": 1440, "enabled": true } ]	Voreinstellungsschaltflächen in der Werkzeugleiste im relativen Modus.
Werkzeugleiste anzeigen showToolbar	Kontrollkästchen	Ein	Zeigt in Pivotmodi Schaltflächen für vorherige/nächste Periode, aktuellen Zeitraum und Aktualisieren.
Aggregation sampleValueType	Auswahl	2	Im Historienpivot je Intervall berechneter Wert: Minimum, Maximum, Durchschnitt, Summe oder Anzahl. Wochen- und Quartalsintervalle fassen die Tages- bzw. Monatswerte zusammen (der Durchschnitt ist das Mittel dieser Durchschnitte). Optionen: 0 Minimum, 1 Maximum, 2 Durchschnitt, 3 Summe, 4 Anzahl
Leere Intervalle anzeigen fillEmptyBuckets	Kontrollkästchen	Ein	Fügt leere Zeilen für Intervalle ohne Daten hinzu, damit z. B. alle 12 Monate erscheinen. Nur die neuesten Intervalle innerhalb des Zeilenlimits werden ergänzt.
Kalenderperiode calendarPeriod	Auswahl	year	Im Kalendermodus angezeigte Periode. Wochen beginnen am Montag. Optionen: day Tag, week Woche, month Monat, quarter Quartal, year Jahr
Relativer Zeitraum (Min.) timeRangeMinutes	Zahl	1440	Minuten ab jetzt rückwärts im relativen Modus.
Automatisch aktualisieren (s) autoRefreshSeconds	Zahl	0	0 ist aus. Sonst Neuladen mindestens alle 30 Sekunden, nur solange der Zeitraum die aktuelle Zeit enthält.

Tabellenlayout

Einstellung	Typ	Standardwert	Beschreibung
Transponieren transpose	Kontrollkästchen	Aus	In Pivotmodi werden Zeilen zu Tags und Spalten zu Intervallen. Höchstens 100 Intervallspalten.
Summenspalte showTotalColumn	Kontrollkästchen	Aus	Fügt eine Spalte hinzu, die die Datenzellen jeder Zeile mit der gewählten Berechnung zusammenfasst.
Summenüberschrift totalColumnHeader	Text	—	Leer zeigt das lokalisierte Summe. Auch ein Übersetzungsschlüssel ist möglich.
Maximale Zeilen maxRows	Zahl	400	Zeilenlimit (1-1000). Nur die neuesten Intervalle werden geladen; enthält der Zeitraum mehr, erscheint ein Hinweis.
Sortieren erlauben allowSorting	Kontrollkästchen	Ein	Sortieren per Klick auf die Spaltenüberschrift. Pro Spalte mit sortable abschaltbar.
Intervallreihenfolge bucketOrder	Auswahl	asc	Anfängliche Reihenfolge: älteste oder neueste zuerst. Optionen: asc Älteste zuerst, desc Neueste zuerst
Summenberechnung totalColumnAggregate	Auswahl	sum	Berechnung der Summenspalte: Summe, Durchschnitt, Minimum oder Maximum. Optionen: sum Summe, avg Durchschnitt, min Minimum, max Maximum
Zeilenüberschrift rowHeaderCaption	Text	—	Überschrift der ersten Spalte. Leer zeigt Periode oder Tag. Auch ein Übersetzungsschlüssel ist möglich.
Seitengröße pageSize	Zahl	0	0 zeigt alle Zeilen als eine scrollbare Liste; Werte über 0 aktivieren das Blättern.

Formatierung und Spalten

Einstellung	Typ	Standardwert	Beschreibung
Dezimalstellen numberDecimals	Zahl	2	Standardanzahl Dezimalstellen numerischer Zellen (0-6). Spalteneinstellungen überschreiben sie.
Einheitenanzeige unitDisplay	Auswahl	header	Einheit in der Spalten-/Zeilenüberschrift, in jeder Zelle oder gar nicht. Optionen: header In der Überschrift, cell In der Zelle, none Ausblenden
Spalteneinstellungen (JSON) columnsJson	Code	[]	Spaltenliste (JSON-Array). Felder: key, header, dataType, decimals, useGrouping, unit, alignment, width, visible, sortable, rules. In Pivotmodi ist key die ID der Tag-Quelle, __rowHeader oder __total. rules enthält bis zu 5 Regeln: op (gt, gte, lt, lte, eq, neq, between), value, value2, tone (success, warning, danger, info, accent, muted). Im statischen Modus definiert sie alle Spalten.
Tausendertrennzeichen useThousandsSeparator	Kontrollkästchen	Ein	Zeigt Zahlen mit dem Tausendertrennzeichen der Sprache.
Text bei leerer Tabelle emptyText	Text	—	Text ohne Daten. Leer verwendet den Standardtext.

Zusammenfassungen und Export

Einstellung	Typ	Standardwert	Beschreibung
Zusammenfassungszeilen summariesJson	Eigener Editor	[]	Zeilen unter der Tabelle. Aktivieren Sie eine Berechnung, um ihre Zeile hinzuzufügen. Bleibt die Spaltenliste leer, werden alle numerischen Spalten verwendet; sonst wählen Sie die Spalten aus. Werte werden aus den ungerundeten Daten berechnet und nutzen das Zahlenformat der Spalte. Anteil % zeigt die Summe jeder Spalte als Prozentsatz der summierten Spalten; die Summenspalte gehört nicht zu dieser Basis. Erster und Letzter folgen der eingestellten Zeilenreihenfolge.
Betrachter wählt Zusammenfassungen allowRuntimeSummaryPick	Kontrollkästchen	Aus	Fügt der Symbolleiste ein Σ-Menü hinzu, mit dem Betrachter Zusammenfassungszeilen ein- und ausblenden. Die Auswahl gilt bis zum Neuladen der Seite und wird nicht gespeichert.
Export-Dateiname exportFileName	Text	—	Dateinamensvorlage ohne Endung. Platzhalter: [title] Widget-Titel, [page] Seitentitel, [start] und [end] Bereichsdaten, [range] Bereichsbezeichnung, [date] Exportdatum. Leer verwendet [title]_[start]_[end] bei Zeitbereichen, sonst [title]_[date]. In Dateinamen unzulässige Zeichen werden ersetzt und .xlsx wird angehängt.
Excel-Export-Schaltfläche exportEnabled	Kontrollkästchen	Aus	Zeigt eine Excel-Schaltfläche in der Symbolleiste. Exportiert die sichtbaren Spalten in der aktuellen Sortierung mit Zahlenformaten, Einheiten und Zusammenfassungszeilen. Im Editor werden die Vorschaudaten exportiert.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Rahmen showBorders	Kontrollkästchen	Ein	Zeigt den äußeren Tabellenrahmen.
Zeilen abwechselnd färben rowAlternation	Kontrollkästchen	Ein	Färbt Zeilen zur besseren Lesbarkeit abwechselnd.
Spaltenlinien showColumnLines	Kontrollkästchen	Ein	Zeigt senkrechte Linien zwischen Spalten.

Weitere Einstellungen

Einstellung	Typ	Standardwert	Beschreibung
Enable Flashing enableFlashing	Kontrollkästchen	Aus	Lässt das Widget blinken (ein Transparenzimpuls pro Sekunde). Wird meist an eine Alarmbedingung gebunden.
Log Button logButton	Kontrollkästchen	Aus	Zeigt zur Laufzeit beim Überfahren des Widgets ein Diagrammsymbol; ein Klick fügt die an das Widget gebundenen Tags der Log-Tag-Liste hinzu.

Bindungen

Im Abschnitt Bindungen (Regeln) des Eigenschaftenbereichs kann ein Tag mit einer Direct-Bindung an die folgenden Eigenschaften dieses Widgets gebunden werden. Die Bindungstypen (Direct, IntRange, FloatRange, Boolean, Bit) sind für alle Widgets gleich; sie werden auf der Seite Widget-Referenz beschrieben.

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

Gemeinsame Abschnitte

Bei ausgewähltem Widget zeigt der Eigenschaftenbereich außerdem diese gemeinsamen Abschnitte: Allgemein, Layout, Aussehen, Bindungen (Regeln). Diese Abschnitte werden auf der Seite Seiteneditor beschrieben.