:PUT_VAR

Verwenden Sie die :PUT_VAR-Anweisung, um einen oder mehrere Wert(e) in einem statischen VARA-Objekt zu speichern. Definieren Sie Parameter für die Anweisung, um einer bestimmten Zeile und bestimmten Spalten im VARA-Objekt Werte zuzuweisen.

Syntax

:PUT[_VAR] VARA-Objekt, [Schlüssel], Wert [, Wert [, Wert [, Wert [, Wert]]]]

Parameter

• :PUT_VAR
  Schreibt Werte in ein VARA-Objekt

• VARA-Objekt
  Name des VARA-Objekts

• Schlüssel
  (Optional) Zeile im VARA-Objekt, in die die Werte geschrieben werden
  Hinweise:

  • Der Schlüsselparameter ist optional, wenn das VARA-Objekt so konfiguriert ist, dass es keinen Gültigkeitsbereich besitzt. Weitere Informationen finden Sie unter STATIC VARA-Objekte.
  • Fügen Sie die Kommas auch ein, wenn Sie den Schlüssel weglassen.
  Format: Script-Literal, Script-Variable oder Script-Funktion

• Wert
  Werte, die in die Wert-Spalte(n) des VARA-Objekts geschrieben werden sollen
  Format: Script-Literal, Script-Variable oder Zahl ohne Anführungszeichen
  Trennen Sie einzelne Werte durch Kommas, um sie in verschiedene Spalten des VARA-Objekts zu schreiben.
  Schreiben Sie einen Wert, der ein oder mehrere Kommas in Einzel- oder Doppelanführungszeichen enthält.
  Beispiel: Das folgende Script schreibt Wert1 in Spalte 1 und Value2, Value3, Value4 in Spalte 2.
  :PUT_VAR VARA. TEST, "KEY1", "Wert1, Wert2, Wert3, Wert4"
  Wenn Sie einen einzelnen Wert mit Kommas angeben, müssen Sie keine Anführungszeichen verwenden.
  (XML VARA-Objekte) Vollständiges, nur ordnungsgemäßes XML

Hinweise:

• Wenn das VARA-Objekt keine Werte enthält, fügt das System den Schlüssel und die von Ihnen definierten Werte hinzu.
• Wenn die von Ihnen angegebene Zeile bereits Werte im VARA-Objekt enthält, werden die vorhandenen Werte überschrieben.
• Werte von nicht angegebenen Spalten werden gelöscht.
• Wenn Sie die :PUT_VAR-Anweisung mit einem XML VARA-Objekt verwenden, werden die Werte des XML-Datentyps automatisch verschönert. Wenn Sie XML in eine einzelne Script-Zeile schreiben, wird der Wert nach dem XML-Standard im Objekt neu angeordnet.
• Bei String-Datentypen bleiben führende und nachgestellte Leerzeichen im Inhalt erhalten.
• Wenn ein Benutzer das VARA-Objekt geöffnet hat, während das Script verarbeitet wird, schreibt die :PUT_VAR-Anweisung immer noch Werte in das Objekt. Wenn der Benutzer das Objekt speichert, wird eine Warnung angezeigt, um den Benutzer darüber zu informieren, dass das VARA-Objekt in der Zwischenzeit geändert wurde. Der Benutzer kann wählen, ob er Änderungen speichern oder verwerfen möchte.

Wichtig!

• Verwenden Sie diese Script-Anweisung nicht bei dynamischen VARA-Objekten. Dies würde zu einem Laufzeitfehler führen.
• Sie können nicht mehr Werte eingeben, als das VARA-Objekt liefert. Statische VARA-Objekte haben maximal 5 Spalten zur Speicherung von Werten.
• Wenn Sie eine :PUT_VAR-Anweisung vor einer  :READ-Anweisung verwenden und die Script-Generierung wird abgebrochen, dann enthält das VARA-Objekt weiterhin die durch die :PUT_VAR-Anweisung gesetzten Werte. Die Script-Generierung kann manuell durch Drücken der Schaltfläche Abbrechen oder automatisch aufgrund ungültiger Standardwerte abgebrochen werden, wenn die Einstellung Aufgabe zur Laufzeit generieren auf der Attribut-Seite des Objekts, das das Script enthält, aktiviert ist.
  Mehr Informationen:
  • :PUT_VAR
  • Generierung zum Aktivierungszeitpunkt oder zur Laufzeit

Der Datentyp des VARA-Objekts hat Auswirkungen auf die Werte, die Sie mit der :PUT_VAR-Anweisung angeben können. Weitere Informationen finden Sie unter Benutzerdefinierte VARA-Objekte.

Wenn Sie einen Wert in einem VARA-Objekt mit Datentyp Zeitstempel speichern, verwenden Sie eines der folgenden Formate:

• YYYY-MM-DD HH:MM:SS
• YYMMDD HHMMSS
• YYYYMMDD HHMMSS
• YYYYMMDDHH24MISS

Formatieren Sie Ihren Wert für die Datentypen Zeit, Datum und Anzahl entsprechend dem für das VARA-Objekt definierten Format (Ergebnisformat auf der Attribut-Seite).

Wichtig! Bei Zahlen-Datentypen werden redundante Dezimalstellen abgeschnitten, wenn Sie eine Zahl speichern, die mehr Dezimalstellen hat, als das Ergebnisformat für das VARA-Objekt zulässt.

Weitere Informationen finden Sie unter Datentypen von Script-Variablen.

Beispiele

Das folgende Beispiel schreibt Werte in alle 5 Spalten eines VARA-Objekts:

 :PUT_VAR VARA.TEST, "KEY1", "Wert1", "Wert2", "Wert3", "Wert4", "Wert5"

Im folgenden Beispiel liefern die Funktionen SYS_DATE und SYS_TIME das aktuelle Datum und die aktuelle Uhrzeit. Die Werte werden Script-Variablen zugewiesen. Die :PUT_VAR-Anweisung schreibt die Werte in ein VARA-Objekt namens BOOKING.DATE.

: SET   &DATE# = SYS_DATE ( "YYYY-MM-DD" )
: SET   &TIME# = SYS_TIME ( "HH:MM:SS" )
: PUT_VAR BOOKING.DATE, , "&DATE# &TIME#"

Im folgenden Beispiel wird davon ausgegangen, dass das VARA-Objekt ATTRIBUTES mit einem frei gewählten Bereich konfiguriert ist. In diesem Fall müssen Sie den Schlüssel (die nachfolgende ""CurrentPriority"") in den Parametern definieren:

: SET   &PRIO# = GET_ATT ( "UC4_PRIORITY" )
: PUT_VAR ATTRIBUTES, "CurrentPriority" , &PRIO#

Das folgende Beispiel ruft mehrere Werte ab (RunID, Name und Objekttyp einer Aufgabe und ihres übergeordneten Objekts). Die einzelne :PUT_VAR-Anweisung schreibt die abgerufenen Werte in separate Spalten in einem VARA-Objekt mit dem Namen OBJECT_STAT.

:SET &PNAME# = SYS_ACT_PARENT_NAME()
:SET &PNR# = SYS_ACT_PARENT_NR()
:SET &PTYPE# = SYS_ACT_PARENT_TYPE()
:SET &NAME# = SYS_ACT_ME_NAME()
:SET &NR# = SYS _ACT_ME_NR()
:SET &TYPE# = SYS_ACT_ME_TYPE()

: PUT_VAR OBJECT_STAT, "&NR#" , "Objektname: &NAME#", "Objekttyp: &TYPE#", "Parent-Name: &PNAME#", "Parent-RunID: &PNR#", "Parent-Objekttyp: &PTYPE#"

Das folgende Beispiel schreibt einen einzelnen Wert in ein XML VARA-Objekt, weil dieser Objekttyp nur ein Wertefeld enthält:

:PUT_VAR VARA.XML, "KEY1", "<Wert1>Dies ist ein Test</Wert1>"

Siehe auch: