:PUT_READ_BUFFER, :PUT_PROMPT_BUFFER
:PUT_READ_BUFFER et :PUT_PROMPT_BUFFER stockent les valeurs d'un objet activé par la focntion de script ACTIVATE_UC_OBJECT. L'instruction de script :PUT_READ_BUFFER vous permet d'écrire une variable de script dans le tampon de lecture. L'instruction de script :PUT_PROMPT_BUFFER vous permet d'écrire une variable PromptSet dans le tampon.
Pour plus d'informations :
Les deux instructions conservent la variable dans une zone de stockage à ID interne de la base de données. Lorsque vous activez un objet avec ACTIVATE_UC_OBJECT, il peut accéder aux valeurs du tampon.
Appelez cette instruction de script pour chaque valeur à stocker. L'ID interne de la zone de stockage permet à cette instruction de stocker toutes les valeurs dans la même zone. Si vous appelez l'instruction de script plusieurs fois avec le même nom de variable, chaque instruction crée une entrée individuelle. Les entrées ne sont pas remplacées à chaque appel suivant.
Utilisez les instructions :READ pour extraire des valeurs de variables. :READ commence la recherche au début de la zone de stockage lors de la lecture d'une variable de script. Cette instruction extrait la première valeur disponible de la variable et supprime l'entrée. L'instruction :READ suivante extrait la valeur de l'occurrence suivante. Pour plus d'informations, voir :READ.
Remarques :
- Écrivez le nom de la variable dans l'instruction de script PUT_READ_BUFFER/:PUT_PROMPT_BUFFER sans esperluette (&) en préfixe. Vous devez inclure une esperluette en préfixe avant le nom de la variable dans l'instruction de script :READ.
- Chaque variable du tampon ne peut être lue qu'une seule fois. La variable est supprimée du tampon après lecture.
- Lorsque vous écrivez une instruction :PUT_READ_BUFFER/:PUT_PROMPT_BUFFER après une fonction ACTIVATE_UC_OBJECT dans un script, l'instruction de script utilise une nouvelle zone de stockage avec un ID différent.
- Les espaces de terminaison sont supprimés à l'exécution de ces instructions de script.
Important !
- Vous ne pouvez pas écrire des tableaux de script complets dans le tampon. En revanche, le tampon permet de conserver et extraire les valeurs individuelles d'un tableau de script.
- N'utilisez pas de valeurs de texte avec des sauts de ligne dans le tampon de lecture. :READ ignore les caractères après le premier saut de ligne.
Syntaxe
:PUT_READ_BUF[FER] Variable Name = Content
:PUT_PROMPT_BUF[FER] Variable Name = Content
Paramètres
- :PUT_READ_BUFFER ou :PUT_PROMPT_BUFFER
Écrit la variable dans le tampon d'entrée - Variable name
Nom de la variable de script sans préfixe &
Remarque : Pour :PUT_PROMPT_BUFFER, le nom de la variable doit correspondre à celui de la variable PromptSet.
Format : nom AE - Content
Valeur de la variable de script
Format : littéral de script ou variable de script
Exemples
L'exemple suivant illustre la définition d'une valeur de variable de script nommée DATE1 et son écriture dans le tampon. Le script active un job appelé EVALUATION.
:PUT_READ_BUFFER DATE1# = "01.01.2006"
:SET &ACTJOB# = ACTIVATE_UC_OBJECT(JOBS,
EVALUATION)
Le job activé (EVALUATION) contient un script qui utilise l'entrée (&DATE1) conservée dans le tampon :
:READ &DATE1#,,
:SET &RET# = VALID_DATE("DD.MM.YYYY:&DATE1#")
L'exemple suivant illustre la définition d'un tableau de script et l'écriture d'une valeur de ce tableau dans le tampon de saisie. Le script active un job appelé PRINT.
:DEFINE &ARRAY#,string,5
:SET &ARRAY#[1] = "test1"
:PUT_READ_BUFFER TEST# = &ARRAY#[1]
:SET &ACTJOB# = ACTIVATE_UC_OBJECT(PRINT)
Le job activé (PRINT) lit la valeur dans le tableau et la consigne dans le rapport d'activation.
:READ &TEST#,,
:PRINT "&TEST#"
L'exemple suivant illustre l'écriture de plusieurs valeurs d'un PromptSet dans le tampon. Le PromptSet est configuré pour autoriser la sélection multiple. VARA# est le nom de la variable sélectionnée comme référence de données pour l'élément PromptSet.
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE1"
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE2"
L'exemple suivant illustre le stockage du nom de l'agent d'un job dans le tampon et l'appel d'un objet Notification.
:SET &att_host# = GET_ATT(HOST)
:PUT_READ_BUFFER host# = '&att_host#'
:SET &ret# = ACTIVATE_UC_OBJECT('CALLOP')
L'objet Notification contient une instruction :READ qui extrait le nom d'agent de la tâche activant la notification :
:READ &host#,,
:PRINT "Agent: &host#"
Voir aussi :