GET_SCRIPT_VAR

Verwenden Sie die Script-Funktion GET_SCRIPT_VAR, um die Werte verschiedener Script-Variablen abzufragen, ohne mehrere bedingte Anweisungen zu schreiben. Diese Funktion verwendet einen Platzhalter, um die Werte von Script-Variablen indirekt zurückzugeben. Sie müssen die Namen der Script-Variablen nicht direkt in Ihrem Script festlegen, da der Platzhalter als Variable wirkt. Mit dieser Funktion können Sie die Werte mehrerer Variablen mit einer einzigen Script-Zeile abfragen und sie ist bei der Verarbeitung von Schleifen nützlich. Der von Ihnen definierte Platzhalter ist ein String, derden Namen einer oder mehrerer Variablen enthält, deren Werte Sie zurückgeben möchten.

Die Script-Funktion ruft Werte aus den folgenden Objekttypen ab:

• VARA-Objekte
• Objektvariablen
• PromptSet-Variablen

Syntax

GET_SCRIPT_VAR (Script-Variable)

Parameter

• GET_SCRIPT_VAR
  Gibt Werte der Script-Variablen zurück Format: AE-Name, Script-Literal oder Script-Variable

• Script-Variable
  Platzhalter für die Namen von Script-Variablen, die zurückgegeben werden sollen
  Format: AE-Name, Script-Literal oder Script-Variable
  Hinweise:
  

  • Starten Sie den Platzhalter nicht mit einem kaufmännischen Und-Zeichen (&), da dieses Zeichen für Variablennamen verwendet wird.
  • Befolgen Sie die anderen Regeln für die Benennung von Variablen. Weitere Informationen finden Sie unter Variablennamen.
  • Sie müssen den genauen Variablennamen übergeben, andernfalls schlägt das Script fehl.
    

Wichtig!

• Wenn die Script-Variable nicht eindeutig identifiziert werden kann, liest das System den Wert der ersten anwendbaren Variablen aus.
• Der Variablenname wird ab & oder dem Zeichen danach gesucht. Wenn der von Ihnen angegebene String nicht mit den Anfangszeichen eines Variablennamens übereinstimmt, tritt ein Fehler auf.

Beispiel

In diesem Beispiel wird ein Script in einem Auftrag verwendet, um Namen und Werte aus einem VARA-Objekt abzurufen, das SCRIPT_VARA genannt wird. Das Script gibt die abgerufene Namen im Aktivierungsreport aus. Angenommen, das VARA-Objekt enthält die folgenden Script-Variablennamen:

• End#
• Start#
• Ultimo#

Schreiben Sie das folgende Script in den Job:

: SET   &END#    = "20051027"
: SET   &START#  = "20051024"
: SET   &ULTIMO# = "20051031"  

: SET   &HANDLE# = PREP_PROCESS_VAR ( "SCRIPT_VARA" )    

: PROCESS   &HANDLE#
:    SET   &VARIABLE# = GET_PROCESS_LINE ( &HANDLE# ,1)
:    SET   &VALUE# = GET_SCRIPT_VAR ( &VARIABLE# )
:    PRINT   "&VARIABLE# = &VALUE#"
: ENDPROCESS

: CLOSE_PROCESS   &HANDLE#

Wobei:

• :SET

  Weist einer Script-Variablen einen Wert zu

• PREP_PROCESS_VAR

  Ruft eine Liste von Werten aus einem VARA-Objekt ab

  Die abgerufenen Werte werden als Datensequenz zur internen Weiterverarbeitung bereitgestellt.

• :PROCESS ... :ENDPROCESS
  Definiert eine Schleife für die zeilenweise Verarbeitung einer Datensequenz

• GET_PROCESS_LINE
  Ruft den Inhalt der aktuellen Zeile einer Datensequenz ab

• GET_SCRIPT_VAR
  Ruft Werte für mehrere Script-Variablen ab

• :PRINT
  Zeilen werden im Aktivierungsreport ausgegeben

• :CLOSE_PROCESS
  Verwirft eine Datensequenz innerhalb eines Scripts

Das Script liest die Namen der Script-Variablen aus dem VARA-Objekt. Der Variablenname wird an eine Script-Variable mit dem Namen &VALUE# übergeben. Eine :PRINT-Anweisung verwendet die Variable &VALUE#, um die Werte für END#, &START# und &ULTIMO# in den Aktivierungsreport zu schreiben.

Die folgenden Zeilen werden in den Aktivierungsreport geschrieben:

2005-02-03 12:51:23 - U0020408 End = 20051027
2005-02-03 12:51:23 - U0020408 Start = 20051024
2005-02-03 12:51:23 - U0020408 Ultimo = 20051031

Siehe auch: