Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > GET_ATT

GET_ATT

Fonction de script : Cette fonction renvoie les valeurs des attributs d'une tâche pendant la génération.

Syntaxe

GET_ATT(Attribute)

Syntaxe	Description / format
Attribut	Nom de l'attribut dont la valeur doit être récupérée. Format : Nom AE, littéral de script ou variable de script.

Codes retour
Valeur de l'attribut spécifié.

Remarques

La fonction de script GET_ATT permet de lire la valeur de l'attribut d'un objet pendant la génération. Vous ne pouvez spécifier que les attributs qui appartiennent à cet objet.

Une liste des attributs.de tous les objets incluant les valeurs correspondantes possibles, est disponible dans le manuel utilisateur.

La valeur d'un attribut peut également être un espace " ". Cela se produit lorsqu'aucune valeur n'a été définie (par exemple, si la zone de texte de l'index d'archivage est vide).

Si la tâche s'exécute dans un groupe d'agents, la fonction GET_ATT(HOST) renvoie le nom de l'agent sur lequel la tâche est réellement exécutée, et non le nom du groupe d'agents.

Si vous indiquez le nom d'une variable de script ou d'objet en tant qu'attribut (voir Lecture et modification d'attributs), la lecture de cet attribut à l'aide de la fonction GET_ATT() renvoie non pas le nom de la variable mais le contenu de la variable indiquée. Utilisez l'élément de script GET_ATT_PLAIN si les variables ne doivent pas être résolues.

Exemples

L'exemple suivant récupère le premier index d'archivage d'un objet et l'enregistre dans une variable de script.

:SET &START# = GET_ATT(ARCHIVE_KEY1)

Des variables de script peuvent également être utilisées dans cette fonction.

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

Cet exemple utilise la fonction de script pour définir une condition.

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

L'exemple suivant utilise une variable de script dans le champ attribut d'un objet. La variable "&DST#" est indiquée en tant que fichier cible d'un objet transfert de fichier. Le script suivant permet de définir l'attribut, d'attribuer une valeur à la variable et de lire l'attribut. La valeur renvoyée correspond à la valeur de la variable "C:\Temp\test2.txt" et non à son nom "&DST#".

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

Rubriques connexes :

Elément de script	Description
:ADD_ATT	Ajoute des destinataires à un objet notification pendant l'exécution.
:REMOVE_ATT	Supprime des destinataires d'un objet notification pendant l'exécution.
:PUT_ATT	Modifie la valeur d'un attribut pendant la génération.
:PUT_ATT_APPEND	Ajoute un élément au texte du message de la notification pendant l'exécution.
GET_ATT_PLAIN	Fournit la valeur des attributs d'une tâche pendant la génération sans résolution des variables.
GET_ATT_SUBSTR	Fournit une partie du message de la notification.

Eléments de script - Lecture ou modification d'objets

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle