:PUT_VAR

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

Syntax

:PUT[_VAR]Variable,[Key], Value [,Value[,Value[,Value[,Value]]]]

Parameter

• :PUT_VAR
  Schreibt Werte in ein Variablenobjekt
• Variable
  Name des Variablenobjekts
• Key
  Zeile im Variablenobjekt, in die der/die Wert(e) geschrieben werden sollen
  Hinweise: 
  • Der Schlüsselparameter ist optional, wenn das Variablenobjekt so konfiguriert ist, dass es keinen Gültigkeitsbereich besitzt. Weitere Informationen finden Sie unter STATIC-VARA-Objekte.
  • Lassen Sie die Kommas nicht weg, wenn Sie keinen Schlüssel angeben.
  Format: Script-Literal, Script-Variable oder Script-Funktion
• Value
  Werte, die in die Wertspalte(n) im Variablenobjekt geschrieben werden sollen
  Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata
  Trennen Sie einzelne Werte durch Kommas, um sie in verschiedene Spalten im Variablenobjekt zu schreiben.
  Schreiben Sie einen Wert, der ein oder mehrere Kommas in Einzel- oder Doppelanführungszeichen enthält.
  Beispiel: Das folgende Script schreibt „Wert1“ Spalte 1 und „Wert2, Wert3, Wert4“ in Spalte 2.
  :PUT_VAR VARA.TEST, "KEY1", "Value1", "Value2, Value3, Value4"
  Wenn Sie einen Einzelwert mit Kommas angeben, dann müssen Sie keine Anführungszeichen verwenden.
  (XML-Variablenobjekte) Vollständiges, nur wohlgeformtes XML

Hinweise:

• Wenn das Variablenobjekt 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 Variablenobjekt enthält, werden die vorhandenen Werte überschrieben.
• Werte von nicht angegebenen Spalten werden gelöscht.
• Wenn Sie die :PUT_VAR-Anweisung mit einem XML-Variablenobjekt 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 Zeichenketten-Datentypen bleiben führende und nachgestellte Leerzeichen im Inhalt erhalten.
• Wenn ein Benutzer das Variablenobjekt 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 die Variable 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 Variablenobjekten. Dies würde zu einem Laufzeitfehler führen.
• Sie können nicht mehr Werte eingeben, als das Variablenobjekt liefert. Statische Variablenobjekte 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 Variablenobjekt 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.

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

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

• YYYY-MM-DD HH:MM:SS
• JJMMTT HHMMSS
• JJJJMMTT HHMMSS
• YYYYMMDDHH24MISS

Formatieren Sie Ihren Wert für die Datentypen Zeit, Datum und Anzahl entsprechend dem für das Variablenobjekt 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 Variablenobjekt zulässt.

Weitere Informationen finden Sie unter Datentypen von Script-Variablen.

Beispiele

Das folgende Beispiel schreibt Werte in alle 5 Spalten eines Variablenobjekts:

 :PUT_VAR VARA.TEST, "KEY1", "Value1", "Value2", "Value3", "Value4", "Value5"

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 Variablenobjekt 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 Variablenobjekt ATTRIBUTES mit einem frei gewählten Bereich konfiguriert ist. In diesem Fall müssen Sie den Schlüssel (die nachfolgende „aktuelle Priorität“) 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 Variablenobjekt 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#", "object name: &NAME#", "object type: &TYPE#", "parent name: &PNAME#", "parent RunID: &PNR#", "parent object type: &PTYPE#"

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

:PUT_VAR VARA.XML, "KEY1", "<Value1>this is a test</value1>"

Siehe auch: