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

GET_VAR

Script-Funktion: Liefert den Wert eines Variablen-Objektes.

Syntax

GET_VAR(Variable, [Key, Column], [XPath/XQuery])

Syntax	Beschreibung/Format
Variable	Name eines Variablen-Objektes, deren Werte ausgelesen werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Key	Zeile der Variable Wert der Key-Spalte (statische Variablen) bzw. der ersten Rohspalte (dynamische Variablen) Format: AE-Name, Script-Literal oder Script-Variable
Spalte	Nummer der Spalte, dessen Wert(e) verwendet werden soll(en). Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata Erlaubte Werte: Statische Variablen: "KEY" (Key-Spalte), "1" bis "5" (Wertespalte 1 bis 5) Dynamische Variablen: "RESULT" (Result-Spalte), "1" bis n (Wertespalte 1 bis n)
XPath/XQuery	Verwenden Sie einen XPath- oder XQuery-Ausdruck für den Zugriff und das Auslesen von Knoten oder Inhalt der XML-Daten. Wenn Sie keinen Ausdruck eingeben, wird der volle Spalteninhalt ausgegeben. Diese Funktion kann nur mit dem statischen Variablen-Objekt XML verwendet werden. 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.

Rückgabewerte
Wert/e der Variable " " - Der Eintrag existiert nicht bzw. enthält keinen Wert.

Kommentare

Mit dem Scriptsprachmittel können Werte sowohl aus statischen als auch dynamischen Variablen-Objekten gelesen werden. Beim Zugriff auf dynamische Variablen erfolgt eine Auflösung, daher wird der Wert direkt aus der Datenquelle (Datenbank, Variable, Verzeichnis) ermittelt.

Kommt es aus irgendeinem Grund zu einem Fehler bei der Auflösung von dynamischen Variablen-Objekten, so führt dies zu einem Laufzeitfehler!

Wenn kein Key für ein statisches Variablen-Objekt festgelegt ist, wählt das System automatisch den Key auf Basis der Einstellung Gültigkeitsbereich in der Registerkarte des Variablen-Objekts aus. In allen anderen Fällen, in denen kein Key angegeben wird, wird automatisch die erste Zeile verwendet. Bei statischen Variablen-Objekten, die als Gültigkeitsbereich "Frei gewählt" eingestellt haben, ist der Key allerdings immer anzugeben!
Fehlt die Spalte, so wird automatisch die Spalte Wert 1 (bei statischen Variablen-Objekten), die Result-Spalte (Variablen-Quelle: SQL, SQL-intern, Multi) oder die Spalte Dateiliste (Variablen-Quelle: Dateiliste).

Bei Variablen mit der Quelle „Dateiliste“ ist Spalte entweder auszulassen oder der Wert "1" zu verwenden. Da es nur eine Spalte gibt, entspricht der angegebene Key dem zurückgelieferten Wert.

Als Wert für Spalte ist der Bereich von 1 (erste Wertespalte) bis zur letzten Spaltennummer der Variable erlaubt. Um die Result-Spalte (dynamische Variablen außer "Dateiliste") auszulesen, ist der Wert "RESULT" für die Spalte zu verwenden. Beachten Sie, dass statische Variablen maximal 5 Werte-Spalten besitzen. Wird das Sprachmittel im Zusammenhang mit :FILLverwendet und keine Spalte angegeben, so werden alle Werte der Variablen-Zeile in das Script-Array gespeichert.

Das Format des Wertes entspricht dem Ausgabeformat, das über die Registerkarte Attribute festgelegt wurde.

Mit der Script-Funktion können auch die sogenannten Agent-Variablen ausgelesen werden.

Um auf einen Key zuzugreifen, der mit dem Zeichen & beginnt, ist dieses Zeichen doppelt anzugeben. Andernfalls wird dieser Ausdruck als Script-Variable interpretiert und versucht diese aufzulösen.

Beispiel: Zugriff auf den Key "&key" im Variablen-Objekt VARA.TEST
:SET &TEST# = GET_VAR(VARA.TEST,"&&key")

Wenn Sie GET_VAR für einen nicht vorhandenen Key verwenden, wird ein Leerzeichen zurückgegeben.

Bei dynamischen Variablen ist der Wert der Result-Spalte (Parameter Key) in dem Format anzugeben, welches der Wert in der Datenquelle (SQL - Datenbank, MULTI - Variablen-Objekt) aufweist. Das Ausgabeformat der Variable spielt dabei keine Rolle!

Bei statischen Variablen kann für Spalte auch der spezielle Wert "KEY" angegeben werden. Mit diesem haben Sie die Möglichkeit zu prüfen, ob ein bestimmter Key in dem Variablen-Objekt existiert. Liefert das Sprachmittel einen leeren Wert, existiert der Key nicht. Wird der Key zurückgegeben, so ist der Eintrag vorhanden.

In folgendem Beispiel liefert das Sprachmittel "Test", wenn der Key existiert, "" wenn nicht:

:SET &KEY# = GET_VAR(VARA.TEST, "Test","KEY")

Wenn Sie diese Script-Funktion mit dem statischen Variablen-Objekt XML verwenden, werden die Werte automatisch für den XML-Datentyp aufbereitet. Sie können also XML zum Beispiel in einer einzelnen Script-Zeile verwenden, in der resultierenden Script-Ausgaben wird der Wert jedoch nach dem XML-Standard neu angeordnet.

Beispiele

Das Beispiel ermittelt den Wert aus einer Variablen und übergibt ihn an eine Script-Variable.

:SET &TEST# = GET_VAR(MM.END.PROCESSING, "BookingDate")

Auch die Verwendung von Script-Variablen innerhalb der Funktion ist möglich.:

:SET &VAR# = "MM.END.PROCESSING"
:SET &VAL# = "BookingDate"
:SET &TEST# = GET_VAR(&VAR#, &VAL#)

In diesem Beispiel wird die Funktion verwendet, um eine Bedingung zu formulieren.

:IF GET_VAR(MM.END.PROCESSING, "BookingDate") = SYS_DATE("DDMMYY")
!...
:ENDIF

Siehe auch:

Script-Sprachmittel	Beschreibung
:DELETE_VAR	Löscht einen oder alle Werte aus einem statischen Variablen-Objekt.
:PUT_VAR	Speichert Werte in ein statisches Variablen-Objekt.
:SET_SCRIPT_VAR	Setzt die Werte von Script-Variablen per indirektem Zugriff.
GET_SCRIPT_VAR	Liefert die Werte von Script-Variablen per indirektem Zugriff.
RESOLVE_VAR	Löst im Text jede Art von Variable auf (Aufforderungswerte, Systemvariablen, Script-Variablen, Variablen-Objekte).
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

Agent-Variablen

Beispielsammlung:
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