:PUBLISH

L'instruction de script :PUBLISH vous permet de convertir des variables de scripts et des tableaux en variables d'objets. L'instruction de script :PUBLISH est semblable à l'instruction :PSET en ce qu'elle peut transmettre des variables d'objets à des tâches parents. Les différences entre :PUBLISH et :PSET sont les suivantes :

• Avec :PUBLISH, vous pouvez convertir des tableaux en variables d'objets.
• :PSET crée des variables de script si elles n'existent pas encore. :PUBLISH ne crée pas de variables de script, ce qui implique que vous devez vous assurer que les variables de script appelées dans vos instructions :PUBLISH existent déjà, ou utiliser l'instructions :SET pour les créer.

Syntaxe

:PUB[LISH] Variable name [, [Object variable] [,Scope] ]

Paramètres

• :PUBLISH
  Convertit la variable de script ou le tableau de script en variable d'objet
• Variable name
  Nom de la variable de script ou du tableau de script à convertir
  Format : variable de script
  Respectez les règles de noms de variables. Pour plus d'informations, voir Noms des variables.
  Pour les tableaux, ajoutez des crochets vides [] à la fin du nom.
• Object variable
  Nom de la nouvelle variable de script sans le préfixe &
  Format : nom AE
  Pour les tableaux, n'ajoutez pas de crochets vides [] à la fin du nom de la variable.
• Scope
  Spécifie les tâches dans lesquelles la variable peut être utilisée
  Valeurs autorisées :
  • TASK
    La variable d'objet n'est disponible que pour sa propre tâche.
  • WORKFLOW
    La variable d'objet est transmise au workflow parent.
  • TOP
    La variable d'objet est transmise au workflow supérieur.

Important !

• Le tableau ou la variable de script à spécifier doivent déjà exister. Une erreur d'exécution se produit si le tableau ou la variable de script n'existent pas encore.
• Un tableau de script comportant un grand nombre d'éléments (10 000 ou plus) peut affecter les performances.

Remarques :

• Les tableaux sont publiés avec leur taille remplie pour des raisons de performances.
  Exemples
  Un tableau est vide (toutes les entrées ont une chaîne nulle). Rien n'est publié.
  Un autre tableau a 5 entrées. Les 2 dernières entrées sont des chaînes nulles. Seules les 3 premières entrées sont publiées dans les tâches suivantes. La taille du tableau de la tâche suivante est limitée à 3.
• Les éléments vides en fin de tableau ne sont pas utilisés, ni déplacés de la variable d'objet, même si vous convertissez la variable de script ou créez un nouveal objet Variable.

Exemples

Dans l'exemple suivant, la fonction SYS_ACT_ME_NAME extrait le nom d'objet et le stocke dans une variable de script appelée &CHILD#. L'instruction :PUBLISH comprend le paramètre WORKFLOW, ce qui permet au workflow parent d'utiliser également la variable de script.

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

L'exemple de script suivant illustre la définition d'un tableau de script renseigné avec les valeurs d'un objet Variable. Ce tableau est transmis au workflow parent en tant que variable d'objet.

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

Voir aussi :