GET_SCRIPT_VAR
Verwenden Sie die GET_SCRIPT_VARScript-Funktion, 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 ist bei der Verarbeitung von Schleifen nützlich. Der von Ihnen definierte Platzhalter ist eine Zeichenkette, die den Namen einer oder mehrerer Variablen enthält, deren Werte Sie zurückgeben möchten.
Die Script-Funktion ruft Werte aus den folgenden Objekttypen ab:
- Variablenobjekte
- Objektvariablen
- PromptSet-Variablen
Syntax
GET_SCRIPT_VAR (Script variable)
Parameter
- GET_SCRIPT_VAR
Gibt Werte von Script-Variablen zurück - Script variable
Platzhalter für die Namen der zurückzugebenden Script-Variablen- 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.
- Fügen Sie so viele Anfangszeichen ein, wie erforderlich sind, um die Variable eindeutig zu identifizieren. Mit :SET_SCRIPT_VAR identifizieren Sie die Variable und fügen Sie Zeichen hinzu, um den vollständigen Namen zu generieren.
- Format: AE-Name, Script-Literal oder Script-Variable
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 die von Ihnen angegebene Zeichenkette 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 Variablenobjekt abzurufen, das SCRIPT_VARA genannt wird. Das Script gibt die abgerufene Namen im Aktivierungsreport aus. Angenommen, das Variablenobjekt 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 Variablenobjekt 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 Variablen-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:
sieheauch1