:RSET

Verwenden Sie die :RSET-Anweisung, 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 - U00020206 Variable '&VAR#' wurde mit dem Wert 'VALUE' gespeichert.

Den Wert, den die :RSET-Anweisung 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 Neustart 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-Prozess übergeben
  Verwenden Sie :RSET, um den Wert einer Script-Variablen von der Seite Prozess an die Seite Post-Prozess eines Jobs zu übergeben:
  

  1. Weisen Sie den Wert der Script-Variablen auf der Seite Prozess zu.
  2. Rufen Sie die Script-Anweisung auf der Seite Post-Prozess erneut auf, weisen Sie aber diesmal keinen Wert zu.
  3. Die Script-Anweisung weist automatisch den Wert zu, der zuletzt im Aktivierungsreport gespeichert wurde.
  Weitere Informationen finden Sie unter Prozess-Seiten.

• Objektvariablen generieren, die an Child-Aufgaben in einem Workflow ü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 die Script-Anweisung :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

:RSETScript-Variable [= Wert]

Parameter

• :RSET
  Weist einer Script-Variablen einen Wert zu und speichert ihn im Aktivierungsreport

• Script-Variable
  Name der Script-Variablen
  Format: Script-Variable
  Halten Sie die Regeln für Variablennamen ein. Weitere Informationen finden Sie unter Variablennamen.

• Wert
  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 Anweisungen gesetzt, wenn Sie den Job ausführen. Wenn Sie den Job neu starten, wird der Wert verwendet, den die :RSET-Anweisung zuvor im Report gespeichert hat.

Beispiel

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

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

:RSET &TEXT# = "test"

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

Die :RSET-Anweisungen addieren 1 zu der durch die :SET-Anweisung definierten Zahl.

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

:RSET &TEXT#
:RSET &NUMBER#

:PRINT &TEXT#
:PRINT &NUMBER#

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

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

Siehe auch: