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

GET_PUBLISHED_VALUE

Fonction de script : Récupère la valeur ou la variable de PromptSet d'une tâche donnée.

Syntaxe 

GET_PUBLISHED_VALUE(RunID, Variable Name)

Syntaxe

Description / format
RunID Numéro d'exécution (RunID) de la tâche.
Format : littéral de script ou variable de script

Nom de Variable

Nom d'une variable d'objet ou PromptSet de la tâche citée (sans le faire précéder de &).
Format : Nom AE

Pour les tableaux, les crochets vides [ ] doivent être rajoutés à la fin du nom.

Codes retour

Valeur de la variable d'objet ou PromptSet

Remarques

Vous povuez utiliser cette fonction de script en association avec :SET et :FILL. :SET est utilisé lorsque la valeur d'une variable d'objet / PromptSet normale ou d'un élément de tableau PromptSet propre est lue. :FILL permet de lire un tableau PromptSet complet.

Seuls les éléments Check-list et Case à cocher offrent la possibilité de définir des variables PromptSet en tant que tableaux.

Exemples

Dans l'exemple suivant, un objet est activé et sa variable d'objet &VARIABLE1# est ensuite lue.

:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:SET &VAR# = GET_PUBLISHED_VALUE(&RUNID#,VARIABLE1#)
:PRINT "&&VARIABLE1# = &VAR#"

Dans le deuxième exemple, la variable PromptSet &CHECKLIST1# définie comme tableau est lue. Lors de la première étape, nous déterminons uniquement la valeur du premier élément du tableau.

:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:SET &VAR# = GET_PUBLISHED_VALUE(&RUNID#,CHECKLIST1#[1])
:PRINT "&&CHECKLIST1#[1] = &VAR#" 

Le scénario suivant récupère le tableau PromptSet complet pour la tâche activée. Les différents éléments PromptSet sont ensuite affichés dans le rapport d'activation. Si le tableau PromptSet dépasse la taille du tableau de script, seuls les éléments trouvant une place sont enregistrés.

:DEFINE &ARRAY#, string, 10
:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:FILL &ARRAY# = GET_PUBLISHED_VALUE(&RUNID#,CHECKLIST1#[])
:SET &LEN# = LENGTH(&ARRAY#[])
:SET &VAR# = 1

:WHILE &VAR# LE &LEN#
:PRINT "&&ARRAY#[&VAR#] = &ARRAY#[&VAR#]"
:SET &VAR# = &VAR# + 1
:ENDWHILE


Rubriques connexes :

Elément de script Description

:FILL

Enregistre plusieurs valeurs dans un tableau de script.

:PUBLISH Définir les variables de script et les tableaux comme variables d'objet.

Eléments de script - Données d'activation

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