Widgets an Tags binden
Ein Widget weiß nichts über die Datenbank. Es kennt genau ein Tag — und was dieses Tag zurückgibt, malt es.
Die Bindung überlebt das Umbenennen
Abschnitt betitelt „Die Bindung überlebt das Umbenennen“Gespeichert wird die unveränderliche Kennung des Tags, nie sein Pfad. Benennen Sie
KPI.Availability um, arbeitet das Widget weiter; der aktuelle Pfad wird bei jedem Aufruf neu
aufgelöst und über der Kachel angezeigt.
Was aus einer Ergebniszeile der Wert wird
Abschnitt betitelt „Was aus einer Ergebniszeile der Wert wird“Ein Abfrage-Tag liefert Ergebniszeilen. Daraus liest ein Widget:
- eine Zahl oder eine Zahl als Text → das ist der Wert;
- ein Array von Zeilen → die eingestellte Wertspalte der ersten Zeile, sonst deren erste numerische Spalte.
Bei Diagrammen und Tabellen stellen Sie zusätzlich ein, welche Spalte die Beschriftung trägt und welche die Serien, Stapel, Gruppen oder Summen bilden.
Parameter: der Punkt, an dem es klemmt
Abschnitt betitelt „Parameter: der Punkt, an dem es klemmt“Ein Tag kann benannte Parameter deklarieren — from, to, line. Jeder davon wird auf
genau eine von drei Arten gefüllt:
| Quelle | Wann |
|---|---|
| Board-Filter | wenn ein Filter-Widget auf diesem Board einen Wert gleichen Namens setzt |
| Fester Wert | wenn Sie ihn im Widget festnageln |
| — gar nicht | dann ist er für den Datenlayer nicht bestimmbar |
Der dritte Fall ist der wichtige: ein einziger unbestimmter Parameter macht die ganze Lesung
unsicher. Der Einrichtungsdialog nennt je Parameter, woher er kommt, damit das nicht später
als unerklärlicher Hinweis auf einer Kachel auftaucht.
Wie ein Filter wirkt
Abschnitt betitelt „Wie ein Filter wirkt“Ein Filter-Widget schreibt seinen Wert auf ein Speicher-Tag, zum Beispiel
Plant.Filter.Line. Die abhängigen Widgets folgen, weil ihr eigenes Tag einen Parameter an
dieses Tag gebunden hat; das Nachladen stößt der Datenlayer selbst an.
Der Zeitraum-Filter schreibt Beginn und Ende auf zwei Tags und füllt damit die Parameter
from und to. Angeboten werden Heute, Diese Schicht, 7 Tage, 30 Tage und
Benutzerdefiniert; einstellbar sind außerdem Woche und Monat.
Achten Sie auf den Unterschied: 7 Tage und 30 Tage sind rollierende Fenster, Woche und Monat beginnen am Montag beziehungsweise am Ersten. Am zweiten Tag eines Monats unterscheiden sich „letzte 30 Tage” und „dieser Monat” um den Faktor fünfzehn.
Zeigt der Filter auf einen Pfad, unter dem es kein Tag gibt, sagt der Dialog das sofort.
Wann sich ein Widget aktualisiert
Abschnitt betitelt „Wann sich ein Widget aktualisiert“Zwei Wege, und der Unterschied ist beabsichtigt.
Ändert sich ein Tag, das ein Widget direkt anzeigt, erscheint der neue Wert sofort — die Anlage meldet die Änderung, und nur die betroffenen Widgets holen sie ab.
Ein Widget an einer Auswertung hängt nicht an einem einzelnen Tag, sondern an einer ganzen Tabelle: „Elemente heute” zählt Zeilen, die im Sekundentakt dazukommen. Für solche Widgets meldet niemand eine Änderung — sie holen ihren Wert deshalb alle zehn Sekunden selbst.
Das ist der Grund, warum ein Zähler manchmal ein paar Sekunden nachhinkt, während die Statuszeile daneben sofort umspringt. Beides ist richtig: eine Tageszahl wird nicht falsch, weil sie zehn Sekunden alt ist — eine Anlage, die eben stehengeblieben ist, schon.
Der Zeitpunkt, zu dem der gezeigte Wert galt, steht als Stand am Widget.
Was am Widget über die Güte steht
Abschnitt betitelt „Was am Widget über die Güte steht“| Anzeige | Bedeutung |
|---|---|
| unsicher | ein Parameter ist unbestimmt, oder die Quelle ist noch nicht eingerichtet |
| gestört | die Quelle hat sich gemeldet, aber der Wert ist nicht brauchbar |
| verweigert | Sie dürfen diesen Wert nicht sehen |
| Stand | der Zeitpunkt, zu dem der gezeigte Wert galt |
Diese Angaben stehen bewusst am Widget und nicht nur im Protokoll: eine Zahl, deren Herkunft unklar ist, muss sich das ansehen lassen.