Attribute
Die in der Folge aufgelisteten Attribute sind die allgemein anwendbaren Attribute. Die speziell für die Widgets eingeführten Attribute werden unter Widgets beschrieben.
Anzeigename der Variablen (iot.DisplayName)
Syntax: {attribute 'iot.DisplayName' := 'Ceiling Lights'}
Definiert den Namen, der in der App für diese Variable angezeigt werden soll. Wenn dieses Attribut nicht angegeben wird, wird in der App der SPS-Variablenname angezeigt.
Einheit der Variablen (iot.Unit)
Syntax: {attribute 'iot.Unit' := '°C'}
Definiert die Einheit, die in der App hinter dem Wert der Variablen steht. Wenn dieses Attribut nicht angegeben wird, bleibt die Einheit hinter dem Wert leer.
Variable nicht veränderbar (iot.Readonly)
Syntax: {attribute 'iot.ReadOnly' := 'TRUE'}
Definiert, ob die Variable von der App aus verändert werden darf. Wird dieses Attribut mit dem Wert TRUE angegeben, ist die Variable nicht mehr veränderbar und es erscheint ein Schloss-Symbol neben dem Variablennamen. Wenn dieses Attribut nicht angegeben wird, ist die Variable standardmäßig veränderbar.
Benutzer-Konfiguration (iot.PermittedUsers)
Syntax: {attribute 'iot.PermittedUsers' := 'User1,User2'}
Standardmäßig kann jede Variable (unabhängig davon, ob Struktur oder einfacher Datentyp) von jedem Benutzer gesehen werden. Wenn dieses Attribut hinzugefügt wird, können nur die angegebenen Benutzer die Variable in ihrer App sehen.
Icons allgemein (iot.Icon)
Syntax: {attribute 'iot.Icon' := 'Room'}
Definiert das Icon, das an einer einzelnen Variablen oder an einer Struktur angezeigt wird. Standardmäßig für Strukturen wird der TwinCAT-Würfel angezeigt. Die verfügbaren Icons werden in der Liste der verfügbaren Icons aufgelistet. An Strukturen kann auch das Attribut iot.NestedStructIcon verwendet werden.
Icon einer verschachtelten Struktur (iot.NestedStructIcon)
Syntax: {attribute 'iot.NestedStructIcon' := 'Room'}
Definiert das Icon für die Startseite einer verschachtelten Struktur. Standardmäßig wird der TwinCAT-Würfel angezeigt. Die verfügbaren Icons werden in der Liste der verfügbaren Icons aufgelistet.
Minimal- und Maximalwert der Variable (iot.MinValue und iot.MaxValue)
Syntax: {attribute 'iot.MinValue' := '10'} {attribute 'iot.MaxValue' := '30'}
Definiert einen Minimal- und Maximalwert für numerische Variablen. Wenn beide Attribute ('MinValue' UND 'MaxValue') angegeben werden, wird in der App anhand einer Fortschrittsanzeige angezeigt, inwieweit der aktuelle Wert in Bezug auf den Minimal- und Maximalwert fortgeschritten ist.
Hinweis | |
Fortschrittsanzeige Minimal- und Maximalwert definieren den Bereich, den die Fortschrittsanzeige in der App berücksichtigt. Der Wert kann in der SPS die angegebenen Werte über- oder unterschreiten. |
Wenn ein Wert seinen vorgeschriebenen Bereich verlässt, wird dies in der App mithilfe eines rot markierten Wertes hervorgehoben. Im folgenden Screenshot hat ein Wert seinen definierten Bereich verlassen.

Beschränkung der Dezimalstellen an einer Variablen (iot.DecimalPrecision)
Syntax: {attribute 'iot.DecimalPrecision' := '3'}
Definiert eine Anzahl an Nachkommastellen, auf die ein Gleitkommazahlwert gerundet wird. Diese Einstellung überschreibt für die jeweilige Variable eine eventuell vorhandene App-Einstellung.
Änderung der Textfarbe (iot.ValueTextColor und iot.ValueTextColorDark)
Syntax: {attribute 'iot.ValueTextColor' := 'Green'}
Syntax: {attribute 'iot. ValueTextColorDark' := 'Blue'}
Definiert eine Farbe für die Anzeige eines Variablenwerts in der App. Die Funktion wird nur für einfache Variablentypen unterstützt. Verfügbare Farben sind unter Liste der verfügbaren Farben zu finden.
Die folgende Tabelle zeigt die verschiedenen möglichen Konstellationen:
Konfiguration | Auswirkung |
---|---|
Das Attribut ist nicht gesetzt. | Es wird die Default-Farbe verwendet. |
Nur das Attribut ValueTextColor ist gesetzt. | Die gesetzte Farbe wird im Light Mode und im Dark Mode verwendet. |
Die Attribute ValueTextColor und ValueTextColorDark sind gesetzt. | Im Light Mode und Dark Mode werden die jeweils gesetzten Farben verwendet. |
Nur das Attribut ValueTextColorDark ist gesetzt. | Die gesetzte Farbe wird nur im Dark Mode verwendet, im Light Mode wird die Default-Farbe verwendet. |
Beispiel

Siehe auch: Beispiele > Applikationsbeispiel