:REGISTER_VARIABLE

L'instruction de script :REGISTER_VARIABLE vous permet d'enregistrer le nom et la valeur d'une variable dans le système AE. Vous pouvez le faire dans les pages Traitement de n'importe quel objet JOBS pour Windows ou UNIX. Les variables enregistrées sont conservées sous forme de variables d'objets (voir Page Variables). Vous pouvez utiliser :REGISTER_VARIABLE dans le contexte des sections de script d'interpréteur externe. Pour plus de détails, consultez la section Utiliser des scripts d'interpréteur externe ci-dessous.

Important ! Les variables enregistrées avec :REGISTER_VARIABLE sont limitées à 1023 caractères. Les variables plus longues sont tronquées à 1023 caractères, sans notification.

Syntaxe

:REGISTER_VARIABLE VariableName, VariableValue

• :REGISTER_VARIABLE
  Enregistre le nom et la valeur d'une variable
• VariableName
  Nom de la variable
  Format : Nom de la variable sans le préfixe &. Fin avec un dièse (#).
• VariableValue
  Valeur de la variable correspondante
  Format : Chaîne de caractères

Exemple

Dans l'exemple Windows suivant, la variable FOO est enregistrée avec la valeur de la date qui était définie à l'exécution.

date /T > tmp.txt
set /p FOO=<tmp.txt
:REGISTER_VARIABLE FOO#, %FOO%

Utiliser des scripts d'interpréteur externe

Vous pouvez utiliser :REGISTER_VARIABLE dans un bloc :BEGIN_EXT_INTERPRETERS... :END_EXT_INTERPRETERS pour enregistrer la valeur d'une variable définie par l'utilisateur pendant l'exécution d'un script d'interpréteur externe.

Important !

Pour pouvoir utiliser :REGISTER_VARIABLE avec des scripts d'interpréteur externe, l'administrateur doit définir l'interpréteur externe requis dans

• les objets Include fournis (voir Configurer des objets Include pour des appels d'interpréteurs externes)
• la variable système UC_EXT_INTERPRETERS_WINDOWS ou UC_EXT_INTERPRETERS_UNIX.

Lorsque vous définissez un interpréteur externe, vous devez copier l'objet Include REGISTER_VARIABLE.WINDOWS ou REGISTER_VARIABLES.UNIX dans votre client cible. Automation Engine utilise alors votre version et ne la remplace pas lorsqu'il fournit de nouvelles données initiales. L'exemple suivant illustre un appel pour PERL :

:if &$EXT_INTERPRETER# = 'PERL' or 'perl' or 'Perl'
system("&UC_PATH_JOBMD# JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=V VTYPE=T NAME=&uc_register_varname VALUE=\"&uc_register_valuename\"");
:else
...
:endif

Voir aussi :