:PRINT

L'instruction de script :PRINT vous permet d'écrire un texte dans une boîte de dialogue utilisateur ou dans le rapport d'activation. Ces textes apparaissent sous forme de lignes dans le rapport d'activation de l'objet ou dans une boîte de dialogue visible à l'utilisateur. Le contexte dans lequel vous utilisez l'instruction :PRINT détermine le résultat :

• Utilisez l'instruction :PRINT seule pour consigner des textes dans le rapport d'activation. L'écriture de textes dans le rapport d'activation peut s'avérer utile pour :

  • Afficher les résultats du traitement dans le rapport d'activation.
  • Vérifier si les variables de script ont été correctement remplacées.
  Remarque : Votre système peut être configuré pour écrire la sortie de l'instruction :PRINT dans le journal Automation Engine, en plus du rapport d'activation. Pour plus d'informations, voir SERVER_OPTIONS dans UC_SYSTEM_SETTINGS - Paramètres système.

• Incluez l'instruction :PRINT dans des instructions :BEGINREAD ...:ENDREAD pour afficher le texte dans une boîte de dialogue. Les instructions :PRINT vous permettent de donner des informations à l'utilisateur dans une boîte de dialogue ou de structurer un écran de saisie. La boîte de dialogue s'affiche dans AWI à l'activation ou la génération de l'objet. Pour plus d'informations sur le timing, voir Traitement du script.

Syntaxe

:P[RINT] Text1 [,Text2]

Paramètres

• :PRINT
  Écrit un texte dans le rapport d'activation ou la boîte de dialogue
• Text1, Text2
  Texte à afficher dans le rapport d'activation ou la boîte de dialogue
  Format : littéral de script ou variable de script
  Caractères maximum : 1024 (Text1 + Text2)

Remarques :

• Les espaces à la fin du texte sont tronqués.
• Les variables de script sont remplacées. La valeur de la variable est écrite dans la sortie.

Pour les rapports d'activation, spécifiez votre texte comme suit pour afficher le texte dans des lignes séparées :

• SpécifiezText1 entre guillemets simples ou doubles pour écrire le texte dans une ligne à part dans le rapport.
• Vous n'avez pas besoin d'utiliser les guillemets pour Text2.
• Si vous spécifiez Text1 et Text2, le texte est écrit dans deux lignes distinctes.

Pour les boîtes de dialogue, le texte s'affiche ainsi :

• Text2 est ajouté à Text1.
• Si une instruction :READ suit l'instruction de script, Text1 est avant la requête d'entrée et Text2 est avant la zone de texte.

Exemples

L'exemple suivant illustre l'écriture d'une phrase contenant la date actuelle, dans le rapport d'activation :

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

L'exemple suivant illustre l'affichage d'une instruction (Saisir ici) au dessus de la zone de saisie dans une boîte de dialogue :

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

Voir aussi :