Objets VARA EXEC
Vous pouvez utiliser des objets VARA EXEC en tant qu'intermédiaires chargés de lire et de transmettre les valeurs renvoyées par d'autres objets exécutables. Ces valeurs peuvent affecter l'exécution ultérieure d'objets ou déclencher l'exécution d'objets. Vous pouvez enregistrer ces lectures dans les variables de script définies dans l'objet VARA EXEC. L'objet VARA EXEC lui-même n'a pas de paramètres de saisie.
Cette rubrique contient les sujets suivants :
Prérequis
Le nom des paramètres de l'objet VARA EXEC doit être le même que celui du promptset de l'objet exécutable qui donne les codes retour.
Les variables PromptSet sont supportées dans les champs sélectionnés pour les variables de type BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL et XML. La fonction Rechargement dynamique (prompts Liste déroulante) requiert l'utilisation de variables PromptSet.
Définir des objets VARA EXEC
La définition d'un objet VARA EXEC se compose des pages suivantes :
- Page Général
-
Variables
Vous permet de définir les paramètres spécifiques aux objets. Certaines sections de cette page sont communes à tous les objets VARA et sont décrites dans des rubriques dédiées :
- Paramètres des variables, voir ci-après
- Paramètres
- Formats et types de données
- Accès au script
- Objets VARA du client 0 dans d'autres clients
- Aperçu, voir ci-après
- Page Gestion des versions
- Page Documentation
Section Paramètres des variables
-
Type
Lecture seule. Vous déterminez le type de variable au moment de la création de l'objet. Il ne peut pas être modifié une fois la variable définie.
-
Objet exécutable
Nom de l'objet exécutable Automation Engine à partir duquel l'objet VARA EXEC lit les valeurs. Saisissez-le ou cliquez sur l'icône pour ouvrir une boîte de dialogue et le rechercher.
Avertissement ! Les objets Schedule ne doivent pas être utilisés avec les objets VARA EXEC.
-
Variable du résultat
Nom de la variable de script utilisée pour la valeur renvoyée par l'objet exécutable.
Liste des paramètres et variables disponibles dans l'objet exécutable. Leurs valeurs peuvent être :
- Des valeurs directes, telles que 5342ou
-
Des variables référencées, par exemple &reftext#.
Les espaces restants à la fin des valeurs sont supprimés lors de l'enregistrement des variables EXEC.
You can include PromptSet variables here when using the Rechargement dynamique (prompts Liste déroulante) feature for Combobox prompts. When you use PromptSet variables in a dynamic VARA object, the Preview feature returns an error. This is because the PromptSet variables do not exist in the dynamic VARA object. However, the PromptSet variables will be resolved when objects including the PromptSet are executed.
Traitez ces paramètres comme s'ils étaient des valeurs tampon de lecture / Promptset. Lorsque qu'objet VARA appelle l'objet exécutable, il utilise :PUT_PROMPT_BUFFER pour configurer les paramètres spécifiés. Afin de lire et utiliser ces valeurs dans l'objet exécutable appelé, vous devez utiliser la commande :READ pour lire les valeurs de variables ayant le même nom que les paramètres définis dans l'objet Variable EXEC appelant.
Important ! Il ne suffit pas de définir les variables dans la page Variables sous Variables & Prompts pour l'objet exécutable appelé.
Pour plus d'informations, voir : :PUT_READ_BUFFER, :PUT_PROMPT_BUFFER.
Aperçu
Pour voir un aperçu de la variable, cliquez sur Aperçu. Un aperçu des valeurs de résultat enregistrées ou transférées s'affiche alors.
Exemples :
Utiliser une variable EXEC dans une précondition
Pour utiliser une variable EXEC dans une précondition, faites ce qui suit :
- Dans un objet exécutable, incluez du code comme le suivant :
- Créez une variable EXEC et pointez-la vers l'objet exécutable.
- Accédez à la variable EXEC dans soit un :
- Script avec le code suivant, :SET &TEST#= GET_VAR(VARA.EXEC)
- Un prompt ou une précondition avec, {VARA.EXEC}
:SET &RET# = "Y"
Utiliser une variable EXEC comme séquence de données
Si vous souhaitez utiliser une variable EXEC pour transmettre une liste de valeurs (ex. : pour utiliser le résultat dans une liste déroulante PromptSet) :
- Vous pouvez utiliser des séquences de données à cet effet (:CREATE_PROCESS, ....).
- La première ligne est toujours la ligne d'en-tête.
- Vous devez retourner la séquence de données enregistrée avec SAVE_PROCESS().
- Le processus doit être enregistré directement dans l'objet qui est utilisé pour la variable EXEC (les Workflows avec les JOBS et les JOBS créés qui ont enregistré et publié la séquence de données ne fonctionnent pas).
Dans un objet exécutable, afin de retourner une liste de valeurs, incluez quelque chose comme ceci :
:SET &HND# = CREATE_PROECESS(NEW)
! add the header line
:SET &CHECK# = PUT_PROCESS_LINE(&HND#, "Header A;Header B; Header C", ";")
!fill the process with another one!
:PROCESS &HND_SOURCE#
: SET &CHECK# = PUT_PROCESS_LINE(&HND#, "Value1;Value 2; Value 3", ";")
:ENDPROCESS
! save process
:SET &RET# = SAVE_PROCESS(&HND#)
:PUBLISH &RET#,,TOP
:CLOSE_PROCESS(&HND#)
Dans l'objet exécutable VARA.EXEC, pointez vers l'objet avec le contenu dont il est question. La valeur de retour serait définie à &RET#.
Voir aussi :