Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > :PUT_VAR_COL

:PUT_VAR_COL

Script-Anweisung: Speichert einen Wert in eine bestimmte Spalte eines statischen Variablen-Objektes.

Syntax

:PUT_VAR_COL Variable, [Key], Column, Value

Syntax	Beschreibung/Format
Variable	Name des Variablen-Objektes, welcher ein Wert zugewiesen werden soll. Format: AE-Name oder Script-Variable
Key	Zeile, in welcher der Wert gespeichert werden soll. Format: Script-Literal, Script-Variable oder Scriptfunktion
Spalte	Nummer der Spalte, in die der Wert eingetragen wird. Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata Erlaubte Werte: Für Variablen-Objekt STATISCH: "1" bis "5" (Wert: numerisch) Für Variablen-Objekt XML: "1" (Format: numerisch)
Wert	Wert, der in die angegebene Zeile und Spalte der Variable geschrieben werden soll. Format: Script-Literal oder Script-Variable Für Variablen-Objekt XML: XPath-Ausdruck (Format: Zeichenkette)

Kommentare

Diese Script-Funktion trägt einen bestimmten Wert in der angegebenen Zeile und Spalte in ein Variablen-Objekt ein. Dabei werden im Gegensatz zum Script-Sprachmittel :PUT_VAR andere Felder nicht beeinflusst. Ist bereits ein Eintrag in der angegebenen Zeile/Spalte vorhanden, wird dieser Wert überschrieben.

Wird bei dem Script-Sprachmittel eine Dynamische Variable (Quelle: SQL, SQL-intern, Multi oder Datentyp) angegeben, führt dies zu einem Laufzeitfehler. Nur statische Variablen-Objekte können mit :PUT_VAR_COL befüllt werden.

Beachten Sie bei der Angabe der Spaltennummer, dass Variablen-Objekte vom Typ "statisch" nur 5 Werte-Spalten besitzen.

Bei Verwendung mit dem statischen Variablen-Objekt XML ist als Anzahl der Werte-Spalten nur "1" zulässig.

Es ist möglich, XPath-Anweisungen gemeinsam mit dem Variablen-Objekt XML zu verwenden, aber je nachdem, mit welcher Datenbank das Automation Engine System genutzt wird, kann die Funktionsweise einzelner XPath-Anweisungen abweichen. Wenden Sie sich in solchen Fällen bitte an den Lieferanten der Datenbank.

Bei Angabe der Spaltennummer ist der Bereich von "1" (Werte-Spalte 1) bis "5" (Werte-Spalte 5) erlaubt. Der Wert der Key-Spalte kann durch das Script-Sprachmittel nicht verändert werden.

Der Parameter Key ist nur dann optional, wenn eine statische Variable mit der Einstellung "Gültigkeitsbereich" - "Kein Key" verwendet wird. In diesem Fall besitzt die Variable nur einen Key (*).

Ist der angegebene Key noch nicht vorhanden, wird der Eintrag neu erstellt.

Beispiel

In folgendem Beispiel wird der Name der übergeordneten Aufgabe (Workflow) und die eigene RunID ermittelt. Danach wird die RunID unter dem Namen des Workflows in die Spalte 3 des Variablen-Objektes "VARA.JOBP" geschrieben.

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

Eine Verwendung dieser Skript-Anweisung zusammen mit dem Variablen-Objekt XML könnte sich folgendermaßen darstellen:

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

Siehe auch:

Script-Sprachmittel	Beschreibung
:PUT_VAR	Speichert Werte in ein statisches Variablen-Objekt.
:DELETE_VAR	Löscht einen oder alle Werte aus einem statischen Variablen-Objekt.
GET_VAR	Liefert den Inhaltseintrag eines Variablen-Objektes.
RESOLVE_VAR	Löst im Text jede Art von Variable auf (Aufforderungswerte, Systemvariablen, Script-Variablen, Variablen-Objekte).
:SET_SCRIPT_VAR	Setzt die Werte von Script-Variablen per indirektem Zugriff.
GET_SCRIPT_VAR	Liefert die Werte von Script-Variablen per indirektem Zugriff.
PREP_PROCESS_VAR und PREP_PROCESS_VAR_XML	Bereitet die Bearbeitung einer Datensequenz (Werte eines Variablen-Objektes) vor.

Script-Sprachmittel - Objekte lesen oder verändern

Variable

Beispielsammlung:
Darstellungen mittels Cockpit
Datenbankwartung mit Optionen
Aufruf eines MBeans

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