Le process GP.REPORT (IN-TOOLS) est un process permettant de restituer des données sous format HTML, PostScript, PDF, Graphe et fichier texte en se basant sur une définition de type STT.
Le process GP.REPORT peut être utilisé soit de manière interactive soit en ligne de commande (éventuellement via SB.REMOTE.PROCESS dans un environnement non SB+)
Les paramètres à passer au process doivent être séparé par des virgules.
La syntaxe est: GP.REPORT,modele_stt,type,gen.stt,sysid.stt,type.lst,no.open,export,file,path,sup.tmp,file.mail,key.mail,cover
Avec:
No | Paramètres | Désignation | Obligatoire | Remarques |
---|---|---|---|---|
1 | modele_stt | Nom de la définition Fxx.STT | Oui | |
2 | type | Type de restitution 1 → PostScript 2 → PDF 3 → Report SB+ 4 → Fichier 5 → HTML 6 → HTML (NO SCREEN) 7 → PDF via mail | Oui | |
3 | gen.stt | Réservé pour utilisation interne | Laisser vide | |
4 | sysid.stt | SYS.ID où se trouve le paramétrage | Si vide: @SYSID local | |
5 | type.lst | Si Type = 1 ou 2 (Post/PDF) 0 → Liste et Graphe 1 → Uniq. Liste 2 → Uniq. Graphe | Si vide, le programme demande le type de liste | |
6 | no.open | Si Type = 2 (PDF) 1 → le fichier PDF ne s'ouvre pas | ||
7 | export | Si Type = 2 (PDF) 0 → le fichier PDF n'est pas transféré sur le poste local en C:\PDF | ||
8 | file | Si Type = 1 ou 2 ou 4 ou 5 ou 6 ou 7(POST/PDF/Fichier/Html/PDF-mail) Nom du fichier de sauvegarde | ||
9 | path | Si Type = 1 ou 2 ou 4 ou 5 ou 6(POST/PDF/Fichier/Html) Chemin du fichier de sauvegarde | Syntaxe possible : LOC:C:\TRF (génère le fichier dans le répertoire C:\TRF) D3:FAC.TMP (génère le fichier dans le fichier D3 FAC.TMP) UV:FAC.TMP (génère le fichier dans le fichier UV FAC.TMP) Dans les 2 exemples ci-dessous le fichier FAC.TMP peut être un pointeur sur un fichier de l'OS /dos/public/test (génère le fichier directement dans un répertoire du serveur - ici en linux) D:\IBM\UVDB\test (génère le fichier directement dans un répertoire du serveur - ici en windows) |
|
10 | sup.tmp | Si Type = 2 ou 7 (PDF/PDF-mail) 0 → le fichier temporaire n'est pas supprimé | ||
11 | file.mail | Si Type = 7 (PDF-mail) Nom du fichier (D3/UV) contenant le record avec paramétrage Mail | ||
12 | key.mail | Si Type = 7 (PDF-mail) Key du record contenant le paramétrage mail | ||
13 | no.html | Mettre 1 si l'on ne veux pas ouvrir la fenêtre HTML, même si on est en GUI | ||
14 | cover | Mettre 1 si l'on ne veux générer un COVER avant d'imprimer la liste, le code du COVER doit être inscrit dans la définition du STT (F7 Param PostScript/PDF) | ||
15 | aff.file | Si Type = 4 (Texte) et que l'on définit un nom de fichier et un path Mettre 1 si l'on veut que le programme indique ou le fichier est sauvé |
Si vous voulez bloquer un type de restitution, vous devez créer un record 'BLOC.GP.REPORT' dans le fichier F@sysid.PPG et dans l'attribut <1> vous mettez les types que vous voulez bloquer (séparé par des @VM).
Exemple: vous voulez bloquer l'impression et la sortie texte dans les STT de Accountix:
'FAC.PPG','BLOC.GP.REPORT'
<1> 1]4
Exemple:
PRC = "GP.REPORT,TEST,2,,CT,0,1,0,TEST.PDF,dos:/dos/public/dt/tmp/,1" SBREMOTE = "" SBREMOTE<1> = "DT" ; * Utilisateur SB+ SBREMOTE<2> = "" ; * Password si existe SBREMOTE<3> = PRC ; * Process voir ci-dessus pour la syntaxe SBREMOTE<4> = 2 ; * A vérifier!!!!! SBREMOTE<5> = 0 ; * not background (1 = background) SBREMOTE<6> = "VT220" SBREMOTE<7> = "DEFAULT.PRINTER" SBREMOTE<8> = "LOGICAL.PRINTER" CALL SB.REMOTE.PROCESS(SBREMOTE)
Le programme GP.REPORT est prévu pour l'envoi automatique d'une liste STT via mail.
Exemple:
PRC = "GP.REPORT,LISTE.ETAT,7,,,,,,,,,FCT.TMP,MAIL"
Dans ce cas le fichier FCT.TMP contient un record 'MAIL' qui contient le paramétrage d'envoi de mail Structure IN.SND.MAIL <1,1> = serveur smtp <1,2> = serveur d'origine, si pas rempli idem serveur smtp <2> = Adresse email FROM <3> = Nom de l'envoyeur <4,VM> = Adresses destinations <5,VM> = Noms destinataires <6,VM> = Adresses de copie <7,VM> = Noms de copie <8> = Sujet du mail <9,VM> = corps du mail, peut être en HTML , multivalué = multilignes <10,VM> = liste des fichiers … attacher, chemin complet depuis la racine <11> = _OUI --> Identification sur le serveur smtp = _NON --> Pas de gestion de login <12> = login <13> = password <14> = silence (oui/non=défaut) <15> = ajoute confirmation de réception aux emails envoyés L'adresse de réponse de l'accusé de réception est l'adresse de l'envoyeur, celle en <2> (et le nom éventuel) <16,VM> = Liste des copies cachées <17> = _OUI --> retourne une trace des échanges avec le serveur SMTP pour log _NON --> renvoit juste un message d'erreur --> Défaut <18> = Format du charset utilisé. Vide par défaut, on peut spécifier IBM850 pour que les accents soient correctes. (Mais ce format n'est apparemment pas toujours bien reconnu par les lecteurs de mails) <19> = _NON --> Utilise un envoi de mail "standard", sans cryptage ni sécurisation Par défaut = _NON _OUI --> Envoi via un serveur qui supporte TLS <20,1> = Chemin absolu vers fichier de certificat <20,2> = Chemin absolu vers fichier de signature <20,3> = Mot de passe pour débloquer le certificat/signature
Ci-dessous la structure du fichier Fxx.STT nécessaire à la génération des différents documents.
Attribut | Description | C/D | Remarques |
---|---|---|---|
2 | Nom de la liste | Texte | |
Critères de sélection | |||
3 | Descripteur | C;4;5 | |
4 | Opérateur | D;3 | = Egale # Différent > Plus grand que < Plus petit que >= Plus grand ou égal ⇐ Plus petit ou égal |
5 | Opérante | D;3 | Exemple: “?” “[?]” |
Ordre de Tri | |||
10 | Descripteur | C;11 | |
11 | Ascending/Descending | D;10 | 'A'scending 'D'escending |
Champs Affichage | |||
15 | Descripteur | C;16;17;18;19;28;29;30;31;32;33; 34;35;36;37;38;39;67;69;72 | |
16 | Break/Rupture | D;15 | 'O'ui 'N'on |
17 | Eclaté | D;15 | Pour les descripteur MV 'O'ui 'N'on |
18 | C/D | D;15 | Mettre 'C' si Eclaté = 'O', sinon laisser vide |
19 | Total | D;15 | 'O'ui 'N'on |
Fichier | |||
22 | Fichier DICT | ||
75 | Fichier DATA | Uniquement si différent du DICT | |
Paramètres spécifque pour POST/PDF | |||
27 | Nom du document PostScript de Base | Doit exister dans FPS.DOC Les modèles de base fournit sont: LIST.BASE LIST.BASE.LAND LIST.BASE.A3 LIST.BASE.LAND.A3 |
|
34 | En-tête colonne: Position X | D;15 | Facultatif |
35 | En-tête colonne: Fonte | D;15 | Facultatif |
36 | En-tête colonne: Taille | D;15 | Facultatif |
37 | En-tête colonne: Couleur | D;15 | Facultatif |
38 | En-tête colonne: Justification | D;15 | Facultatif |
39 | En-tête colonne: Valeur | D;15 | Facultatif |
28 | Valeur colonne: Position X | D;15 | Facultatif |
29 | Valeur colonne: Fonte | D;15 | Facultatif |
30 | Valeur colonne: Taille | D;15 | Facultatif |
31 | Valeur colonne: Couleur | D;15 | Facultatif |
32 | Valeur colonne: Justification | D;15 | Facultatif |
33 | Valeur colonne: Conversion | D;15 | Facultatif |
67 | Valeur colonne: Afficher colonne | D;15 | Mettre '1' par défaut |
69 | Valeur colonne: Afficher ligne | D;15 | Mettre '0' par défaut |
72 | Valeur colonne: Afficher Valeur | D;15 | Mettre '1' par défaut |
57 | Afficher Grand-Total | Mettre '1' par défaut | |
68 | Afficher un cadre une ligne sur 2 | Mettre '1' par défaut | |
84 | Code COVER |