Lesen eines Arrays:

Um auf eine Array-HMIVariable in JavaScript zugreifen zu können, kann die Variable über Tags(„VariablenName“).Read() ausgelesen und einer Variable zugeordnet werden.

Bild 1: Lesen und Schreiben eines einzelnen Array-Elements

z. B.:

let array = Tags(„ArrayVariable“).Read();

Die Variable "array" repräsentiert nun eine Kopie des Variablen-Arrays, welches in diesem Fall „ArrayVariable“ heißt.

Auf die Variable "array" können die in JavaScript verfügbaren Array-Funktionen angewandt werden. So kann zum Beispiel die Länge des Arrays oder der Wert eines bestimmten Array-Elements ausgelesen werden.

let arrayLength = array.length;                   //Länge des Arrays auslesen

let valueIndex1 = array[1];                   //Wert des Arrays am Index 1 auslesen

Möchte man nicht das gesamte Array der Variable auslesen, sondern lediglich ein einzelnes Array-Element, kann dies wie folgt geschehen:

Beispiel konkreter Index:

let arrElement = Tags(„ArrayVariable[2]“).Read();

Man kann anstelle eines festen Indexes auch eine Variable verwenden. Dazu wird folgende Schreibweiße verwendet:

Beispiel Variable als Index:

let i = 2;

let arrElement = Tags(„ArrayVariable[“+i+”]“).Read();

In beiden Fällen steht in der Variable "arrElement" der Wert der Variable „ArrayVariable“ an Index 2.

Schreiben eines Arrays:

Wenn nur einzelne Array-Elemente geschrieben werden sollen, gibt es wie beim Lesen zwei Möglichkeiten:

Beispiel konkreter Index:

Tags(„ArrayVariable[2]“).Write(10);     // Den Wert „10“ in das Array am Index 2 schreiben

Beispiel Variable als Index:

let i = 2;

Tags('ArrayVariable['+i+']').Write(10);     // Den Wert „10“ in das Array am Index 2 schreiben

Sollen alle Elemente eines Arrays geschrieben werden, wird empfohlen ein TagSet zu bilden.

Array mit TagSet schreiben:

Der Zugriff erfolgt mit einer besseren Performance und geringeren Kommunikationslast als beim Einzelzugriff auf mehrere Variablen und es werden alle Variablen gleichzeitig geschrieben:

Bild 2: Array mit TagSet schreiben

let tsSrc = Tags.CreateTagSet();

let tsDest = Tags.CreateTagSet();

for (let i = 0; i < (arrLength); i++) {

   // TagSet für Source bilden

   let nameSrc = "newSettings[" + i +"]";

   HMIRuntime.Trace("Name source field[" + i +"] = " + nameSrc);

   tsSrc.Add(nameSrc);

   // TagSet für destination bilden

   let nameDest = "currentSettings[" + i +"]";

   HMIRuntime.Trace("Name dest filed[" + i + "] = " + nameDest);

   tsDest.Add(nameDest);

   }

// Array "newSettings[]" mit Hilfe des TagSet "tsSrc" lesen

tsSrc.Read();

for (let i = 0; i < (arrLength); i++) {

   // Gelesene Werte aus Source ausgeben

   let srcVal = tsSrc('newSettings['+i+']').Value;

   HMIRuntime.Trace("Value source field[" + i +"] = " + srcVal);

   // Gelesene Werte aus Source in die Destination kopieren

   tsDest('currentSettings['+i+']').Value = srcVal;

   }

// Array "currentSettings[]" mit Hilfe des TagSet "tsDest" beschreiben 

tsDest.Write();

Hinweis:

Im folgenden Beispiel „Array mit Schleife schreiben“ ist aufgezeigt, wie es auch möglich wäre das Arrayschreiben über eine Schleife zu realisieren, in der Element für Element kopiert und geschrieben wird. Bei externen Variablen kann es allerdings zu Dateninkonsistenz kommen, wenn nicht alle Elemente gleichzeitig geschrieben werden. Gegenüber diesem einzelnen Lesen und Schreiben von Einzelvariablen, werden beim Schreiben über TagSet die Array-Werte konsistent und performant übertragen.

Array mit Schleife schreiben:

Im folgenden Beispiel werden alle Elemente des Arrays „newSettings“ in das Array „currentSettings“ kopiert.

let array = Tags('newSettings').Read();

let arrLength = array.length;

for (let i = 0; i < (arrLength); i++) {

   Tags('currentSettings['+i+']').Write(Tags('newSettings['+i+']').Read());

   }

Auch in diesem Beispiel werden alle Elemente des Arrays „newSettings“ in das Array „currentSettings“ kopiert.

Hinweis:

Die in diesem Artikel beschriebene Vorgehensweise bezieht sich auf den Zeitpunkt der Erstellung dieses Artikels (Stand: Februar 2024).

Viele Grüße

Eure Fachberatung Deutschland (JD)