Manuel des Scripts Automation Engine > Organisation fonctionnelle > Elaboration et traitement des Scripts > :PUBLISH

:PUBLISH

Instruction de script : Définir les Variables de script et les tableaux comme Variables d'objet.

Syntaxe

:PUB[LISH] Nom de variable [, [Variable d'objet] [,Plage de validité] ]

Elément de syntaxe	Description/format
Nom de Variable	Nom de la variable de script ou du tableau de script (avec &). Format : Variable de script Pour les tableaux, les crochets vides [ ] doivent être rajoutés à la fin du nom.
Variable d'objet	Nouveau nom de la variable d'objet (sans le faire précéder de &) Format : Nom AE
Plage de validité	Détermine à quelle zone de tâches la variable doit être transmise. Valeurs autorisées : "TASK", "WORKFLOW" ou "TOP" "TASK" - Variable d'objet disponible uniquement pour la tâche propre "WORKFLOW" - Transmettre la variable d'objet au Workflow parent "TOP" - Transmettre la variable d'objet au Workflow supérieur

Elément de syntaxe

Description/format

Nom de Variable

Nom de la variable de script ou du tableau de script (avec &).
Format : Variable de script

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

Variable d'objet

Nouveau nom de la variable d'objet (sans le faire précéder de &)
Format : Nom AE

Plage de validité

Détermine à quelle zone de tâches la variable doit être transmise.

Valeurs autorisées : "TASK", "WORKFLOW" ou "TOP"
"TASK" - Variable d'objet disponible uniquement pour la tâche propre
"WORKFLOW" - Transmettre la variable d'objet au Workflow parent
"TOP" - Transmettre la variable d'objet au Workflow supérieur

Remarques

L'instruction :PUBLISH convertit une variable de script ou un tableau de script en variable d'objet et la transmet si souhaité aux tâches de niveau supérieur.

Si le paramètre Variable d'objet est spécifié, une nouvelle variable d'objet est créée avec ce nom et la valeur des variables de script. Si une variable d'objet avec le même nom existe déjà, elle est écrasée. Dans ce cas-là, la variable de script n'est dans modifiée.

Veuillez noter que la variable de script ou le tableau de script indiqué doit exister ! Sinon, une erreur de durée se produit.

Si un tableau de script est indiqué, les éléments vides à la fin de ce dernier ne sont pas repris ou supprimés pour la variable d'objet. C'est aussi bien le cas pour la conversion de la variable de script que pour la création d'une nouvelle variable d'objet.

Si un tableau de script contenant de nombreux éléments est indiqué (10000 et plus), cela peut altérer les performances.

L'instruction de script est similaire au script :PSET, mais s'en distingue cependant par le fait que la variable de script mentionnée doit exister et que des tableaux peuvent aussi être indiqués.

En outre, vous pouvez déterminer les tâches devant être mises à disposition de la variable d'objet avec le paramètre Plage de validité. La variable peut alors être transmise au Workflow parent, au Workflow supérieur ou simplement être mise à disposition de la propre tâche.

Exemples

Dans l'exemple suivant, le nom d'objet est enregistré dans une variable de script et transmise au Workflow de niveau supérieur via :PUBLISH.

:SET &CHILD# = SYS_ACT_ME_NAME()
:PUBLISH &CHILD#,,"WORKFLOW"

Dans le second exemple, un tableau de script est créé et complété avec les valeurs d'un objet Variable. Ensuite, le tableau est transmis au Workflow de niveau supérieur en tant que nouvelle variable d'objet.

:DEFINE &ARRAY#, string, 5
:FILL &ARRAY#[] = GET_VAR(VARA.TEST, KEY1)
:PUBLISH &ARRAY#[], VARA_ARRAY#[], "TOP"

Rubriques connexes :

Elément de script	Description
:FILL	Enregistre plusieurs valeurs dans un Tableau de script.
GET_PUBLISHED_VALUE	Déterminer la valeur des Variables d'Objet et PromptSet d'une tâche définie.

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

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