Manuel des Scripts Automation Engine > Organisation fonctionnelle > Activation d'objets > :PRINT

:PRINT

Instruction de script : affiche le texte dans une boîte de dialogue destinée aux questions posées à l'utilisateur ou dans le protocole d'activation d'un objet.

Syntaxe

:P[RINT] Text
:P[RINT] Text1, Text2

Syntaxe

Description / format

Texte, Texte1, Texte2

Texte qui doit être affiché dans la boîte de dialogue ou dans le protocole d'activation, maximum de 1024 caractères pour Texte ou Texte1 + Texte2.
Format : littéral de script ou variable de script.

Remarques

Pour l'instruction de script, il existe deux possibilités d'application :

Affichage dans le protocole d'activation

:PRINT écrit le texte indiqué dans le protocole d'activation. Cela peut servir à afficher les résultats d'un traitement. Il est également possible de vérifier le remplacement correct de variables de script. Le protocole d'activation fait partie du rapport.

Syntaxe

Description

:PRINT Texte

Le texte s'affiche sur une ligne séparée.

:PRINT Texte1, Texte2

Des lignes supplémentaires sont créées pour Texte1 et Texte2.

Une ligne supplémentaire n'est créée que si Texte1 est spécifiée par des guillemets simples ou doubles. Cela n'est pas le cas pour Texte2.

Affichage dans la boîte de dialogue

:PRINT affiche le texte indiqué dans la boîte de dialogue pour les questions posées à l'utilisateur (:BEGINREAD... :ENDREAD). Utilisez cette instruction pour remanier de manière plus claire le masque de saisie et pour ajouter des explications.  

Syntaxe

Description

:PRINT Texte

Le texte s'affiche sur une ligne séparée.

:PRINT Texte1, Texte2

Si une instruction :READ suit l'instruction, Texte1 est positionné sur la ligne de commande et Texte2 sur la zone de texte. Sinon, Texte2 est ajouté à Texte1.

Dans les deux possibilités d'application, les variables de script contenues dans les textes sont remplacées par leurs valeurs correspondantes.

L'administrateur peut déterminer si l'affichage de l'instruction de script doit être écrit dans le protocole d'activation ou également dans le fichier journal / rapport Automation Engine, dans SERVER_OPTIONSde la variable UC_SYSTEM_SETTINGS.

Attention : l'instruction :PRINT supprime les espaces à la fin du texte à afficher. 

Exemples

Cette exemple illustre l'affichage d'un texte dans le protocole d'activation pendant que la date du jour courant est utilisée dans une variable de script.

:SET &DATE# = SYS_DATE(DD.MM.YY)  
:
PRINT "The daily evaluation of &DATE# is activated."

Dans l'exemple, le texte "Saisie requise" est affiché au-dessus du champ de saisie, dans la boîte de dialogue pour les requêtes utilisateur.

:BEGINREAD
:
PRINT "", "Enter here:"
:
READ &ANR#,,"Account number"
:
ENDREAD

 

Rubriques connexes :

Elément de script Description

:BEGINREAD... :ENDREAD

Début et fin d'une boîte de dialogue destinée aux questions posées à l'utilisateur.
:READ Lit les données saisies par l'utilisateur dans la boîte de dialogue.

Eléments de script - Activation d'objets

Exemples :
Maintenance de la base de données avec options

Définition du statut final en fonction du contenu du rapport

Détermination du message et du numéro de l'erreur

Réaction à des événements externes

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

Eléments de script - Répartition fonctionnelle