Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > :PUT_ATT_APPEND

:PUT_ATT_APPEND

Script-Anweisung: Erweitert den Meldungstext einer Benachrichtigung zur Laufzeit.

Syntax

:PUT_ATT_APPEND CALL_TEXT = Text

Syntax	Beschreibung/Format
CALL_TEXT	Name des Attributes, dessen Wert erweitert werden soll. Format: AE-Name und Script-Variable Erlaubter Wert: "CALL_TEXT"
Text	Text, der dem bestehenden Meldungstext hinzugefügt werden soll. Format: Script-Literal, Zahl, Script-Variable oder Script-Funktion

Kommentare

Diese Script-Anweisung kann nur in der Script-Registerkarte eines Benachrichtigungs-Objektes eingesetzt werden. Sie fügt am Ende des Meldungstextes den angegebenen Text hinzu.

Der bestehende Meldungstext wird dadurch nicht geändert, da die Script-Anweisung das Benachrichtigungs-Objekt nicht ändert. Die Erweiterung des Meldungstextes gilt nur für dessen Durchführung.

Bei der Verwendung von Leerzeichen gelten folgende Besonderheiten (siehe auch Beispiele):

Leerzeichen am Ende des hinzuzufügenden Textes werden abgeschnitten.
Besteht der Text nur aus Leerzeichen werden diese gänzlich ignoriert.

Beachten Sie, dass die Länge des übergebenen Textes aus Datenbank-technischen Gründen eine Länge von 8.000 Zeichen nicht überschreiten darf.

Beispiele

Im Beispiel wird die aktuelle Uhrzeit in einer Script-Variablen gespeichert und in den READ-Buffer gestellt. Danach wird ein Benachrichtigungs-Objekt aktiviert.

:SET &TIME# = SYS_TIME("HH:MM")
:PUT_READ_BUFFER TIME# = "&TIME#"
:SET &CALL# = ACTIVATE_UC_OBJECT(CALL, BACKUP.END)

Die Benachrichtigungs-Aufgabe liest den Wert der Script-Variable aus dem READ-Buffer. Die aktuelle Uhrzeit wird an den Meldungstext der Benachrichtigung angehängt.

:READ &TIME#,,
:PUT_ATT_APPEND CALL_TEXT = " &TIME#."

Die folgenden Beispiele sollen Ihnen die Behandlungsweise von Leerzeichen demonstrieren. Der Meldungtext der Benachrichtigung lautet "Bitte Überprüfung der".

1) Der Text wird durch das führende Leerzeichen korrekt ausgegeben. Beachten Sie, dass nicht automatisch ein Leerzeichen eingefügt wird.

:PUT_ATT_APPEND CALL_TEXT = " Server processes"

Ausgabe:

Start checking the Server processes

2) Beachten Sie auch, dass Leerzeichen am Ende des Textes abgeschnitten werden.

:PUT_ATT_APPEND CALL_TEXT = " Server "
:PUT_ATT_APPEND CALL_TEXT = "processes"

Ausgabe:

Start checking the Serverprocesses

3) Besteht der Text nur aus Leerzeichen, wird er ebenfalls ignoriert.

:PUT_ATT_APPEND CALL_TEXT = " Server"
:PUT_ATT_APPEND CALL_TEXT = " "
:PUT_ATT_APPEND CALL_TEXT = "processes"

Ausgabe:

Start checking the Serverprocesses

Siehe auch:

Script-Sprachmittel	Beschreibung
:ADD_ATT	Fügt einem Benachrichtigungs-Objekt Empfänger zur Laufzeit hinzu.
:REMOVE_ATT	Entfernt in einem Benachrichtigungs-Objekt Empfänger zur Laufzeit.
:PUT_ATT	Ändert den Wert eines Attributes während der Generierung.
GET_ATT	Liefert den Wert von Attributen einer Aufgabe während der Generierung.
GET_ATT_SUBSTR	Liefert einen Teil des Meldungstextes einer Benachrichtigung.

Script-Sprachmittel - Objekte lesen oder verändern

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support