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 RunID de la tâche.
Format : littéral de script ou variable de script

Variable name

Nom d'une variable d'objet ou PromptSet de la tâche spécifiée (sans le caractère &)

Format : nom AE

Pour les tableaux, vous devez ajouter des crochets vides [] à la fin du nom.


Codes retour

Valeur de la variable d'objet ou PromptSet

Vous pouvez utiliser cette fonction de script en association avec :SET et :FILL. L'instruction de script :SET peut lire la valeur d'une variable d'objet ou PromptSet standard ou d'un élément de tableau PromptSet. :FILL permet de lire un tableau PromptSet complet.

Vous ne pouvez définir des variables PromptSet en tant que tableaux que dans les listes et cases à cocher.

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#"

Le deuxième exemple lit la variable PromptSet &CHECKLIST1# qui a été définie comme un tableau. Seule la valeur du premier élément du tableau est lue ici.

: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

Voir aussi :

voiraussi

:FILL