Verwenden Sie die Script-Funktion GET_VAR, um einen Wert aus einem statischen oder dynamischen Variablenobjekt oder aus einer Agentenvariablen zurückzugeben. Wenn Sie mit dieser Funktion auf eine dynamische Variable zugreifen, wird der Wert aufgelöst. Der Wert wird direkt aus der Datenquelle (Datenbank, Variable oder Verzeichnis) abgerufen.
Mehr Informationen:
Syntax
GET_VAR (Variable[, Key [, Column [,XPath|XQuery]]])
Parameter
- GET_VAR
Ruft den Wert aus einem Variablenobjekt ab - Variable
Name des Variablenobjekts, aus dem Sie den Wert abrufen möchten
Format: AE-Name, Script-Literal oder Script-Variable - Key
Variable Zeile zum Abrufen des Wertes
Format: AE-Name, Script-Literal oder Script-Variable - Column
Nummer der Spalte, aus der der Wert abgerufen werden soll
Format: Script-Literal, Script-Variable oder Zahl mit Hochkommata
Erlaubte Werte:- Statische Variablenobjekte: "KEY" (Key-Spalte), "1" bis "5" (Wertespalte 1 bis 5)
- Dynamische Variablenobjekte: RESULT (Ergebnisspalte, außer bei Variablenobjekten der FILELIST), 1 bis n (Wertespalte 1 bis n)
- XPath|XQuery
Ausdruck zum Zugriff und Auslesen auf/von Knoten oder Inhalten von XML-Daten
Wenn Sie keinen Ausdruck eingeben, wird der gesamte Inhalt der Spalte zurückgegeben.
Wichtig:- Verwenden Sie diese Funktion nur mit dem XML-Variablenobjekt.
- Sie können XPath-Ausdrücke mit dem XML-Variablenobjekt verwenden, aber sie können je nach Datenbank unterschiedlich funktionieren. Lesen Sie die vom Datenbankhersteller bereitgestellte Dokumentation.
Rückgabewerte
Die Script-Funktion hat die folgenden Rückgabewerte:
- Werte der Variablen
- " " - Der Eintrag existiert nicht oder enthält keinen Wert
Hinweise:
- Wenn Sie keinen Schlüsselparameter angeben, wird die erste Zeile verwendet.
- Wenn Sie auch die Spalte nicht angeben, verwendet das System je nach Art der Quelle automatisch eine Spalte:
- Statische Variablenobjekte: Wert 1 Spalte
- SQL, SQLI, MULTI Variablenobjekt: Ergebnisspalte
- FILELIST Variablenobjekt: Dateilistenspalte
Sie können die Spalte entweder überspringen oder den Wert 1 verwenden. Der angegebene Schlüssel stimmt mit dem zurückgegebenen Wert überein, weil nur eine einzige Spalte vorhanden ist.
- Das Format des zurückgegebenen Wertes entspricht dem Ausgabeformat, das auf der Seite Attribute in der Objektdefinition eingestellt ist. Weitere Informationen finden Sie auf der Seite Seite „Attribute“. Geben Sie bei dynamischen Variablen den Wert der Ergebnisspalte (Parameter Line ) in dem Format an, in dem er in der Datenquelle (SQL - Datenbank, MULTI - Variablenobjekt) angezeigt wird. Das Ausgabeformat der Variablen ist in diesem Fall irrelevant.
- Wenn Sie diese Script-Funktion mit einem statischen XML-Variablenobjekt verwenden, werden die Werte für den XML-Datentyp automatisch verschönert. Sie können XML in einer einzigen Script-Zeile verwenden, aber bei der Ausgabe des Ergebnis-Scripts wird der Wert entsprechend dem XML-Standard neu angeordnet.
Wichtig!
- Ein Fehler, der bei der Auflösung dynamischer Variablenobjekte auftritt, führt zu einem Laufzeitfehler.
- Schreiben Sie das kaufmännische Und-Zeichen zweimal, wenn Sie auf einen Schlüssel zugreifen möchten, der mit & beginnt. Andernfalls interpretiert das System den Begriff als Script-Variable und versucht nicht, ihn zu lösen.
Beispiel: Die folgende Script-Zeile greift auf einen Schlüssel namens „&key“ in einem Variablenobjekt namens VARA.TEST zu.
:SET &TEST# = GET_VAR(VARA.TEST,"&&key") - Die Verwendung einer GET_VAR-Funktion für einen nicht existierenden Schlüssel gibt ein Leerzeichen zurück.
Tipps:
- Verwenden Sie die Script-funktion GET_VAR in Kombination mit der :FILL-Anweisung, um alle Werte einer Zeile in ein Script-Array zu schreiben. Weitere Informationen finden Sie unter :FILL.
- Mit der GET_VAR-Funktion können Sie überprüfen, ob ein bestimmter Schlüssel in einem statischen Variablenobjekt existiert. Geben Sie als Spalte den Schlüssel an, den Sie überprüfen möchten. Wenn der Schlüssel nicht existiert, gibt die Script-Funktion einen leeren Wert zurück. Wenn der Schlüssel vorhanden ist, gibt die Funktion den Schlüssel zurück.
Beispiel: Die folgende Script-Zeile gibt den Wert „Test“ zurück, wenn der Schlüssel existiert, und " ", wenn es keinen Schlüssel gibt.
:SET &KEY# = GET_VAR(VARA.TEST, "Test","KEY")
Beispiele
Das Beispiel ermittelt den Wert aus einer Variablen und übergibt ihn an eine Script-Variable.
:SET &TEST# = GET_VAR(MM.END.PROCESSING, "BookingDate")
Das folgende Beispiel verwendet Script-Variablen in der GET_VAR-Funktion:
:SET &VAR# = "MM.END.PROCESSING"
:SET &VAL# = "BookingDate"
:SET &TEST# = GET_VAR(&VAR#, &VAL#)
Das folgende Beispiel verwendet die Script-Funktion GET_VAR in einer Bedingung:
:IF GET_VAR(MM.END.PROCESSING,
"BookingDate") = SYS_DATE("DDMMYY")
!...
:ENDIF
Siehe auch: