GET_VAR

Verwenden Sie die Script-Funktion GET_VAR, um einen Wert aus einem statischen oder dynamischen VARA-Objekt oder aus einer Agentenvariablen zurückzugeben. Wenn Sie mit dieser Funktion auf ein dynamisches VARA-Objekt zugreifen, wird der Wert aufgelöst. Der Wert wird direkt aus der Datenquelle (Datenbank, Variable oder Verzeichnis) abgerufen.

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 VARA-Objekt 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 ein Leerzeichen, wenn es keinen Schlüssel gibt.
  :SET &KEY# = GET_VAR(VARA.TEST, "Test","KEY")

Mehr Informationen:

• Benutzerdefinierte VARA-Objekte
• Liste der Agentenvariablen

Syntax

Die Syntax für diese Script-Funktion hängt vom Typ des VARA-Objekts ab, aus dem der Wert abgerufen werden soll. Bei statischen VARA-Objekten und XML VARA-Objekten hat der für das VARA-Objekt definierte Bereich auch eine Wirkung. Weitere Informationen finden Sie unter STATIC VARA-Objekte.

Statisches VARA-Objekt

• Gültigkeitsbereich: frei gewählt
  GET_VAR (VARA, Schlüssel[, Spalte])
  
• Jeder andere Gültigkeitsbereich
  GET_VAR (VARA [, Schlüssel] [, Spalte])

XML VARA-Objekt

• Gültigkeitsbereich: frei gewählt
  GET_VAR (VARA, Schlüssel [, XPath|XQuery])
• Jeder andere Gültigkeitsbereich
  GET_VAR (VARA [, Schlüssel] [, XPath|XQuery])

Dynamisches VARA-Objekt

• GET_VAR (VARA [, Schlüssel] [, Spalte])

Parameter

• GET_VAR
  Ruft den Wert eines VARA-Objekts ab

• VARA
  Name des VARA-Objekts, aus dem der Wert abgerufen werden soll
  Format: AE-Name, Script-Literal oder Script-Variable

• Schlüssel
  Variablenzeile, aus der der Variable abgerufen werden soll
  Format: AE-Name, Script-Literal oder Script-Variable
  Hinweis: Schreiben Sie das kaufmännische Und 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 mit dem Namen &key in einem VARA-Objekt mit dem Namen VARA.TEST zu.
  :SET &TEST# = GET_VAR(VARA.TEST,&&key)

• Spalte oder XPath oder XQuery
  (Optional) Gibt den abzurufenden Inhalt an, je nach Typ des VARA-Objekts

  • (Statisches oder dynamisches VARA-Objekt) Nummer der Spalte, aus der der Wert abgerufen werden soll
  • (XML VARA-Objekt) XPath-oder XQuery-Ausdruck zur Auswahl einer Teilmenge von XML-Inhalten
  Format: Script-Literal, Script-Variable oder Zahl in Anführungszeichen
  Zulässige Werte:
  • Statisches VARA-Objekt:
    • KEY (Schlüsselspalte)
    • 1 bis 5 (Wertspalte 1 bis 5)
  • Dynamisches VARA-Objekt:
    • RESULT (Ergebnisspalte, außer für FILELIST VARA-Objekte)
    • 1 bis n (Wertspalte 1 bis n)
    • FILELIST VARA-Objekte: Lassen Sie die Spalte weg oder verwenden Sie den Wert 1
  • XML VARA-Objekt:
    • XPath-Ausdruck
    • XQuery-Ausdruck
    Hinweis: Wenn Sie keinen Ausdruck eingeben, wird der gesamte Inhalt der Spalte zurückgegeben.
    Wichtig: Sie können XPath-Ausdrücke mit dem XML VARA-Objekt verwenden, aber sie können je nach Datenbank unterschiedlich funktionieren. Lesen Sie die vom Datenbankhersteller bereitgestellte Dokumentation.

Wichtig! Ein Fehler, der bei der Auflösung dynamischer VARA-Objekte auftritt, führt zu einem Laufzeitfehler.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Der aus dem VARA-Objekt abgerufene Wert
• Ein einzelnes Leerzeichen, wenn der Eintrag nicht vorhanden ist oder keinen Wert enthält
  Tipp: Verwenden Sie die Script-Zugriffseinstellung des VARA-Objekts, um zu definieren, was geschieht, wenn der angegebene Schlüssel nicht verfügbar ist. Weitere Informationen finden Sie unter Script-Zugriff.

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".

Je nach Typ des VARA-Objekts und Gültigkeitsbereich, sofern zutreffend, gelten die folgenden Verhaltensweisen.

Statisches VARA-Objekt

• Frei ausgewählter Gültigkeitsbereich: Sie müssen den Schlüssel in der Script-Funktion definieren, und GET_VAR gibt den Wert basierend auf diesem Schlüssel zurück.
• Anderer Gültigkeitsbereich: Der Bereich bestimmt, welcher Schlüssel verwendet wird, um den Wert zurückzugeben.
• Wenn Sie keine Spalte angeben, gibt GET_VAR die erste Spalte zurück.

Dynamisches VARA-Objekt

• Wenn Sie keinen Schlüssel angeben, gibt GET_VAR die erste Zeile zurück.
• Wenn Sie keine Spalte angeben, gibt GET_VAR die erste Spalte zurück:
  • SQL-, SQLI- und MULTI VARA-Objekte: Ergebnisspalte
  • FILELIST VARA-Objekte: Spalte FILE LIST
    

XML VARA-Objekt

• Frei ausgewählter Gültigkeitsbereich: Sie müssen den Schlüssel in der Script-Funktion definieren, und GET_VAR gibt den Wert basierend auf diesem Schlüssel zurück.
• Anderer Gültigkeitsbereich: Der Bereich bestimmt, welcher Schlüssel verwendet wird, um den Wert zurückzugeben.
• Wenn Sie nicht XPath oder XQuery angeben, gibt GET_VAR das gesamte XML-Dokument (den Inhalt des Felds Wert für den ausgewählten Schlüssel) zurück.
• Wenn Sie diese Script-Funktion mit einem statischen XML VARA-Objekt 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.
  

Beispiele

Das folgende Beispiel ruft einen Wert aus einem VARA-Objekt ab 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: