:PUT_VAR_COL

Instruction de script : Enregistre une valeur dans une colonne déterminée d'un objet variable statique.

Syntaxe

:PUT_VAR_COL Variable, [Key], Column, Value

Syntaxe	Description / format
Variable	Nom de l'objet Variable auquel une valeur doit être affectée. Format : Nom AE ou variable de script
Key	Ligne dans laquelle la valeur doit être enregistrée. Format : littéral de script, variable de script ou fonction de script
Column	Numéro de colonne dans laquelle la valeur doit être saisie. Format : littéral de script, variable de script ou nombre sans guillemets Valeurs autorisées : Pour l'objet Variable STATIC : 1 à 5 (format : numérique) Pour l'objet Variable XML : 1 (format : numérique)
Valeur	Valeur à écrire dans la ligne colonne et ligne de la variable spécifiée. Format : Littéral de script ou variable de script Pour l'objet Variable XML : Expression XPath (format : string)

Cette fonction de script écrit une valeur dans la ligne / la colonne spécifiée d'un objet Variable. À la différence de l'élément de script :PUT_VAR, cela n'affecte pas les autres champs. Si la ligne / colonne spécifiée contient déjà une entrée, la valeur correspondante est remplacée.

La spécification d'une variable dynamique dans cet élément de script (source : SQL, SQL interne, type données ou multi) génère une erreur d'exécution. Seuls les objets Variable statiques peuvent être renseignés avec des valeurs via :PUT_VAR_COL.

Lors de l'indication du nombre de colonnes, n'oubliez pas que les objets Variable de type "static" ne contiennent que 5 colonnes de valeurs.

Avec un objet Variable statique XML, le nombre de colonnes de valeurs est "1" uniquement.

Il est possible d'utiliser des expressions XPath avec l'objet Variable XML, mais selon la base de données avec laquelle le système Automation Engine est utilisé, les expressions XPath peuvent fonctionner différemment. Dans ce cas, consultez le fournisseur de la base de données.

Les chiffres entre 1 (colonne de valeurs 1) et 5 (colonne de valeurs 5) peuvent être utilisés pour les colonnes. La valeur de la colonne Key ne peut pas être modifiée avec cet élément de script.

Le paramètre Key n'est optionnel que si une variable statique est utilisée avec le paramètre "Scope" - "Aucun mot-clé de validité". Dans ce cas, la variable ne contient que la clé (*).

Si la clé spécifiée n'existe pas, une nouvelle entrée est créée.

Exemple

Dans l'exemple suivant le nom de tâche supérieure (workflow) est extrait avec le RunID propre de la tâche. Le RunID est ensuite écrit sous le nom du workflow dans la colonne 3 de l'objet Variable "VARA.JOBP".

:SET &JOBP# = SYS_ACT_PARENT_NAME()
:SET &RUNID# = SYS _ACT_ME_NR()
:PUT_VAR_COL VARA.JOBP, &JOBP#, "3", &RUNID#

La combinaison de cette instruction de script avec l'objet Variable XML, donnerait :

:PUT_VAR_COL VARA.XML.TEST2, "KEY3", "test/value1", "test"

Voir aussi :