Komponenten einer D3 Visualisierung Dashboard-Konfigurationsdatei

JavaScript Object Notation (JSON)

Jedes Dashboard hat seine eigene JSON-Konfigurationsdatei (JavaScript Object Notation), die die verwendeten Steuerelemente und die Art ihrer Anzeige zur Laufzeit festlegt. Sie gibt z.B. die Anzahl Zeilen und Spalten des Dashboard-Layouts und die Grösse der Ränder an. Ferner gibt sie beispielsweise an, welche Steuerelemente, Balken- oder Kreisdiagramme und welche Farbe für Wertebereiche angezeigt werden sollen.

Mit der JSON-Notation können Sie Daten zwischen einem Browser und einem Server speichern und austauschen. Die JSON-Datei wird vom Webserver gehostet. Die Syntaxregeln lauten wie folgt:

• PropertyName: PropertyValue Syntaxpaare.
• Daten werden durch Kommata getrennt.
• Geschweifte Klammern enthalten Objekte.
• Eckige Klammern enthalten Arrays.

Jede JSON-Konfigurationsdatei besteht aus drei Hauptabschnitten: DashboardLayout, Widgets und die BasisURI.

 

Dashboard-Layout

Dieser Abschnitt der Konfigurationsdatei definiert das Gesamtlayout und das Raster des Dashboards. Ferner legt er fest, wo die Fehler- oder Ausnahmeprotokollierungen angezeigt werden und welche Aktionen protokolliert werden sollen.

Hinweis: Die Anzahl der zugelassenen Zeilen und Spalten ist unbegrenzt.

In diesem Abschnitt werden folgende Parameter festgelegt:

• Zeilen – Die Anzahl Zeilen des Dashboards.
• Spalten – Die Anzahl Spalten des Dashboards.
• Ränder - Legt die Ränder des Dashboards fest: Oben, rechts, unten und links.
• Logging – Gibt zu protokollierende Fehler-, Informations- oder Warnmeldungen an und wo sie hinterlegt werden sollen. Geben Sie True oder False ein, um die verschiedenen Protokollierungsoptionen zu aktivieren oder zu deaktivieren:
• LoggerName – Zeigt den Speicherort des Protokolls an: AFWLogger ermöglicht die Anzeige des Protokolls im Trace-Viewer. BrowserLogger zeigt die protokollierten Informationen im Standardbrowser an.
• TurnOnInfoTrace – Protokolliert Ereignisse wie Rückrufe, Datenverarbeitung, Fehlerbehebungseinträge, usw.
• TurnOnErrorTrace – Protokolliert Ausnahmeereignisse.
• TurnOnWarningTrace – Protokolliert Probleme mit dem Code-Format, usw.
• BackgroundColor – Die Hintergrundfarbe der Webseite. Die Standardfarbe ist weiss.

 

Widgets

Hier wird jedes Steuerelement auf dem Dashboard definiert und formatiert. Die Daten des Datenproviders werden gemäss den Informationen in diesem Abschnitt angezeigt. Sie müssen für die Platzierung jedes Steuerelements die folgenden grundlegenden Widget-Informationen bereitstellen:

• Name – Ein Name für das Widget. Wird auch als Diagrammtitel verwendet.
• Charttype – Art des grafischen Steuerelements:
• PieChart
• RadialGauge
• TrendSeriesChart
• VerticalBarChart
• HorizontalBarChart
• Layout – Definiert die Platzierung des grafischen Steuerelements im oben definierten Layout des gesamten Dashboards. Ausserdem können Sie angeben, ob Sie eine Legende möchten oder nicht.
• StartRow – Geben Sie einen Wert für die Zeile an, in der das Steuerelement angezeigt werden soll.
• StartColumn – Geben Sie einen Wert für die Spalte an, in der das Steuerelement angezeigt werden soll.
• Rowspan – Geben Sie einen Wert für die Anzahl Zeilen an, die das Steuerelement verwenden soll.
• Columnspan – Geben Sie einen Wert für die Anzahl Spalten an, die das Steuerelement verwenden soll.
• dataProvider – Der Datenprovider ist für das Abrufen der Daten von dem Webdienst verantwortlich, der die Daten hostet und stellt die Daten dar, die das Steuerelement versteht. Jedes Widget kann seinen eigenen Datenprovider haben, und jeder Datenprovider hat seine eigenen Konfigurationsanforderungen. Die folgenden Parameter beziehen sich auf dataProvider:
• Name – Geben Sie den Namen des Datenproviders ein
• PrivateConfig – Die spezifischen Parameter eines Steuerelements, die der Datenprovider benötigt
• style – Dieser Abschnitt definiert das Erscheinungsbild des Steuerelements. Die Parameter variieren je nach Steuerelement. String-Parameter können durch Verwendung eines Schlüssel-Wert-Paares für Mehrsprachigkeit angepasst werden.
• Config – Dieser Abschnitt wird nur im Diagramm der Messgerätesteuerung angezeigt. Er legt die Parameter für Anfang und Ende eines Wertebereichs sowie die den Wertebereichen zugeordneten Farben fest.

 

BaseURI

Bezieht sich auf den Pfad des Web Service Interface, in dem die Daten abgerufen werden. Dieser Pfad kann auf einen lokalen oder Remotecomputer verweisen.