Balkendiagramm

Das beschriebene Widget eignet sich für die Darstellung eines horizontalen Balkendiagramms in der App. Dieses Balkendiagramm kann sowohl einzelne Balken als auch zwei zu vergleichende Balken anzeigen. Die verschiedenen Konfigurationsmöglichkeiten werden im Folgenden beschrieben. In der Abbildung sind alle verfügbaren Features des Widgets aktiv.

Das Widget wird als Unterstruktur in der Gesamtstruktur der SendData()-Methode übergeben. Für den Aufbau des Widgets werden bei der Deklaration der Struktur verschiedene SPS-Attribute verwendet.

{attribute 'iot.DisplayName' := 'Name for Widget'}
{attribute 'iot.WidgetType' := 'BarChart'}
{attribute 'iot.ChartXAxisLabel' := 'Name for X Axis'}
{attribute 'iot.ChartYAxisLabel' := 'Name for Y Axis'}
{attribute 'iot.Unit' := 'Unit for X Axis'}
{attribute 'iot.ChartLegendVisible' := 'true'}
{attribute 'iot.ChartValuesVisible' := 'true'}
{attribute 'iot.MinValue':='0'}
{attribute 'iot.MaxValue':='1550'}
{attribute 'iot.ChartBarColor1' := '#00FFFF'}
{attribute 'iot.ChartBarColor2' := '#FF00FF'}
stChart    : ST_BarChartWidgetSample;

Attribut	Datentyp	Beschreibung
iot.DisplayName	STRING	Der Anzeigename des Widgets in der App. Dieser wird von sDisplayName überschrieben, sobald sDisplayName kein Leerstring ist.
iot.WidgetType	STRING	Typangabe für das Widget, in diesem Fall: BarChart.
iot.ChartXAxisLabel	STRING	Der Anzeigename der X-Achse.
iot.ChartYAxisLabel	STRING	Der Anzeigename der Y-Achse.
iot.Unit	STRING	Einheit, die in eckigen Klammern hinter dem Anzeigenamen der X-Achse angezeigt wird.
iot.ChartLegendVisible	BOOL	Legt fest, ob die Legende angezeigt wird (TRUE) oder nicht (FALSE).
iot.ChartValuesVisible	BOOL	Legt fest, ob die Werte der Balken im Diagramm angezeigt werden (TRUE) oder nicht (FALSE).
iot.MinValue	INT	Untere Grenze des Wertebereichs des Diagramms.
iot.MaxValue	INT	Obere Grenze des Wertebereichs des Diagramms.
iot.ChartBarColor1	STRING	Legt die Farbe der oberen Balken fest. Die Liste der verfügbaren Farben ist unter Liste der verfügbaren Farben zu finden. Die Farbe muss entweder in einem der im Anhang angegebenen Strings angegeben werden oder als Hex-Code mit „#“ vor dem Wert.
iot.ChartBarColor2	STRING	Legt die Farbe der unteren Balken fest. Die Liste der verfügbaren Farben ist unter Liste der verfügbaren Farben zu finden. Die Farbe muss entweder in einem der im Anhang angegebenen Strings angegeben werden oder als Hex-Code mit „#“ vor dem Wert.

TYPE ST_BarChartWidgetSample :
STRUCT
    sDisplayName          : STRING := '';
    aDataSeries           : ARRAY[0..n] OF INT;
    aComparismDataSeries  : ARRAY[0..n] OF INT;
    aDataSeriesIdentifier : ARRAY[0..n] OF STRING;
    aLegendLabels         : ARRAY[0..n] OF STRING;
END_STRUCT
END_TYPE

Attribut	Datentyp	Beschreibung	Abbildung im Widget
sDisplayName	STRING	Legt den Anzeigenamen des Widgets fest und überschreibt das SPS-Attribut 'iot.DisplayName'.	Anzeigetext des Widgets.
aDataSeries	ARRAY [0..n] OF INT	Die erste Datenreihe, die im Balkendiagramm angezeigt wird. Das Array muss genauso groß sein wie die ComparismDataSeries und die DataSeriesIdentifier..	Länge der oberen Balken.
aComparismDataSeries	ARRAY [0..n] OF INT	Die zweite Datenreihe, die im Balkendiagramm angezeigt wird. Das Array muss genauso groß sein wie die DataSeries und die DataSeriesIdentifier. Beim Schicken eines leeren Arrays wird ein Balkendiagramm mit nur einem Balken angezeigt.	Länge der unteren Balken.
aDataSeriesIdentifier	ARRAY [0..n] OF STRING	Benennungen der Werte auf der Y-Achse. Dieses Array muss genauso groß sein wie die DataSeries und die ComparismDataSeries.	Beschriftungen der Werte auf der Y-Achse.
aLegendLabels	ARRAY [0..0] OF STRING ARRAY [0..1] OF STRING	Legende des Balkendiagramms. Die Größe des Arrays bestimmt sich dadurch, welche Anzahl an Balken dargestellt wird.	Zwischen dem Titel des Widgets und dem Diagramm.