:RSET

Verwenden Sie das Statement :RSET, um einer Script-Variablen einen Wert zuzuweisen und ihn im Aktivierungsreport zu speichern. Der gespeicherte Wert ist verfügbar, wenn Sie die Aufgabe anschließend neu starten.

Die Zeile, die in den Aktivierungsreport geschrieben wird, sieht wie folgt aus:

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

Den Wert, den das Statement :RSET im Aktivierungsreport speichert, können Sie wie folgt verwenden:

• Gespeicherte Werte aus dem Aktivierungsreport verwenden
  Verwenden Sie :RSET, wenn Sie eine Aufgabe mit dem gespeicherten Wert aus dem Aktivierungsreport neu starten möchten. Andernfalls wird beim Wiederanlauf der Aufgabe kein Wert zugewiesen. Die Aktivierung wird abgebrochen, wenn die entsprechende Script-Variable nicht gefunden wird. Wenn ein Wert mehrfach gespeichert wurde und es keine Warnmeldung gibt, wird der zuletzt gespeicherte Wert verwendet. Weitere Informationen zu Aktivierungsreports finden Sie unter Reports.

• Werte an die Seite „Post-Skript“ übergeben
  Verwenden Sie :RSET, um den Wert einer Script-Variablen von der Seite Skript an die Seite Post-Skript einer Aufgabe zu übergeben:
  

  1. Weisen Sie den Wert der Script-Variablen auf der Seite Skript zu.
  2. Rufen Sie das Script-Statement auf der Seite Post-Skript erneut auf, weisen Sie aber diesmal keinen Wert zu.
  3. Das Script-Statement weist automatisch den Wert zu, der zuletzt im Aktivierungsreport gespeichert wurde.
  Weitere Informationen finden Sie unter Seiten „Script“.

• Objektvariablen generieren, die in einem Workflow an Child-Aufgabe übergeben werden
  Verwenden Sie :RSET im Script eines Workflow-Objekts, um eine Objektvariable zu generieren. Die Objektvariable kann an Child-Aufgabe des Workflows übergeben werden. Definieren Sie Objektvariablen auf der Seite Variablen in der Objektdefinition oder verwenden Sie das Script-Statement :PSET.
  Hinweis: Sie müssen Child-Aufgaben in einem Workflow konfigurieren, um Objektvariablen vom Parent zu erben. Verwenden Sie in der Objektdefinition der Child-Aufgabe die Einstellung Von Parent erben auf der Seite Variablen.
  Wichtig! Beenden Sie den Variablennamen mit einem Trennzeichen, z. B. einem Hash. Dadurch werden Fehler bei der Generierung von Child-Aufgaben vermieden, bei denen die Namen der Objektvariablen und der Workflow-Aufgabe mit den gleichen Zeichen beginnen.

Mehr Informationen:

• Objektvariablen
• Seite „Variablen“

Syntax

:RSET Script variable [= Value]

Parameter

• :RSET
  Weist einer Script-Variablen einen Wert zu und speichert ihn im Aktivierungsreport
• Script- variable
  Name der Script-Variable, welcher der Wert zugewiesen werden soll
  Format: Script-Variable
  Befolgen Sie die Regeln für Variablennamen. Weitere Informationen finden Sie unter Variablennamen.
  
• Value
  Wert, der der Script-Variablen zugewiesen wird
  Format: Script-Literal, Zahl, Script-Variable oder Script-Funktion

Hinweise:

• Die Datentypen „signed“ und „float“ werden automatisch zu „string“-Datentypen umgewandelt, wenn der Wert im Aktivierungsreport gespeichert wird.
• Datentypen „unsigned“ werden nicht konvertiert.

Wichtig! Mit :SET und :RSET können Sie der gleichen Script-Variablen verschiedene Werte zuweisen. Die Werte werden durch diese Statements gesetzt, wenn Sie den Job ausführen. Wenn Sie den Job neu starten, wird der Wert verwendet, den das Statement :RSET zuvor im Bericht gespeichert hat.

Beispiel

Das folgende Beispiel zeigt, wie Sie einer Script-Variablen auf der Seite Skript eines Jobs einen Wert zuweisen. Die Variable wird auf der Seite Post-Skript desselben Jobs verwendet.

Schreiben Sie die folgenden Script-Zeilen auf der Seite Skript des Jobs:

:RSET &TEXT# = "test"

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

Die :RSET-Statements addieren 1 zu der durch das :SET-Statement definierten Zahl.

Schreiben Sie die folgenden Script-Zeilen auf die Seite Post-Skript des gleichen Jobs:

:RSET &TEXT#
:RSET &NUMBER#

:PRINT &TEXT#
:PRINT &NUMBER#

Die Werte (Test und 2) werden auf die Seite Post-Skript des Jobs übertragen und in den Aktivierungsreport geschrieben.

Tipp: Sie können die Script-Statements :RSET und :READ verwenden, um Werte von Script-Variablen in Reports zu speichern.

Siehe auch: