FIND

Script-Aufbau und -Prozessierung

LENGTH

---

GET_SCRIPT_VAR

Script-Funktion: Liefert die Werte von Script-Variablen per indirektem Zugriff.

Syntax

GET_SCRIPT_VAR(Script variable)

Anmerkungen

Die Script-Funktion liest die Werte von Script-Variablen, ohne dass dabei die Namen der Script-Variablen explizit angegeben werden müssen. Auf die Script-Variablen wird indirekt über einen Platzhalter, man könnte ihn selbst eine Variable nennen, zugegriffen. Dadurch ist es möglich, komfortabel die Werte vieler Script-Variablen, beispielsweise in einer Prozess-Schleife, abzufragen. Die Script-Funktion ersetzt so viele bisher notwendige Bedingungsanweisungen durch eine einzige Script-Zeile.

Der Script-Funktion wird mit Script-Variable eine Zeichenkette übergeben, aus welcher der Name einer Script-Variable gebildet wird. Dabei ist es nicht notwendig, dass die Zeichenkette bereits mit einem "&" beginnt, wodurch eine Script-Variable gekennzeichnet ist. Es sind allerdings mindestens so viele Anfangsbuchstaben des Variablennamens anzugeben, die erforderlich sind, um die Script-Variable eindeutig zu identifizieren. Ist die Angabe nicht eindeutig, so wird der Wert der ersten zutreffenden Variable gelesen.

Der Variablenname wird ab & oder dem Zeichen danach gesucht. Stimmt die angegebene Zeichenkette mit dem Beginn keines Variablennamens überein, so kommt es zu einem Fehler.

Mit dem Sprachmittel ist es auch möglich, die Werte von Objekt- und PromptSet-Variablen zu ermitteln.

Beispiel

Das Beispiel basiert auf einem Variablen-Objekt und einem Job. In dem Variablen-Objekt sind die Namen von Script-Variablen gespeichert.

Im Script des Jobs wird in einer Prozess-Schleife zunächst der Name der Script-Variablen aus dem Variablen-Objekt gelesen. Dieser wird der Variable "&WERT#" übergeben. Der Name der Script-Variablen und ihr Wert werden im Aktivierungsreport ausgegeben. Dies kann in einer PRINT-Anweisung mit der Script-Variablen "&WERT#" geschehen, welche nacheinander den Inhalt von "&ENDE#", "&START#" und "&ULTIMO#" enthält.

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

Auszug aus dem Report:

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:

Script-Sprachmittel - Script-Aufbau und -Prozessierung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung