Print

 Ecrit sur la sortie standard

Syntaxe

procedure Print(s: Variant)
s : Donnée à écrire

Remarques

Attention : Print ne signifie pas que quelque chose va s'afficher à l'écran !
Pour afficher un message à l'écran, il faudra plutôt utiliser les procédures InformationDlg, ErrorDlg, etc.

Print écrit une chaîne de caractères dans un emplacement mémoire particulier qu'on appelle la "sortie standard".

Au début de l'exécution d'un script, la sortie standard est vide.
Puis à chaque fois qu'on appelle Print dans l'exécution du script, cela concatène la chaîne de caractères fournie avec le contenu de la sortie standard.
Si on souhaite alimenter la sortie standard avec des chaînes séparées par des retours chariot, on peut penser à ajouter la chaîne #13#10 (correspondant aux caractères CR+LF) en fin de chaîne. Mais il est plus simple d'utiliser la procédure PrintLn.

Utilisation

L'exploitation de la "sortie standard" a lieu uniquement à la fin de l'exécution du script et dépend du contexte :

En débogage dans l'éditeur de script

Affiche la donnée dans l'onglet Execution Trace & Log de l'éditeur (ou dans une fenêtre spécifique si Afficher le résultat comme a été renseigné dans l'onglet Propriétés avancées).

Dans un script de validation des anciennes tâches de saisie

Un script de validation sert à vérifier les données saisies dans l'écran.
A la fin de l'exécution du script de validation, si Qubes trouve du texte dans la sortie standard, il l'affiche dans un message d'erreur et empêche l'utilisateur de valider sa tâche de saisie.
NB : Les anciennes tâches de saisie sont maintenant obsolètes : il faut plutôt utiliser des formules de validation dans les nouveaux écrans de saisie XForms.

Dans un composant WebScript de WebProcess

Permet de définir le corps de la réponse à la requête (classiquement, le HTML de réponse).
NB : En plus de la sortie standard, on pourra vouloir définir des headers de réponse, ce qui se fait avec des WriteContextVar.

Dans un suivi en continu

"valeur de retour" du suivi en continu, affichée dans la colonne Result de la page d'administration du QubesPeon.

Dans un script d'action ou de vérification des gammes

A la fin de l'exécution du script de validation, si Qubes trouve du texte dans la sortie standard, il l'affiche dans un message d'erreur et empêche l'utilisateur de valider sa gamme.

Dans un script de génération de RUD (paramétrage de type de document)

Retourne la RUD à utiliser.

Dans un script d'action d'une vue graphique (bouton, clic dans une CustomArea, traitement d'un dialogue)

Permet d'effectuer une action interactive (en intranet et client/serveur) selon les mots clefs suivants :

  • display document :
Print('display document DOC0034');  // Ouvre la version en application du document avec la RUD 'DOC0034'
  • display text :
Print('display text Données enregistrées');  // Ouvre une fenêtre avec le texte 'Données enregistrées'
  • display html :
Print('display html <html><body bgcolor="yellow">Test</body></html>'); // Visualise le texte 'Test' sur fond jaune
Print('display html ' + ResourceAsString('index.htm'));  // Visualise la page 'index.htm' qui est en ressource de script
  • execute url (ou execute replaceurl pour ouvrir dans la même page) :
Print('execute url www.google.com');  // Ouvre la page 'http://www.google.com'
  • execute process :
Print('execute process FOR010');  // Lance le processus de RUD 'FOR010'
  • execute dialog :
Print('execute dialog DialogueUtilisateur');  // Ouvre le dialogue de nom 'DialogueUtilisateur' de la vue

Dans un script d'initialisation de dialogue d'une vue graphique

Ce script permet de définir les données d'entrées du dialogue.
Il faut fournir dans la sortie standard une CommaText des données d'entrée.

var inputData:=new TStrings;
inputData.Values['MonEntree1']:='MaValeur1';
inputData.Values['MonEntree2']:='MaValeur2';
Print(inputData.CommaText);

Classification

Default