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

GET_ATT

Script-Funktion: Liefert den Wert von Attributen einer Aufgabe während der Generierung.

Syntax

GET_ATT(Attribute)

Syntax	Beschreibung/Format
Attribut	Name des Attributes, dessen Wert ausgelesen werden soll. Format: AE-Name, Script-Literal oder Script-Variable.

Rückgabewerte
Wert des angegebenen Attributes.

Anmerkungen

Die Script-Funktion GET_ATT ermöglicht es, das angegebene Attribut eines Objektes während der Generierung auszulesen. Dabei können nur die Attribute verwendet werden, die zum jeweiligen Objekt gehören.

Im Benutzerhandbuch finden Sie eine Liste der Attribute aller Objekte mit ihren möglichen Werten.

Beachten Sie, dass der Wert eines Attributes auch ein Leerzeichen " " sein kann! Das tritt dann auf, wenn kein Wert gesetzt wurde (Beispiel: das Textfeld für den Archivbegriff ist leer).

Läuft die Aufgabe in einer AgentenGruppe, so gibt GET_ATT(HOST) den Namen jenes Agenten zurück, auf dem die Aufgabe tatsächlich durchgeführt wird und nicht den AgentenGruppenname.

Wenn Sie im Objekt als Attribut den Namen einer Script- bzw. Objektvariable verwenden (siehe: Attribute lesen und verändern), dann wird beim Auslesen des Attributes mit GET_ATT() nicht der Variablenname sondern der Inhalt der eingetragenen Variable zurückgeliefert. Wollen Sie nicht, dass Variablen aufgelöst werden, so ist das Sprachmittel GET_ATT_PLAIN zu verwenden.

Beispiele

Das Beispiel ermittelt den ersten Archivbegriff eines Objektes und übergibt ihn an eine Script-Variable.

:SET &START# = GET_ATT(ARCHIVE_KEY1)

Auch die Verwendung einer Script-Variablen innerhalb der Funktion ist möglich.

:SET &ATT# = "JOBREPORT_FILE"
:SET &START# = GET_ATT(&ATT#)

In diesem Beispiel wird die Funktion verwendet, um eine Bedingung zu formulieren.

:IF GET_ATT(GROUP) = " "
!...
:ENDIF

Ein Beispiel für die Verwendung einer Script-Variablen im Attribut-Feld eines Objektes. In einem FileTransfer-Objekt wird als Zieldatei die Variable "&DST#" eingetragen. Mit folgendem Script wird das Attribut gesetzt, der Variable ein Wert zugewiesen und das Attribut ausgelesen. Als Wert wird nicht der Variablenname "&DST#" zurückgeliefert, sondern der Wert der Variable "C:\Temp\test2.txt“.

:PUT_ATT FT_DST_FILE = "&DST#"
:SET &DST# = "C:\Temp\test2.txt"
:SET &DEST# = GET_ATT(FT_DST_FILE)
:PRINT "Target file: &DEST#"

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.
:PUT_ATT_APPEND	Erweitert den Meldungstext einer Benachrichtigung zur Laufzeit.
GET_ATT_PLAIN	Liefert den Wert von Attributen einer Aufgabe während der Generierung, wobei Variablen nicht aufgelöst werden.
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