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

:REMOVE_ATT

Script-Anweisung: Entfernt in einem Benachrichtigungs-Objekt Empfänger zur Laufzeit.

Syntax

:REMOVE_ATT RECIPIENT, Recipient

Syntax	Beschreibung/Format
RECIPIENT	Name des Attributes, das entfernt werden soll. Format: AE-Name, Script-Literal oder Script-Variable Erlaubter Wert: "RECIPIENT"
Empfänger	Name eines Benutzers, einer BenutzerGruppe oder eine E-Mail-Adresse. Format: Script-Literal, Script-Variable oder Zahl Für Benutzer- und BenutzerGruppen-Objekte können Sie die Wildcardzeichen "" und "?" verwenden. "" steht dabei für beliebige, "?" für genau ein Zeichen.

Syntax

Beschreibung/Format

RECIPIENT

Name des Attributes, das entfernt werden soll.
Format: AE-Name, Script-Literal oder Script-Variable
Erlaubter Wert: "RECIPIENT"

Empfänger

Name eines Benutzers, einer BenutzerGruppe oder eine E-Mail-Adresse.
Format: Script-Literal, Script-Variable oder Zahl

Für Benutzer- und BenutzerGruppen-Objekte können Sie die Wildcardzeichen "*" und "?" verwenden. "*" steht dabei für beliebige, "?" für genau ein Zeichen.

Kommentare

Diese Script-Anweisung kann nur in der Script-Registerkarte eines Benachrichtigungs-Objektes eingesetzt werden. Sie entfernt die angegebenen Benutzer, BenutzerGruppen oder E-Mail-Adressen aus der Liste der zu verständigendenEmpfänger.

Die eingetragenen Empfänger werden nicht dauerhaft gelöscht, da die Script-Anweisung das Benachrichtigungs-Objekt nicht ändert. Die Anpassung der Empfängerliste gilt nur für dessen Durchführung.

Bei der Verwendung von Wildcard-Zeichen ist darauf zu achten, dass dadurch nicht alle zuständigen Empfänger entfernt werden. Dies führt zum Abbruch der Script-Verarbeitung und zur Ausgabe einer Fehlermeldung.

Im Report ist ersichtlich, welche Empfänger die Script-Anweisung entfernt hat.

Beachten Sie, dass der Benutzer im Format Benutzername/Abteilung angegeben werden muss. Dies entspricht dem Namen des Benutzer-Objekts. Wird der Benutzer nicht gefunden, bricht das Script ab.

Beispiele

Im Beispiel wird der Benutzer „BU/AE" aus der Liste der zuständigen Empfänger entfernt.

:REMOVE_ATT RECIPIENT,"BU/AE"

Das zweite Beispiel entfernt alle Benutzer der Abteilung "AE".

:REMOVE_ATT RECIPIENT,"*/AE"

Die BenutzerGruppe "ADMIN" wird im dritten Beispiel entfernt.

:REMOVE_ATT RECIPIENT,"ADMIN"

Siehe auch:

Script-Sprachmittel	Beschreibung
:ADD_ATT	Fügt einemBenachrichtigungs-ObjektEmpfänger zur Laufzeit hinzu.
:PUT_ATT	Ändert den Wert eines Attributes während der Generierung.
:PUT_ATT_APPEND	Erweitert den Meldungstext einer Benachrichtigung zur Laufzeit.
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