Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > :FILL

:FILL

Script-Anweisung: Speichert mehrere Werte in ein Script-Array.

Syntax

:FILL script array =values

Syntax	Beschreibung/Format
Script-Array	Name der Script-Variable, die als Array definiert wurde. Die Indexklammern sind dabei ohne Inhalt anzugeben. Format: Script-Variable
Werte	Werte, die in das Array gespeichert werden sollen. Dazu sind die Script-Funktionen GET_PROCESS_LINE oder GET_VAR zu verwenden. Format: Script-Funktion

Anmerkungen

Die Script-Funktion dient dazu, um mehrere Werte gleichzeitig in ein Script-Array abzulegen. Arrays müssen vor der Wertezuweisung mit :DEFINE unter Angabe der Array-Größe erstellt werden. Für die Übergabe der Werte sind die Script-Funktionen GET_PROCESS_LINE, STR_SPLIT oder GET_VAR zu verwenden. Die Werte werden dabei immer ab dem ersten Elemente (Index = 1) in das Array geschrieben.

Übersteigt die Anzahl der zu speichernden Werte die Kapazität des Arrays, werden nur die ersten Werte abgelegt, die Platz im Array finden. Ist das Array größer als die ermittelten Werte, bleiben die restlichen Werte unverändert.

Das Script-Array ist für die Funktion mit leeren Indexklammern [] anzugeben.

Verwenden Sie :PUBLISH, um Arrays an unter- und übergeordnete Objekte weiter zu geben.

Beispiel

Im ersten Beispiel werden Werte eines Variablen-Objektes mit GET_VAR in das Array gespeichert.

:DEFINE &ARRAY#, string, 20
:FILL &ARRAY#[] = GET_VAR(VARA.TEST, KEY1)
:PRINT"Erster Wert der Variable VARA.TEST des Keys KEY1: &ARRAY#[1]"

Im zweiten Beispiel werden die Spalten der ersten Zeile einer Log-Datei (Automation Engine) in das Array angelegt.

:DEFINE &ARRAY#, string, 20
:SET &HND# = PREP_PROCESS_FILE(WIN01, "C:\AUTOMIC\AUTOMATIONENGINE\TEMP\CPsrv_log_001_00.txt","*","COL=LENGTH""LENGTH_TAB,,,='8=DATE,1,6=TIME,7,200=TEXT'")
:PROCESS &HND#
:FILL &ARRAY#[] = GET_PROCESS_LINE(&HND#)
:ENDPROCESS

:SET &RUNVAR# = 1
:SET &LEN# = LENGTH(&ARRAY#[])

:WHILE &RUNVAR# LE &LEN#
:P "Line &RUNVAR#: &ARRAY#[&RUNVAR#]"
:SET &RUNVAR# = &RUNVAR# + 1
:ENDWHILE

Siehe auch:

Script-Sprachmittel	Beschreibung
:PUBLISH	Script-Variablen und Arrays als Objektvariablen definieren.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.
GET_VAR	Liefert den Inhaltseintrag eines Variablen-Objektes.
FIND	Durchsucht ein Script-Array und liefert den entsprechenden Index zurück.
LENGTH	Ermittelt die Größe eines Script-Arrays.

Script-Sprachmittel - Datensequenzen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support