Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > :SET_SCRIPT_VAR

:SET_SCRIPT_VAR

Script-Anweisung: Setzt die Werte von Script-Variablen per indirektem Zugriff.

Syntax

:SET_SCRIPT_VAR Script variable = Value

Syntax	Beschreibung/Format
Script-Variable	Platzhalter für die Namen von Script-Variablen, die mit Werten versorgt werden sollen. Der Name einer Script-Variablen besteht aus maximal 32 alphanumerischen Zeichen einschließlich der Sonderzeichen "$", "_", "@", "§" und "#". Umlaute sind nicht erlaubt. Das erste Zeichen des Namens darf keine Zahl sein. Im Script sind Variablen immer mit dem Kennzeichen "&" vor dem Namen anzugeben! Format: Script-Literal oder Script-Variable
Wert	Wert, welcher der Script-Variable zugewiesen wird. Format: Script-Literal, Script-Variable oder Script-Funktion

Syntax

Beschreibung/Format

Script-Variable

Platzhalter für die Namen von Script-Variablen, die mit Werten versorgt werden sollen.

Der Name einer Script-Variablen besteht aus maximal 32 alphanumerischen Zeichen einschließlich der Sonderzeichen "$", "_", "@", "§" und "#". Umlaute sind nicht erlaubt. Das erste Zeichen des Namens darf keine Zahl sein. Im Script sind Variablen immer mit dem Kennzeichen "&" vor dem Namen anzugeben!

Format: Script-Literal oder Script-Variable

Wert

Wert, welcher der Script-Variable zugewiesen wird.
Format: Script-Literal, Script-Variable oder Script-Funktion

Anmerkungen

Die Script-Anweisung setzt 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 Prozessschleife, zu setzen. Die Script-Anweisung :SET_SCRIPT_VAR ersetzt so viele der bisher notwendigen Bedingungsanweisungen durch eine einzige Script-Zeile.

Der Script-Anweisung wird mit Script-Variable eine Zeichenkette übergeben, aus denen der jeweilige Name einer Script-Variable gebildet wird. Die Zeichenkette darf dabei nicht mit einem "&" beginnen, wodurch eine Script-Variable gekennzeichnet ist. Es sind minimal nur soviele Anfangsbuchstaben des Script-Variablennamens (ohne &) anzugeben, die notwendig sind, um die Script-Variable eindeutig zu identifizieren. Die Script-Anweisung :SET_SCRIPT_VAR erstellt einen gültigen Namen für die Script-Variable und weist ihr einen Wert zu.

Ein Fehler tritt auf, wenn auf eine Script-Variable zugegriffen werden soll, die nicht existiert.

Trifft die angegebene Zeichenkette auf den Namen mehrerer Script-Variablen zu, so erfolgt keine Wertzuweisung. Wählen Sie die Zeichenkette daher so, dass die Script-Variable dadurch eindeutig identifiziert werden kann.

Die Script-Anweisung kann nicht dazu verwendet werden, Script-Variablen anzulegen. Diese müssen zuvor im Script mit der :SET-Anweisung erstellt und mit einem Initialwert versorgt worden sein.

Beachten Sie bei der Verwendung des Sprachmittels, dass beim Namen von Script-Variablen nicht zwischen Groß- und Kleinschreibung unterschieden wird. Dies bedeutet: Geben Sie Platzhalter (Script-Variable) an, die sich nur durch die Schreibweise unterscheiden, so wird immer auf die selbe Script-Variable zugegriffen.

Beispiel

Das Beispiel basiert auf einem Variablen-Objekt und einem Job. Im Variablen-Objekt sind die Namen von Script-Variablen (Key) und ihre Werte (Wert 1) gespeichert.

Die Script-Werte müssen mit dem Zeichen # enden.

Im Script des Jobs wird in einer Prozessschleife zunächst der Name der Script-Variablen aus der Key-Spalte des Variablen-Objektes gelesen. Danach wird aus der zweiten Spalte der Wert der Script-Variable gelesen. Anschließend werden die ermittelten Werte im Script den Variablen "&ENDE#", "&START#" und "&ULTIMO#" zugewiesen.

:SET &END#   = ""
:SET &START# = ""
:SET &ULTIMO# = ""

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

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

:CLOSE_PROCESS &HANDLE#

Mit der PRINT-Anweisung werden die Werte des Variablen-Objektes im Aktivierungsprotokoll ausgegeben (Key = Wert 1).

Auszug aus dem Report:

2005-02-03 13:46:59 - U0020408 End = 20051027
2005-02-03 13:46:59 - U0020408 Start = 20051024
2005-02-03 13:46:59 - U0020408 Ultimo = 20051031

Siehe auch:

Script-Sprachmittel	Beschreibung
RESOLVE_VAR	Löst im Text jede Art von Variable auf (Aufforderungswerte, Systemvariablen, Script-Variablen, Variablen-Objekte).
GET_SCRIPT_VAR	Liefert die Werte von Script-Variablen per indirektem Zugriff.
:PSET	Weist einer Objektvariablen einen Wert zu.
:RSET	Weist einer Script-Variablen einen Wert zu und speichert diesen im Aktivierungsreport.
:SET	Weist einer Script-Variablen einen Wert zu. Die Anweisung kann in Lang- oder Kurzform geschrieben werden.

Script-Sprachmittel - Script-Aufbau und -Prozessierung

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support