GENERATE_SCRIPT_VARS

Utilisez la fonction de script GENERATE_SCRIPT_VARS pour générer des variables de script à partir d'un objet VARA ou d'une séquence de données à la volée. Cette fonction de script vous permet d'écrire des scripts sans avoir à définir individuellement chaque variable de script. Si la variable de script existe déjà, la valeur est actualisée.

Remarque : Les paramètres du système doivent être configurés de manière à permettre l'utilisation de la fonction de script GENERATE_SCRIPT_VARS. L'option GENERATE_UNDEFINED_SCRIPT_VARS doit être définie sur Y. Pour plus d'informations, voir UC_SYSTEM_SETTINGS - Paramètres système.

Syntaxe

GENERATE_SCRIPT_VARS (Vara|Process Handle ,[APPEND_POUND_SIGN] [, UPDATE|IGNORE|ABORT])

Paramètres

• GENERATE_SCRIPT_VARS
  Génère des variables de scripts à partir d'un objet VARA ou d'une séquence de données
• VARA|Process Handle
  Nom ou processus de l'objet VARA à partir duquel les variables sont générées
  Format : littéral de script ou variable de script
• APPEND_POUND_SIGN
  (Optionnel) Ajoute un caractère # à la fin du nom des variables du script
• UPDATE|IGNORE|ABORT
  Action à entreprendre si la variable script existe déjà :
  • ABORT
    Interrompt le script avec une erreur de script (par défaut)
  • UPDATE
    Actualise les variables de script existantes
  • IGNORE
    Ignore les variables de script existantes

Code retour

Nombre de variables de script actualisées ou ignorées

Exemple

Un objet VARA appelé VARA.STORE contient les valeurs suivantes :

• Clé : STORE_ADR
  Valeur : Sample Street 1
• Clé : STORE_LOC
  Valeur : Vienna
• Clé : STORE_ZIP
  Valeur : 1120

Le script suivant génère des variables de script à partir des valeurs de VARA.STORE. La fonction script ajoute un caractère # au nom de chaque variable de script. Le script écrit les valeurs dans le rapport d'activation.

:SET &ret# = GENERATE_SCRIPT_VARS("VARA.STORE", APPEND_POUND_SIGN, UPDATE)
:PRINT The address for the store is &STORE_ADR# - &STORE_ZIP# &STORE_LOC#.

Le texte consigné dans le rapport d'activation est le suivant :

The address for the store is Sample Street 1 - 1120 Vienna.

Voir aussi :