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

:PUT_VAR_COL

Instruction de script : Enregistre une valeur dans une colonne spécifique d'un objet Variable statique.

Syntaxe

:PUT_VAR_COLVariable, [Clé], Colonne, Valeur

Elément de syntaxe	Description/format
Variable	Nom de la Variable à laquelle une valeur doit être attribuée. Format : Nom AE ou Variable de script
Clé	Lignes dans lesquelles la valeur doit être enregistrée. Format : littéral de script, Variable de script ou fonction script
Colonne	Numéro de la colonne dans laquelle la valeur est saisie. Format : littéral de script, Variable de script ou nombre sans guillemets simples Valeurs autorisées : "1" à "5"
Valeur	Valeur qui doit être inscrite dans la ligne et la colonne indiquées de la Variable. Format : Littéral de script ou Variable de script

Remarques

Cette fonction script insère une valeur déterminée dans la ligne et la colonne indiquées dans un objet Variable. Contrairement à l'élément de script :PUT_VAR, les autres champs ne sont pas affectés. Si une entrée existe déjà dans la ligne/colonne indiquée, cette valeur est remplacée.

Si une Variable dynamique est indiquée pour l'élément de script (Source: SQL, SQL interne, Multi ou Type de données), cela entraîne une erreur de durée d'exécution. Seuls des objets Variable statique peuvent être remplis avec :PUT_VAR_COL.

Lors de l'indication du numéro de colonne, veuillez noter que les objets Variable de type "statique" ne possèdent que cinq colonnes de valeurs.

Lors de l'indication du numéro de colonne, la plage autorisée va de "1" (colonne de valeurs 1) à "5" (colonne de valeurs 5). La valeur de la colonne Clé ne peut pas être modifiée par l'élément de script.

Le paramètre Clé n'est facultatif que lorsqu'une Variable statique est utilisée avec le paramètre "Plage de validité" - "Aucune clé". Dans ce cas, la Variable ne possède qu'une clé (*).

Si la Clé indiquée n'est pas encore disponible, la saisie est recréée.

Exemple

Dans l'exemple suivant, le nom de la Tâche supérieure (Workflow) et le RunID spécifique sont déterminés. Puis le RunID est inscrit 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#

Rubriques connexes :

Elément de script	Description
:PUT_VAR	Enregistre les valeurs dans un objet Variable statique.
:DELETE_VAR	Supprime une ou toutes les valeurs d'un objet Variable statique.
GET_VAR	Indique la valeur d'un objet Variable.
:SET_SCRIPT_VAR	Définit les valeurs des Variables de script par accès indirect.
GET_SCRIPT_VAR	Indique les valeurs des Variables de script par accès indirect.
PREP_PROCESS_VAR	Prépare le traitement d'une séquence de données (valeurs d'un objet Variable).

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

Variable

Exemples :
Affichages à l'aide de Cockpit
Maintenance de la base de données avec options
Exécution d'un MBean

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle