:PUT_ATT_APPEND

Objekte lesen oder verändern

:PUT_VAR_COL

---

:PUT_VAR

Script-Anweisung: Speichert Werte in ein statisches Variablen-Objekt.

Syntax

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

Kommentare

Wird bei dem Script-Sprachmittel eine Dynamische Variable (Quelle: SQL, SQL-intern, Multi oder Datentyp) angegeben, führt dies zu einem Laufzeitfehler. Nur statische Variablen-Objekte können mit :PUT_VAR befüllt werden.

Für das Hinterlegen von Werten in einem Variablen-Objekt gelten folgende Regeln:

• Besitzt die Variable noch keinen Wert, werden der Key und der Wert hinzugefügt.
• Besitzt die Variable den angegebenen Key so werden dessen Werte ersetzt.

Um mehrere Werte-Spalten einer Variable zu befüllen, sind die einzelnen Werte durch Kommata getrennt anzugeben. Bei statischen Variablen gibt es maximal 5 Werte-Spalten.

Wenn kein Key für ein statisches Variablen-Objekt festgelegt ist, wählt das System automatisch den Key auf Basis der Einstellung Gültigkeitsbereich in der Registerkarte des Variablen-Objekts aus.

Der Parameter Key ist optional, wenn die Einstellung "Gültigkeitsbereich" - "Kein Gültigkeits-Key" in der Registerkarte Attributeausgewählt ist. Die Variable enthält in diesem Fall nur einen Wert. Beachten Sie, dass bei ausgelassenemKey trotzdem die entsprechenden Kommata in der Anweisung zu setzen sind.

Die einzelnen Werte können auch ohne Hochkommata angeben werden. Als Trennzeichen werden Kommata verwendet

Variablen-Objekte können eine unterschiedliche Anzahl von Werten besitzen. Falls Sie mehr Werte eingeben, als das Objekt ermöglicht, wird eine Fehlermeldung angezeigt.

Wenn Sie diese Script-Anweisung mit dem statischen Variablen-Objekt XML verwenden, werden die Werte automatisch für den XML-Datentyp aufbereitet. Sie können also XML zum Beispiel in einer einzelnen Script-Zeile verwenden, im Objekt wird der Wert jedoch nach dem XML-Standard neu angeordnet.

Beispiel: Werte werden in den fünf Werte-Spalten eingegeben.

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

Um einen Wert einzutragen, der ein Komma oder mehrere Kommata in einer Zeile enthält, muss dieser in einfachen oder doppelten Anführungszeichen eingeschlossen werden.
Beispiel: "Value1" wird in die Werte-Spalte 1 und "Value2, Value3, Value4" in die Spalte 2 geschrieben.

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

Im folgenden Beispiel enthält das Variablen-Objekt XML nur einen Wert, da dieses Objekt nur ein Wertefeld besitzt:

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

Um einen Wert in eine Variable zu speichern, die den Datentyp "Zeitstempel" aufweist, muss eines der folgenden Formate gewählt werden:

• "JJJJ-MM-TT HH:MM:SS"
• "JJMMTT HHMMSS"
• "JJJJMMTT HHMMSS"
• "JJJJMMTTHH24MISS"

Bei den Datentypen "Zeit", "Datum" und "Zahl" ist der Wert im eingestellten Ausgabeformat (Registerkarte Attribute) anzugeben.
Für den Datentyp "Zahl" ist folgender Hinweis zu beachten: Wird versucht, eine Zahl mit mehr Nachkommastellen zu speichern, als im Ausgabeformat erlaubt ist, werden die überflüssigen Dezimalstellen abgeschnitten.

Die Script-Funktion schreibt Werte auch dann in das Variablen-Objekt, wenn jenes gerade von einem Benutzer geöffnet ist, damit die Verarbeitung nicht behindert wird. Sollte der Benutzer das Variablen-Objekt ändern und speichern wollen, erhält er eine Warnung, dass die Variable in der Zwischenzeit geändert wurde. Er kann dann entscheiden, ob er sie trotzdem speichert oder seine Änderungen verwirft.

Beim Datentyp "String“ bleiben führende Leerzeichen im Inhalt erhalten. Leerzeichen am Ende des Strings werden jedoch abgeschnitten.

Bei der Verwendung von :PUT_VAR vor einer :READ-Anweisung gilt folgende Besonderheit: Wird bei :READ die Generierung des Scripts manuell über die Schaltfläche "Abbrechen" oder aufgrund ungültiger Vorgabewerte (siehe "Zur Laufzeit generieren") abgebrochen, so besitzt das Variablen-Objekt trotzdem die mit :PUT_VAR gesetzten Werte.

Beispiele

Im Beispiel werden das aktuelle Tagesdatum und die aktuelle Tageszeit ermittelt und in einem Variablen-Objekt vom Typ "Zeitstempel" gespeichert. Tagesdatum und -zeit werden der Script-Anweisung als Script-Variablen übergeben.

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

Die Variable "ATTRIBUTE", die im folgenden Beispiel verwendet wird, enthält den Gültigkeitsbereich "Frei gewählt". Daher ist der Key unbedingt anzugeben.

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

In folgendem Beispiel wird Name, Objekttyp und Informationen zum Parent einer Aufgabe unter der RunID der Aufgabe im Variablen-Objekt "OBJEKT_STATISTIK" abgelegt.

: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#", "Objekt-Name: &NAME#", "Objekt-Typ: &TYPE#", "Parent-Name: &PNAME#", "Parent-RunID: &PNR#", "Parent-Objekttyp: &PTYPE#"

Siehe auch:

Script-Sprachmittel - Objekte lesen oder verändern

Variable

Beispielsammlung:
Darstellung mittels Cockpit
Datenbankwartung mit Optionen
Aufruf eines MBeans

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