REPORT

Reportpermet de lancer l'édition d'un état Crystal Report à partir d'un traitement.

Syntaxe

   Reportparam=id_serveurwith liste_param

Paramètres

Exemples

# lancement de l'état ITMMASTER.RPT
# sur le serveur d'impression mach1.domaine1
# avec sortie sur imprimante
# avec sélection des articles commençant par la lettreA
Local Char RETOUR(6)
Report RETOUR="mach1.domaine1@" With
& "__REPORT="+chr$(1)+"ITMMASTER.RPT",
& "__DESTINATION="+chr$(1)+ "2",
& "__DBSERVER="+chr$(1)+ "x73",
& "__DBPASSWORD="+chr$(1)+ "PASSE",
& "__APPLICATION="+chr$(1)+ "GX3APP;gailf40;1801",
& "__APPRPT="+chr$(1)+ "GX3APP;gailf40;1801",
& "_PreVisuOptions="+chr$(1)+ "11111111111111111111",
& "X3DOS="+chr$(1)+ "GX3APP;gailf40;1801",
& "X3EDT="+chr$(1)+ "Adonix",
& "X3ETA="+chr$(1)+ "ITMMASTER",
& "X3TIT="+chr$(1)+ "truc",
& "X3OPE="+chr$(1)+ "Dupond",
& "itmrefdeb="+chr$(1)+ "A",
& "itmreffin="+chr$(1)+ "AZZZZZZZZZZZZZZZZZZZ"

# impression d'une pièce jointe
Report "" With
& "__DOCUMENT="+chr$(1)+ "C:\document.xls",
& "__APPLICATION="+chr$(1)+ "GX3APP;gailf40;1801",

 

Description et commentaires

L'instruction Reportpermet de lancer l'édition d'un état directement à partir d'un traitement. Ellepermet depuis la version 130 d'imprimer une pièce jointe.

Les états se trouvent sur le serveur, dans le sous-répertoire ETA del'application courante ou d'une des applications de référence. L'instruction Report met àniveau, si nécessaire, à partir de l'état du serveur, l'état sur le posteclient dans le répertoire Application_Serveur_Port.

L'etat Crystal Report peut être soit :

• Pré-visualisé
• Imprimé directement
• Envoyé par la messagerie
• Sauvegardé dans un ficher

Si le serveur n'est pas renseigné, l'impression est envoyée sur le serveurcourant.

L'élément param est unparamètre de sortie qui est valorisé avec le numéro de job affecté à la demanded'édition. Sa présence est facultative.

Les paramètres à renseigner peuvent être classés en trois catégories :

• système : nécessaire à l'appelde l'état Crystal Report
• standards : paramètresfonctionnels transférés à l'état. Ils sont disponibles sur tous les états.
• particuliers :  paramètresfonctionnels transférés à l'état. Ils sont particuliers à chaque état.

Paramètres système :

Paramètres standard :

Remarques

Dans le traitement standard  "ETAT" de lancement d'édition,le nom du serveur d'impression est alimenté par défaut par le paramètre SERIMPdu chapitre superviseur, lorsque l'impression est envoyée sur imprimante.

Nouveautés de la version 130

les paramètres supplémentaires

     __DOCUMENT       pour les pièces jointes

    _ExportFile
   

Pour __DESTINATION = 3 (c'est à dire fichier), le paramètre _ExportFile permetd'indiquer le nom du fichier résultat de l'export.
Pour __DESTINATION = 1 (c'est à dire Imprimante), alors l'impression ne serapas envoyée physiquement sur l'imprimante identifiée par les paramètres "_PrinterDriver;_PrinterName;_PrinterPort;_PrinterDescription",mais elle sera dirigée dans le fichier spécifié par "_ExportFile"(fichier de types "Raw Printer data" d'extensions PRN ou PS), ens'appuyant sur le driver PCL ou PostScript identifié via les paramètres "_PrinterDriver;_PrinterName;_PrinterPort".

les pièces jointes

Pour une impression de pièce jointe, 2 paramètres sont nécessaires etobligatoires :
        __DOCUMENT
        __APPLICATION

Le paramètre _DOCUMENT  ne peut contenir qu'une seule pièce jointe.
La syntaxe est sur serveur NT : \\serveur\chemin\document
La syntaxe est sur serveur UNIX : /répertoire/document  (répertoire estl'arborescence sous le dossier)

une pièce jointe est imprimable si le programme associé permet l'impression.

Génération d'un fichier trace(disponibleà partir de la 133)

Pour chaque demande d'édition avec une destination "Fichier" (Cfparamètre __DESTINATION), un fichier trace est généré en fin d'exécutionde la demande dans le réperoire "Temp" du réperoired'installation du poste client X3 (ou du serveur d'impression X3IMP). Cefichier trace se nomme "reportjobstatus.njob", où njobcorrespond au numéro de job affecté à la demande d'édition (Cf description duparamètre "param"). S'il était déjà présent dans le répertoire"Temp", ce fichier trace est préalablement supprimé en débutde soumission.

Si la taille de ce fichier est nulle, cela indique que la demande d'éditions'est correctement terminée. Dans le cas contraire, le fichier contient lemessage d'erreur associé au problème d'exécution détecté.

Ce fichier trace peut être exploité dans le cas d'éditions soumises enbatch, ou en différée, pour contrôler la fin effective et le bon déroulement del'exécution de la demande.

Nouveautés de la version 140

Pour des besoins de protocole, un chr$(1) est maintenant nécessaire devantla valeur de chaque paramètre. 

Un paramètre s'exprime maintenant  sous la forme :
"param="+chr$(1)+"valeur_param"

Erreurs associées

Mots-clés associés

SOMMAIRE