Aktualisiert – Dezember 31, 2022
Systemvariablen sind zum Teil fest vordefiniert, können aber ebenso selbst erstellt werden und sind über das Menü „Einstellungen – Systemvariablen“ erreichbar. Systemvariablen müssen einzigartig sein, dürfen also nur einmal je Zentrale vergeben werden. Sonderzeichen im Namen sollten vermieden werden.
In der Ansicht der Systemvariablen kann mit Klick auf den Button „Neu“ unten links
eine Systemvariable erstellt werden.
Im Feld „Name“ wird der gewünschte Name der Systemvariablen eingegeben z.B. „Anwesenheit“. Die Beschreibung der Systemvariablen kann abweichend vom Namen oder identisch sein.
Als Variablentyp kommen mehrer Möglichkeiten zur Auswahl.
Wenn man die „Anwesenheit“ einer Person prüfen will, bleibt nur die Wahl „Logikwert“, denn die Aussage der Systemvariablen „Anwesenheit“ kann nur den Zustand „wahr“ oder „falsch“ annehmen. „Wahr“ ist somit gleichzusetzen mit „die Person ist anwesend“ oder „nicht anwesend„. Hier wurde bewusst „nicht anwesend“ statt „abwesend“ gewählt, da „anwesend“ und „abwesend“ leicht mit einander verwechselt werden können
Eine Werteliste ist dann interessant, wenn eine Bedingung in Abhängigkeit mehrer Werte erfüllt sein soll.
Eine Werteliste kann Zahlen, aber auch numerische Werte, wie z.B. „Sommer; Herbst“ enthalten, die jeweils durch ein Semikolon von einander getrennt werden.
Alle Daten vom Format „Zahl“ werden über diesen Typ bedient. Sie können positive und negative Werte annehmen,
Daten vom Typ „String“ bestehen aus eine beliebigen Zeichenkette von alphanumerischen Werten inklusive Sonderzeichen.
Die Systemvariable „Alarm“ wird vom System auf „ausgelöst“, entsprechend „wahr“ gesetzt, wenn ein Fehler auftritt, ansonsten auf „nicht ausgelöst“, entsprechend „falsch“.
Im Feld „Maßeinheit“ kann noch z.B. „kW“ oder „°C“ eingetragen werden, sofern es sich um z.B. Leistungswerte oder Temperaturen handelt.
Die Angabe im Feld „Wert“ definiert den Ausgangswert bei Systemstart, ob dieser standardmäßig als „wahr“ oder „falsch“ angenommen werden soll.
Ordnet man der Systemvariablen einen Kanal eines Gerätes zu, klickt man unter „Kanalzuordnung“ den Radio-Button „mit“ an. In diesem Fall wird die Systemvariable nicht mehr unter „Systemvariablen“ angezeigt, sondern im Web-Frontend bei dem entsprechenden Gerät.
In der Scriptsprache ruft man den Wert einer Systemvariablen mit
var myvar= dom.GetObject("Sysvar").Value();
ab, bzw. setzt einen Wert mit
dom.GetObject("Sysvar").State(myvar);.
Den Wert eines Gerätekanals ruft man mit
var myvar = dom.GetObject("BidCos-RF.MEQ0817107:1.LOWBAT").Value();
ab. Hierbei ist „BidCos-RF.“ der standardisierte Header, sowie die nachfolgende Zeichenkette die einzigartige ID des jeweiligen Gerätes, die beim Anlernen der Zentrale übermittelt wurde, getrennt durch einen Doppelpunkt vom Kanal, hier „1“, dessen Wert, hier „LOWBAT“, der Batterieladezustand, abgefragt werden soll.
Mit
WriteLine(myvar);
lässt sich der ermittelte Wert ausgeben.