:PUT_VAR_COL

Verwenden Sie die Script-Anweisung :PUT_VAR_COL, um einen bestimmten Wert in eine angegebene Zeile und Spalte eines statischen VARA-Objekts zu schreiben. Anders als bei der Script-Anweisung :PUT_VAR sind davon andere Felder nicht betroffen. Falls die angegebene Zeile oder Spalte bereits einen Eintrag enthält, wird der entsprechende Wert überschrieben.

Wichtig!

• Die Angabe eines dynamischen VARA-Objekts in diesem Script-Element mit SQL-, internen SQL-, Multi- oder Datentypquellen führt zu einem Laufzeitfehler.
• 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 an den Datenbankhersteller.

Syntax

: PUT_VAR_COL VARA object, [Key], Column, Value

Parameter

• :PUT_VAR_COL
  Speichert einen Wert in einer bestimmten Spalte eines statischen VARA-Objekts
• VARA object
  Name des VARA-Objekts, dem ein Wert zugeordnet werden soll.
  Format: AE Name oder Script-Variable
• Key
  (Optional) Zeile, in welcher der Wert gespeichert werden soll. Ist der angegebene Schlüssel noch nicht vorhanden, wird der Eintrag neu erstellt. Dieser Parameter ist nur optional, falls Sie ein statisches VARA-Objekt mit der Gültigkeitsbereich-Einstellung Kein Gültigkeitsbereich auf der zugehörigen Seite „Attribute“ verwenden. In solch einem Fall enthält das VARA-Objekt nur ein Sternchen (*) als Schlüssel.
  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-Literal, Script-Variable oder Script-Funktion
  
• Column
  Nummer der Spalte, in die der Wert eingetragen wird.
  Format: Script-Literal, Script-Variable oder eine Zahl ohne Anführungszeichen
  Zulässige Werte:
  • 1-5
    Für statische VARA-Objekte
    Nummer 1 bezieht sich auf die Spalte „Value 1“, Nummer 2 auf die Spalte „Value 2“ usw. Statische VARA-Objekte enthalten maximal 5 Wertespalten.
    Format: numerisch
    Hinweis: Sie können den Wert der Spalte „Key“ eines statischen VARA-Objekts mit dieser Script-Anweisung nicht ändern.
    
  • Ein gültiger XPath-Ausdruck
    Für XML-VARA-Objekte
    Format: String
    
• Value
  Wert, der in die angegebene Zeile und Spalte der Variablen geschrieben werden soll.
  Format: Script-Literal oder Script-Variable
  Zulässiger Wert:
  • XPath-Ausdruck
    Für XML-VARA-Objekte
    Format: String

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. Im folgenden Beispiel wird davon ausgegangen, dass VARA.XML.TEST2 den Schlüssel KEY3 enthält und der Wert des Schlüssels <test><value1>oldvalue</value1></test> lautet. 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: