:PRINT

Activation d'objets

:READ

---

:PUT_READ_BUFFER, :PUT_PROMPT_BUFFER

Instruction de script : enregistre le nom et le contenu d'une variable de script dans le cache.

Syntaxe

:PUT_READ_BUF[FER] Variable Name = Content
:PUT_PROMPT_BUF[FER] Variable Name = Content

Remarques

L'instruction de script doit être utilisée comme suit, en relation avec la fonction ACTIVATE_UC_OBJECT :

:PUT_READ_BUFFER crée la variable de script dans sa propre zone de mémoire à laquelle il attribue une ID interne. Vous devez appeler cette instruction pour chaque valeur que vous voulez enregistrer. Elle est créée dans la même zone de mémoire. 

Le paramètre nom de variable est créé sans le signe "&" habituel des variables de script.

Notez qu'il est impossible d'écrire des tableaux de script complets dans la mémoire cache.

Dès lors que ACTIVATE_UC_OBJECT est créé dans le script, la zone mémoire est fermée. L'objet activé peut accéder aux variables de script comme indiqué auparavant.

L'instruction :PUT_READ_BUFFER, qui se trouve après la fonction ACTIVATE_UC_OBJECT, utilise une autre zone de mémoire à laquelle il attribue un nouvel ID.

Voici ce qui se passe lors de la lecture des variables de script du cache :

• L'instruction :READ provoque la lecture individuelle de chaque variable de script. Pour cela, vous devez indiquer le signe "&" avant le nom de variable.
• Chaque variable de script ne peut être lue qu'une seule fois, car elle est supprimée du cache lors du processus de lecture.

L'élément de script sert également à définir les valeurs PromptSet pour l'objet activé par ACTIVATE_UC_OBJECT. Dans ce cas, le nom de la variable ReadBuffer doit correspondre au nom de la variable PromptSet de l'objet démarré.

Utilisation multiple de noms de variable

On peut également créer plusieurs fois :PUT_READ_BUFFER avec le même nom de variable. La valeur n'est alors pas réécrite, car l'instruction crée sa propre entrée dans la zone de mémoire à chaque exécution. A la lecture d'une variable de script, :READ commence toujours à chercher au début de la zone de mémoire. La valeur renvoyée est celle de la première instance des variables. L'entrée est ensuite supprimée. Ainsi, lors de la lecture suivante, la valeur renvoyée est celle de l'instance suivante. Cela représente un avantage énorme en permettant de définir et de lire les valeurs en boucle.

Exemples

Dans ce premier exemple, la variable de script ''DATE1" fournit une valeur et dépose l'entrée dans le cache. Le job "EVALUATION" est ensuite activé.

:PUT_READ_BUFFER DATE1# = "01.01.2006"
:SET &ACTJOB# = ACTIVATE_UC_OBJECT(JOBS, EVALUATION) 

Le job "EVALUATION" utilise cette entrée dans le cache.

:READ &DATE1#,,
:SET &RET# = VALID_DATE("DD.MM.YYYY:&DATE1#")

Dans le second exemple, une valeur donnée d'un tableau de script est écrite dans la mémoire cache. Notez qu'il est impossible d'écrire un tableau complet dans la mémoire cache.

:DEFINE &ARRAY#,string,5
:SET &ARRAY#[1] = "test1"
:PUT_READ_BUFFER TEST# = &ARRAY#[1]
:SET &AKTJOB# = ACTIVATE_UC_OBJECT(PRINT)

L'objet "PRINT" activé lit la valeur à partir de la mémoire cache et l'écrit dans le rapport d'activation.

:READ &TEST#,,
:PRINT "&TEST#"

Dans le troisième exemple, plusieurs valeurs sont écrites dans le tampon d'invite pour une invite où la case à sélection multiple est cochée. Dans ce cas, "VARA#" est le nom de la variable choisie comme référence de données de l'élément PromptSet.

:PUT_PROMPT_BUFFER "VARA#[]"="VALUE1"
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE2"

Rubriques connexes :

Eléments de script - Activation d'objets

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle