GET_ATT

Verwenden Sie die GET_ATT-Script-Funktion, um den Wert eines Objektattributs während eines Generierungsprozesses abzurufen.

Wenn das Objektattribut über eine Variable definiert ist, löst das System die Variable auf und ruft den Wert der Variablen ab. Die GET_ATT-Funktion speichert den abgerufenen Wert in einer Script-Variablen und ändert nicht die ursprüngliche Variable, aus der sie den Wert abruft. Diese Script-Funktion kann Werte abrufen, die in den folgenden Arten von Variablen gespeichert sind:

• Script-Variablen
• PromptSet-Variablen
• Objektvariablen
• Vordefinierte Variablen

Weitere Informationen finden Sie unter Variablen und VARA-Objekte.

Syntax

GET_ATT (Attribute)

Parameter

• GET_ATT
  Ruft den Wert eines Objektattributs ab
• Attribute
  Name des Objektattributs, dessen Wert abgerufen werden soll
  Format: AE-Name, Script-Literal oder Script-Variable

Hinweise:

• Sie können nur Werte für Attribute abrufen, die das Objekt hat. Weitere Informationen über die Attribute, deren Werte Sie abrufen können, finden Sie unter Seite „Attribute“.
• Wenn sich die Aufgabe in einer Agentengruppe befindet, GET_ATT(HOST)gibt den Namen des Agenten zurück, der die Aufgabe bearbeitet, und nicht den Namen der Agentengruppe. Weitere Informationen finden Sie unter Agentengruppen (HOSTG).

Beispiele

Das folgende Beispiel ruft den Archivschlüssel eines Objekts ab und speichert den abgerufenen Wert in einer Script-Variablen:

:SET &START# = GET_ATT(ARCHIVE_KEY1)

Im folgenden Beispiel verwendet die GET_ATT-Funktion eine Script-Variable, um einen Wert abzurufen, und speichert den abgerufenen Wert in einer anderen Script-Variablen:

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

Das folgende Beispiel verwendet die Script-Funktion, um eine Bedingung zu definieren:

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

Im folgenden Beispiel verwendet die PUT_ATT-Anweisung eine Script-Variable (&DST#), um die Zieldatei in einem Dateiübertragungsobjekt zu definieren. Das Script weist der Variablen einen Wert zu und stellt das Attribut ein. Das Script liest das Attribut und gibt den Wert der Variablen aus (C:\Temp\test2.txt).

:SET &DST# = "C:\Temp\test2.txt"

:PUT_ATT FT_DST_FILE = "&DST#"

:SET &DEST# = GET_ATT(FT_DST_FILE) 

:PRINT "Target file: &DEST#" 

Tipp: Verwenden Sie die GET_ATT_PLAIN-Funktion, um den Namen einer Variablen abzurufen, die verwendet wird, um ein Objektattribut zu definieren, ohne die Variable zu lösen.

Siehe auch: