:RESTART

Script-Aufbau und -Prozessierung

:SET

---

:RSET

Script-Anweisung: Weist einer Script-Variablen einen Wert zu und speichert diesen im Aktivierungsreport.

Syntax

:RSET Script variable = [Value]

Anmerkungen

Die Script-Anweisung speichert den Wert, den sie einer Script-Variablen zuweist, gleichzeitig im Aktivierungsreport. Dabei wird bei der Wertzuweisung folgende Zeile in das Aktivierunsprotokoll geschrieben:

YYYY-MM-DD HH:MM:SS - U0020206 Variable '&VAR#' was stored with the value 'VALUE'.

Neben dem Scriptsprachmittel :RSET ist es auch mit :READ möglich, Werte von Script-Variablen im Report festzuhalten.

Der gespeicherte Wert kann auf verschiedene Weise verwendet werden.

Zum einen wird ein Wiederanlauf der Aufgabe mit dem gespeicherten Wert durchgeführt. Die mit der Script-Anweisung verbundene Zuweisung des Wertes, wird im Wiederanlauffall nicht ausgeführt. Ist diese Script-Variable nicht auffindbar, bricht die Aktivierung ab. Wurde die Script-Variable mehrfach gespeichert, so wird der zuletzt zugewiesene Wert ohne Warnung genommen.

Zum anderen kann die Script-Anweisung auch dazu verwendet werden, um den Inhalt einer Script-Variablen bei Jobs zwischen Script und Post-Script zu übergeben. In der Registerkarte Script wird der Script-Variablen ein Wert zugewiesen. In der Registerkarte Post-Script wird die Script-Anweisung erneut aufgerufen, ohne aber einen Wert zuzuweisen. Die Script-Variable enthält dann den Wert aus dem Script, der als letztes im Aktivierungsreport gespeichert wurde.

Beachten Sie, dass bei der Speicherung des Wertes einer Script-Variable im Aktivierungsreport mit dem Scriptsprachmittel :RSET, die Datentypen "signed" und "float" automatisch zu "string" umgewandelt werden. Weist die Variable den Datentyp "unsigned" auf, so bleibt dieser erhalten.

Ein :RSET im Script von Workflows führt zur Erzeugung einer Objektvariable, die auch an untergeordnete Workflow-Aufgaben vererbt wird (sofern die Vererbung in den Child-Aufgaben aktiviert ist). Überschneidet sich der Name dieser Objektvariable mit jenen der Workflow-Aufgaben, so kann es zum Fehler bei deren Generierung kommen (siehe: Script-Variable - Syntax). Achten Sie daher darauf, Variablennamen immer mit einem Sonderzeichen abzuschließen, um Überschneidungen zu vermeiden. 

Wenn Sie mit den Scriptsprachmitteln :SET und :RSET die gleiche Scriptvariable mit unterschiedlichen Werten versorgen, dann werden diese Werte sowohl mit :SET, als auch mit :RSET gesetzt, wenn der zugehörige Job ausgeführt wird. Bei einem Wiederanlauf dieses Jobs werden die Werte von beiden Variablen jedoch durch das Scriptsprachmittel :SET gesetzt. Dies erfolgt, weil :RSET automatisch Objektwerte erstellt und :SET automatisch den Wert für den Fall eines Wiederanlaufes speichert. Dies ist eine Veränderung des Verhaltens im Vergleich zu Version 8, wo :RSET Aussagen keine Objektwerte erstellten.

Beispiel

Im Beispiel wird in der Registerkarte Post-Script auf eine Script-Variable zugegriffen, deren Wert in der Registerkarte Script gesetzt wurde.

Registerkarte Script:

:RSET &TEXT# = "test"

:SET &NUMBER# = 1
:RSET &NUMBER# = ADD(&NUMBER#,1)

Registerkarte Postscript:

:RSET &TEXT#
:RSET &NUMBER#

:PRINT &TEXT#
:PRINT &NUMBER#

Die Werte "test" und "2" werden an die Registerkarte Postscript übergeben und ins Aktivierungsprotokoll geschrieben.

Siehe auch:

Script-Sprachmittel - Script-Aufbau und -Prozessierung

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