Überblick über D3 Visualization
Die Erweiterung D3 Visualization ist eine Webclient-Applikation, in der Sie grafische Darstellungen der Daten erstellen und diese in einem Dashboard oder auf einer Webseite anzeigen können. Sie können dynamische Daten in einem grafischen Format anordnen, anzeigen und vergleichen, indem Sie datengestützte Diagramme (Data Driven Documents, D3) wie Torten-, Trend- und Balkendiagramme oder Messgerätesteuerungen verwenden. In einem D3 Visualization-Dashboard können beliebig viele Diagramme und Steuerungen verwendet werden. Die Daten für die verschiedenen Steuerungen werden der URL entnommen, die in der Managementstation Web-Regel konfiguriert ist.
D3 ist eine JavaScript-Bibliothek, die neben anderen Tools HTML verwendet, um eine Visualisierung in einem dynamischen Format in eine Webseite bzw. Website oder im Falle der Managementstation in ein Dashboard zu integrieren.
Die grafischen Diagramme der D3 Visualisierung werden generiert, indem Daten von einem Datenprovider abgerufen und dann Steuerelemente gemäss den bereitgestellten Werten gezeichnet werden. Die Werte werden dynamisch unter Verwendung von Signal-R TM oder, abhängig von dem Datenprovider, in Poll-basierten Zeitintervallen erhalten.
Die D3 Visualisierung Web-Applikation Dashboard kann in folgenden Clients angezeigt werden:
- System Browser oder
- unabhängige Browser
Darüber hinaus können Sie für jedes Dashboard:
- Für jedes Widget stilbezogene Eigenschaften konfigurieren, zum Beispiel Schriftart, Farben, Tooltips usw.
- Ein Dashboard vergrössern/verkleinern und das Seitenverhältnis beibehalten.
- Mit Signal-R TM-Strategien Abfragen oder dynamische Daten auswählen, um Daten auf einer Widget-für-Widget-Basis von der Datenquelle zu erhalten.
- Texteigenschaften lokalisieren. Alle Zeichenfolgenparameter in der Konfigurationsdatei von Dashboard, z.B. Diagrammtitel und Fehlermeldungen, können für eine bestimmte Sprache oder Umgebung lokalisiert werden.
- Parameter für dynamische Konfigurationen ersetzen. Jeder numerische, boolesche, String- oder Objektwert in einer Konfigurationsdatei kann ersetzt werden, um entweder die Grösse der Konfigurationsdatei zu reduzieren oder mehrere Steuerelemente in einem bestimmten Dashboard zu unterstützen.
Über Balkendiagramme
Im Folgenden finden Sie einige Details zu den Steuerelementen für Balkendiagramme:
- Optionen für vertikale und horizontale Diagramme sind verfügbar.
- Das Dashboard GMS Projects > Websites > Website > [dashboard name] > Configs enthält die folgenden Dateien, die sich auf die Steuerelemente von Balkendiagrammen beziehen:
- Beispiel Konfigurationsdateien für Balken: Horizontal_dashboardconfig.JSON und Vertical_dashboardconfig.JSON
- Die Dateien VerticalBarChartStyle.JSON und HorizontalBarChartStyle.JSON im Ordner > Styles enthalten alle Stile für Balkendiagramme.
- Einzelne Y- und X-Achsen werden unterstützt.
- Die Sichtbarkeit von Legende und Titel kann aktiviert (True) oder deaktiviert (False) werden.
Über Messgerätesteuerung
Die Messgerätsteuerung unterstützt dynamische Live-Datenaktualisierungen von der Cloud oder der Web Service Interface. Einige der Parameter zur Anpassung des Messgeräts sind Start- und Endwerte des Messbereichs, die Haupt- und Nebenintervallwerte sowie der Bogen (Grösse) des Steuerelements.
Im Folgenden finden Sie einige Details zur Messgerätesteuerung:
- Wenn eine Messgeräteanzeige aus fünf Abschnitten besteht und nur drei Farben zur Verfügung stehen, verwenden die letzten beiden Segmente die zuletzt angegebene Farbe.
- Jedem Abschnitt muss ein Farbwert zugewiesen werden.
- Die dataProvider-Werte definieren die Platzierung der Anzeigenadel.
- Der Parameter für den Wert privateConfig muss entweder ein konkreter Wert oder ein Ersatzschlüssel sein:
- Konkreter Wert: "privateConfig": {"pointName": "Analog_Input_1"}
- Ersatzwert: "privateConfig": {"pointName": "$pName$"}
- Die Steuerungen sind dynamisch und verwenden je nach Datenprovider Signal-R TM oder sind abfragebasiert. Die Abfragerate ist pro Messgerät konfigurierbar.
Das Abfrageintervall ist:Time Interval. - Das Dashboard GMS Projects > Websites > Website > [dashboard name] > Configs enthält die folgenden Dateien, die sich auf die Messgerätesteuerung beziehen:
- Eine Beispieldatei für die Messgerätekonfiguration: gauge_dashboard
- Im Ordner ... > Styles enthält die Datei GaugeStyle.JSON alle Stile für ein Messgerät.
- Es werden positive und negative Werte unterstützt.
- Der Parameter Config ist spezifisch für die Messgerätesteuerung. Sie können hier die Anfangs- und Endwerte eines Wertebereichs sowie die den Wertebereichen zugeordneten Farben festlegen:
- "startValue": "0", - Geben Sie den Startwert der Messgerätesteuerung ein. In diesem Beispiel ist der Startwert "0".
- "endValue": "100", - Geben Sie den Endwert der Messgerätesteuerung ein. In diesem Beispiel ist der Endwert "100".
- "colorlimits": - Geben Sie Farben und ihre Wertebereiche an. Geben Sie für jede gewünschte Farbe auf dem Messgerät die Farbe und die Schwelle ein. Ein Beispiel bietet die Datei gauge_dashboardconfig.
- Die folgenden Layoutwerte sind spezifisch für die Messgerätesteuerung:
- value-visible – Auf True oder False setzen.
- value-position - Auf Mitte setzen.
Über Gruppierte Balkendiagramme
Im Folgenden finden Sie einige Details zu den Steuerelementen für gruppierte Balkendiagramme:
- dataProvider-Werte bestimmen die Ebenen der Balkendiagramme.
- Die Steuerelemente sind dynamisch, sofern die Quelle des Datenproviders dynamische Aktualisierungen unterstützt. Bei bfrage-basierter Bereitstellung der Daten, ist die Abfragerate pro Balkendiagramm konfigurierbar.
- Das Balkendiagramm ist in zwei Layouts verfügbar:
- Vertikales Balkendiagramm: Balken werden vertikal parallel zur Y-Achse gezeichnet
- Horizontales Balkendiagramm: Balken werden horizontal parallel zur X-Achse gezeichnet
- Einzelne Y- und X-Achsen werden unterstützt.
- Die Sichtbarkeit von Legende und Titel kann aktiviert (True) oder deaktiviert (False) werden.
- Jedes Feld in einem Bericht kann im Balkendiagramm dargestellt werden.
- Balken für das Balkendiagramm werden basierend auf der Kategorie gruppiert.
Über Kreisdiagramme
In einem Kreisdiagramm können Daten in mehreren Abschnitten dargestellt werden. Um für jeden Abschnitt unterschiedliche Farben zu erhalten, werden Anfangs- und Endfarbe definiert und die Farben zwischen den beiden Bereichen berechnet. Jeder Abschnitt ist daher eine Abstufung der zwei definierten Startpunkte und Farben.
Im Folgenden finden Sie einige Details zu den Steuerelementen für Kreisdiagramme:
- Die Datenproviderwerte bestimmen die Abschnittsgrössen.
- Die Steuerungen sind dynamisch und verwenden je nach Datenprovider Signal-R TM oder sind abfragebasiert. Die Abfragerate ist pro Kreisdiagramm konfigurierbar.
- Werte, die zu gross für einen Abschnitt des Kreisdiagramms sind, werden ausserhalb des Diagramms angezeigt.
- Das Dashboard GMS Projects > Websites > Website > [dashboard name] > Configs enthält die folgenden Dateien, die sich auf die Steuerelemente von Kreisdiagrammen beziehen:
- Eine Beispieldatei für die Messgerätekonfiguration: pie_dashboard
- Die Datei PieChartStyle.JSON im Ordner Styles enthalten alle Stile für Kreisdiagramme.
- Die Abschnittsfarben basieren auf den Werten für
Chart-startColorundchart-endColor. - Die Sichtbarkeit von Legende und Titel kann aktiviert (True) oder deaktiviert (False) werden.
Über Trendseriendiagramme
In einer Trendserie können Sie eine X- und Y-Achse zur Darstellung von Daten verwenden. Im Folgenden finden Sie einige Details zu den Steuerelementen für Trendseriendiagramme:
- Die DataProvider-Werte bestimmen die Linien der Trendreihen.
- Der Parameter für den Wert privateConfig muss entweder ein konkreter Wert oder ein Ersatzschlüssel sein:
- Konkreter Wert: “seriesidparam”:”Point_ID_1”,
- Ersatzwert: "seriesidsparam":"$trendSeriesIds$",
- Wenn kein Bereich in den Felder Von und Bis des Regeleditors während der Konfiguration festgelegt wurde, werden die Daten aus der History-Datenbank (HDB) des Projekts verwendet, um die Trendserie zu füllen..
- Das auf dem Diagramm angezeigte Intervall ist abhängig von den angegebenen Intervallkriterien. Jedes Intervall zeigt die Min. und Max Wertänderung des Intervalls an.
- Mit der Navigationskarte am unteren Rand einer Trendserie können Sie Abschnitte vergrössern oder verkleinern.
- Das Dashboard GMS Projects > Websites > Website > [D3 dashboard name] > Configs enthält die folgenden Dateien, die sich auf die Steuerelemente von Trendseriendiagrammen beziehen:
- Eine Beispieldatei für die Trendserienkonfiguration: line_dashboard
- Im Ordner Styles enthält die Datei TrendSeriesStyle.JSON alle Stile für eine Trendserie.
- Die Sichtbarkeit von Legende und Titel kann aktiviert (True) oder deaktiviert (False) werden.
- Einzelne X-Achsen und einzelne oder mehrere Y-Achsen werden entsprechend den Datenproviderwerten angepasst. Für unterschiedliche Wertebereich werden mehrere Y-Achsen verwendet. Bei gleichem oder ähnlichem Wertebereich wird eine einzelne oder kombinierte Y-Achse verwendet.
- Die Zoom-Funktion ermöglicht statische und dynamische Aktualisierungen:
- Statisches Zoomen: Vergrössern oder verkleinern Sie Daten, die bereits im Diagramm vorhanden sind. Klicken Sie auf den Schieber, um die Ansicht zu vergrössern/verkleinern. Es werden keine neuen Daten abgerufen.
- Dynamisches Zoomen: Beim Verkleinern werden Daten aktualisiert und neue Daten abgerufen. Sie können aus ausserhalb des konfigurierten Von/Bis Zeitintervalls scrollen. Klicken Sie eine beliebige Stelle im Diagramm und drücken Sie dann STRG + Mausrad, um die Daten zu aktualisieren und neue Daten abzurufen, während Sie das Diagramm vergrössern bzw. verkleinern.
Über Diagramme für multiple Trendserien
Eine Trendserie mit mehreren Y-Achsen ermöglicht Ihnen, die Y-Achse zur Darstellung der Daten für mehrere Datenbereiche zu verwenden. Im Folgenden finden Sie einige Details zu den Steuerelementen für Diagramme mit multiplen Trendserien:
- Die DataProvider-Werte bestimmen die Linien der Trendreihen.
- Der Parameter für den Wert privateConfig muss entweder ein konkreter Wert oder ein Ersatzschlüssel sein:
- Konkreter Wert: “seriesidparam”:”Point_ID_1, Point_ID_2”,
- Ersatzwert: "seriesidsparam":"$trendSeriesIds$",
- Mit der Navigationskarte am unteren Rand einer Trendserie können Sie Abschnitte vergrössern oder verkleinern.
- Die Sichtbarkeit von Legende und Titel kann aktiviert (True) oder deaktiviert (False) werden. Die Positionierung der Legende ist bei diesem Diagrammtyp auf oben und unten beschränkt.
- Die Anzahl der angezeigten Y-Achsen hängt von der Anzahl der Punkte und dem Bereich im Datenwert ab:
- Wenn Sie mehrere Punkte mit jeweils anderem Wertebereich haben, wird für jeden Bereich eine Y-Achse gezeichnet.
- Wenn zwei Punkte denselben Datenbereich haben, werden sie in einer einzelnen Achse zusammengefasst.
Standardeigenschaften von D3 Visualization
Eigenschaften | Radial-Messgerät | Kreisdiagramm | HorizontalBarChart | VerticalBarChart | TrendSeriesChart |
Hintergrundfarbe | #F2F2F2 | #F2F2F2 | #F2F2F2 | #F2F2F2 | #F2F2F2 |
|
|
|
|
|
|
Hintergrund Tooltip | Weiss | Weiss | Weiss | Weiss |
|
Schriftfarbe Tooltip | Black | Black | Black | Black | Black |
Schriftart Tooltip | Serifenlos | Serifenlos | Serifenlos | Serifenlos | Serifenlos |
Schriftgrösse Tooltip | 10 | 10 | 10 | 10 | 10 |
|
|
|
|
|
|
Schriftfarbe Legende | #37474F | #37474F | #37474F | #37474F | #37474F |
Schriftart Legende | Serifenlos | Serifenlos | Serifenlos | Serifenlos | Serifenlos |
Schriftgrösse Legende | 10 | 10 | 10 | 10 | 10 |
Position Legende | oben | oben | oben | oben | oben |
Legende sichtbar | TRUE | TRUE | TRUE | TRUE | TRUE |
|
|
|
|
|
|
Schriftfarbe Titel | #efefef | #efefef | #efefef | #efefef | #efefef |
Schriftart Titel | Serifenlos | Serifenlos | Serifenlos | Serifenlos | Serifenlos |
Schriftgrösse Titel | 14 | 14 | 14 | 14 | 14 |
Titel sichtbar | TRUE | TRUE | TRUE | TRUE | TRUE |
Hintergrundfarbe Titel | #404040 | #404040 | #404040 | #404040 | #404040 |
|
|
|
|
|
|
Schriftfarbe Fehler | Rot | Rot | Rot | Rot | Rot |
Schriftart Fehler | Serifenlos | Serifenlos | Serifenlos | Serifenlos | Serifenlos |
Schriftgrösse Fehler | 14 | 14 | 14 | 14 | 14 |
Schriftfarbe | Black | Black | - | - | - |
Schriftart | Serifenlos | Serifenlos | - | - | - |
Schriftgrösse | 12 | 12 | - | - | - |
|
|
|
|
|
|
Rand:{ |
|
|
|
|
|
links | 5 | 5 | 5 | 5 | 20 |
oben | 5 | 5 | 5 | 5 | 5 |
rechts | 5 | 5 | 5 | 5 | 5 |
unten | 5 | 5 | 5 | 5 | 5 |
} |
|
|
|
|
|
|
|
|
|
|
|
Startfarbe | #01579B | #01579B | #01579B | #01579B | #01579B |
Endfarbe | #90CAF9 | #90CAF9 | #90CAF9 | #90CAF9 | #90CAF9 |
|
|
|
|
|
|
Werteinheit | Standard | - | - | - | - |
Wertposition | Mittig |
|
|
|
|
Winkel | 230 | - | - | - | - |
Startwert | 0 | - | - | - | - |
Endwert | 200 | - | - | - | - |
Hauptintervalle | 5 | - | - | - | - |
Nebenintervalle | 10 | - | - | - | - |
Farbe Intervall | Grau | - | - | - | - |
Farbe Hauptticks | Black | - | - | - | - |
Farbe Nebenticks | Grau | - | - | - | - |
Farbe aktive Nadel | Marineblau | - | - | - | - |
Schriftgrösse Inkrement-Ziffern | 5 | - | - | - | - |
Schriftart Ziffern | Serifenlos | - | - | - | - |
Schriftfarbe Ziffern | Black | - | - | - | - |
|
|
|
|
|
|
Farbe x-Achse | - | - | #37474F | #37474F | #37474F |
Farbe y-Achse | - | - | #37474F | #37474F | #37474F |
Schriftart x-Achse | - | - | Serifenlos | Serifenlos | Serifenlos |
Schriftart y-Achse | - | - | Serifenlos | Serifenlos | Serifenlos |
Schriftgrösse x-Achse | - | - | 10 | 10 | 10 |
Schriftgrösse y-Achse | - | - | 10 | 10 | 10 |
Beschriftung x-Achse | - | - | - | - | x-Achse |
Beschriftung y-Achse | - | - | - | - | y-Achse |
Beschriftung x-Achse sichtbar | - | - | - | - | true |
Beschriftung y-Achse sichtbar | - | - | - | - | true |
Linien-Opazität x-Achse | - | - | - | - | 25 |