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