Festlegen des Wertes eines Elements in einem Indizierten Feld

Datensätze und Parameter › Prozessparameter › Berechnete Parameter › Zugriff auf Datensatzfelder in Ausdrücken › Festlegen des Wertes eines Elements in einem Indizierten Feld

Festlegen des Wertes eines Elements in einem Indizierten Feld

Um auf einen Wert in einem indizierten Feld (Array) zuzugreifen, verwenden Sie die folgende Syntax:

dataset_reference.indexed_field_name[index]

Der Parameter indexed_field_name definiert den Feldnamen im Datensatz. Index ist eine Ganzzahl, die ein indiziertes Element im Array anspricht.

Um die Zeichenfolge indexed_field_name mit der Klammernotation anzugeben, verwenden Sie die folgende Syntax. Im Beispiel ist indexed_field_name_expression ein CA Process Automation-Ausdruck, der die Zeichenfolge indexed_field_name zurückgibt.

dataset_reference[indexed_field_name_expression][index]

Wie im Fall von JavaScript-Arrays sind indizierte Felder in CA Process Automation Arrays von Arrays und keine wirklichen Arrays. Um auf ein Element in einem Array von Arrays zuzugreifen, verwenden Sie den [ ]-Operator zweimal. Zum Beispiel ist für das zweidimensionale indizierte Ganzzahlfeld namens "integers" jedes Listenelement "integers[x]" eine indizierte Liste mit Ganzzahlen. Um auf eine bestimmte Ganzzahl innerhalb des indizierten Feldes zuzugreifen, würden Sie den Ausdruck "integers[x][y]" schreiben. Im Allgemeinen verwenden Sie für jedes indizierte Feld mit n Dimensionen die folgende Syntax, um auf ein Datenelement zuzugreifen:

dataset_reference.indexed_field_name[index1][index2] ... [indexn]

Der Parameter index ist eine Ganzzahl oder ein Ausdruck, der eine Ganzzahl zurückgibt. Der Parameter hat einen Wert von 0 (für den ersten Wert in einer indizierten Liste) bis zur Länge der Liste minus 1. Die Auswertung des Index ist kreisförmig. Wenn also der Wert index die Länge einer indizierten Liste überschreitet, ermittelt folgende Formel den entsprechenden Wert:

Actual-index = index % length-of-the-list;

Mit anderen Worten erhalten Sie für n-Elemente in einem indizierten Feld die folgenden Ergebnisse:

Ein Index von n gibt das Element 0 zurück
Ein Index von n+1 gibt das Element 1 zurück
Ein Index von n-1 gibt das letzte Element zurück

Die folgende Tabelle veranschaulicht die Ergebnisse des Zugriffs auf Elemente eines indizierten Feldes in einem Prozessdatensatz:

Ausdruck	Beschreibung
value = Process.X[2]	Bezieht sich auf das dritte Element eines indizierten Feldes X des Prozessdatensatzes.
value = Process.X[18]	Für ein indiziertes Feld X mit einer Größe von 19 bezieht sich dieser Ausdruck auf das Element 19 von X, entsprechend Process.X[18].
value = Process.X[Process.Y + 2]	Ein Ausdruck berechnet den Index.
value = Process.A[5][2]	Gibt den Wert in einem zweidimensionalen Array zurück. Das dritte Element in der sechsten indizierten Liste, die das Array definiert, richtet sich an das Array.