:PUT_VAR_COL

Script-Anweisung: Speichert einen Wert in einer bestimmten Spalte eines statischen VARA-Objekts.

Syntax

: PUT_VAR_COL VARA-Objekt, [Schlüssel], Spalte, Wert

Syntax	Beschreibung/Format
VARA-Objekt	Name des VARA-Objekts, welchem ein Wert zugewiesen werden soll. Format: AE-Name oder Script-Variable
Schlüssel	Zeile, in welcher der Wert gespeichert werden soll. Format: Script-Literal, Script-Variable oder Script-Funktion
Spalte	Nummer der Spalte, in die der Wert eingetragen wird. Format: Script-Literal, Script-Variable, eine Zahl ohne Anführungszeichen Zulässige Werte: Bei statischen VARA-Objekten: "1" bis "5" (Format: numerisch) Für XML-VARA-Objekte: Ein gültiger XPath-Ausdruck (Format: String)
Wert	Wert, der in die angegebene Zeile und Spalte der Variablen geschrieben werden soll. Format: Script-Literal oder Script-Variable Für XML-VARA-Objekte: xpath-Ausdruck (Format: String)

Diese Script-Funktion trägt einen bestimmten Wert in der angegebenen Zeile und Spalte in ein VARA-Objekt ein. Dabei werden im Gegensatz zum Script-Element :PUT_VAR andere Felder nicht beeinflusst. Wenn die angegebene Zeile bzw. Spalte bereits einen Eintrag enthält, wird der entsprechende Wert überschrieben.

Achtung!

• Die Angabe eines dynamischen VARA-Objekts in diesem Script-Element (Quelle: SQL, SQL-intern, Multi oder Datentyp) führt zu einem Laufzeitfehler. Nur statische VARA-Objekte können unter Verwendung von :PUT_VAR_COL gefüllt werden.
• Wenn Sie die Spaltennummer angeben, beachten Sie, dass statische VARA-Objekte nur 5 Wertspalten enthalten.
• Bei Verwendung mit dem statischen XML-VARA-Objekt ist die Anzahl der Wertespalten nur "1".
• Es ist möglich, XPath-Anweisungen mit dem XML-VARA-Objekt zu verwenden. Je nachdem, mit welcher Datenbank das Automation Engine-System genutzt wird, kann jedoch die Funktionsweise einzelner XPath-Anweisungen abweichen. Wenden Sie sich in solchen Fällen bitte an den Lieferanten der Datenbank.

Hinweise:

• Bei Angabe der Spaltennummer ist der Bereich von "1" (Werte-Spalte 1) bis "5" (Werte-Spalte 5) erlaubt. Der Wert der Schlüsselspalte kann durch das Script-Element nicht verändert werden.
• Der Parameter Schlüssel ist nur dann optional, wenn ein statisches VARA-Objekt mit der Einstellung "Gültigkeitsbereich" - "Kein Gültigkeitspasswort" verwendet wird. In diesem Fall beinhaltet die Variable nur den Schlüssel (*).
• Ist der angegebene Schlüssel noch nicht vorhanden, wird der Eintrag neu erstellt.

Beispiel 1

Das folgende Beispiel ruft den Namen der übergeordneten Aufgabe (Workflow) und die eigene RunID der Aufgabe ab. Anschließend wird die RunID unter dem Workflow-Namen in Spalte 3 des VARA-Objekts "VARA.JOBP" eingetragen.

:SET &JOBP# = SYS_ACT_PARENT_NAME()
:SET &RUNID# = SYS _ACT_ME_NR()
:PUT_VAR_COL VARA.JOBP, &JOBP#, "3", &RUNID#

Beispiel 2

Für die Verwendung von :PUT_VAR_COL zum Ändern des XML-Inhalts ist ein Schlüssel erforderlich, der bereits im XML-VARA-Objekt vorhanden ist. Nehmen wir an, dass "VARA.XML.TEST2" den Schlüssel KEY3 enthält, und der Wert des Schlüssels ist <test> <value1>oldValue</value1> </test>. Sie können nun den XML-Inhalt wie unten dargestellt ändern, und "oldValue" wird durch den neuen Wert "test" ersetzt:

: PUT_VAR_COL VARA.XML.TEST2, "KEY3", "test/value1", "test"

Siehe auch: