:PUT_VAR_PROCESS

Verwenden Sie die Script-Anweisung :PUT_VAR_PROCESS, um ein statisches VARA-Objekt mit dem Inhalt einer Datensequenz auszufüllen. Statische VARA-Objekte beinhalten insgesamt sechs Spalten, die Spalte „Key“ sowie fünf Spalten vom Typ „Value“. Die Script-Anweisung :PUT_VAR_PROCESS füllt diese Spalten mit den ersten sechs Spalten der Datensequenz. Deshalb werden sie ignoriert, falls die Datensequenz mehr als sechs Spalten umfasst. Die Script-Anweisung :PUT_VAR_PROCESS entfernt alle Einträge des VARA-Objekts, bevor dieses neu gefüllt wird. Das Ergebnis ist, dass das VARA-Objekt nach erfolgreicher Ausführung dieser Script-Anweisung genau die Einträge der Datensequenz enthält.

Wichtig!

• Sie können keine dynamischen VARA-Objekte angeben, da diese ihre Werte dynamisch abrufen und nicht statisch speichern.
• Beachten Sie, dass bestimmte Regeln und Einschränkungen für die Werte von statischen VARA-Objekten gelten. Weitere Informationen finden Sie unter VARA-Objekt-Attribute.

Syntax

: PUT_VAR_PROCESS VARA-Objekt, Datensequenz-Referenz

Parameter

• :PUT_VAR_PROCESS
  Schreibt den Inhalt einer Datensequenz in ein statisches VARA-Objekt
• VARA object
  Name des statischen VARA-Objekts, in dem die Werte gespeichert werden sollten
  Format: AE-Name oder Script-Variable
• Datensequenz-Referenz
  Bezieht sich auf die Datensequenz, deren Inhalt in das VARA-Objekt geschrieben werden soll
  Sie können den Schlüssel FORCE_VARA_KEY_CI der Variablen UC_SYSTEM_SETTINGS verwenden, um kontextunabhängige Lese-/Schreibaktionen für STATIC VARA-Objekte beim Definieren des Schlüssels zu erzwingen. Weitere Informationen finden Sie unter FORCE_VARA_KEY_CI. Wenn die Variable auf "Y" festgelegt ist, wird der Schlüssel konvertiert und die Großschreibung wird beibehalten.
  Format: Script-Variable
  

Hinweis: Falls :PUT_VAR_PROCESS versucht, Variablenwerte einzutragen, die nicht akzeptiert werden, weil sie einen Schlüssel duplizieren oder es nur einen akzeptierten Eintrag gibt, gibt sie die Fehlernummer 20683 über sys_last_err_nr() und die Fehlerposition über sys_last_err_ins() zurück.

Beispiel

Das folgende Beispiel schreibt 1.000 Zeilen mit PUT_VAR_PROCESS:

:SET &HND# = PREP_PROCESS_VAR("VARA.PUT_VAR_PROCESS")

:SET &CNT# = 0
:WHILE &CNT# < 1000
: SET &CNT# = &CNT# + 1
: SET &KEY# = "KEY&CNT#"
: SET &COL1# = "COL1-&CNT#"
: SET &COL2# = "COL2-&CNT#"
: SET &COL3# = "COL3-&CNT#"
: SET &COL4# = "COL4-&CNT#"
: SET &COL5# = "COL5-&CNT#"
: SET &LINE# = "&KEY#§§§&COL1#§§§&COL2#§§§&COL3#§§§&COL4#§§§5"
: SET &RET# = PUT_PROCESS_LINE(&HND#, "&LINE#")
:ENDWHILE

:PUT_VAR_PROCESS "VARA.PUT_VAR_PROCESS",&HND#
:CLOSE_PROCESS &HND#

Siehe auch: