Page : 1 Reports sorties Excel,.pdf, Spool 1. Introduction et Objectifs de Smart Excel Report... 2 2. Exemple exécution d un pgm Smart Excel/Report... 3 3. Niveau 0. Création d un programme Smart Excel/Report très Basique... 4 a. Niveau 0 : Etape 2 : choisir un fichier Maître.... 5 b. Niveau 0. Etape 3 : Design... 6 c. Niveau 0 Design Détail Report... 7 d. Niveau 0. Gérer formats début... 8 d. Niveau 0. Appeler le programme Smart Excel/Report... 10 4. Niveau 1 : Colonnes et données de travail... 13 a. Niveau 1 Déplacer une colonne.... 13 b. Niveau 1 : Données de travail. Total niveau Ligne.... 14 5. Niveau 2 : Ajout fichiers secondaires. Autres données de travail.... 18 a. Niveau 2 : Ajout fichiers secondaires... 18 b. Niveau 2 : ajout d une date donnée de travail-... 20 c. Niveau 2. Donnée de travail : concaténations séparées par des blancs... 24 6. Niveau 3 : Critères de sélection... 27 a. Niveau 3 : critères de sélection autre que dates... 27 b. Niveau 3 : critère de sélection date... 29 c. Niveau 3 : Ajout d un calendrier sur la date.... 30 7. Niveau 4 : Gestion des ruptures. Entête et pieds.... 32 a. Niveau 4 : Déclarer une rupture... 32 b. Niveau 4 : Ajout d une donnée de travail Total colonne à rupture Fin... 34 8. Annexe A : Mise en œuvre de Smart Excel Report... 37 a) Gestion des paramètres pour l utilisateur et programme.... 37 b) Priorités du pré-affichage paramètres dans le fichier PARM_REP :... 37 c) Contenu des critères de sélection... 37 d) Compilation du programme RPG xxx_qj en production... 38 e) Source des programmes W_REPORT de lancement et exécution... 38 9. Annexe B : Lecteur réseau pour lister la Directory de l IFS... 40 a) Objectif... 40 b) Configurer NetServer... 41 c) Créer le partage dans l IBM i NetServer... 42 d) Rattacher le Réseau de Windows au Serveur... 43
Page : 2 Objectif Smart Excel/Report Caractéristiques Smart Excel/Report Objectif de la brochure 1. Introduction et Objectifs de Smart Excel Report En entrée l utilisateur saisit : Des critères de sélection. Si un critère est renseigné, il est pris en compte. Si un critère est laissé à blanc, tout est pris. La sortie qu il souhaite :.csv ou/et.pdf ou encore une sortie spool ou html ou texte. En sortie l utilisateur demande souvent les sorties suivantes:.csv : www.repeglio.com/detailduclient00010.csv.pdf Report : www.repeglio.com/detailduclient00010.pdf De même nom. Note : avec critères saisis sur la 1 ère page du Report en.pdf Les programmes Smart Excel/Report sont générés automatiquement à l aide de l outil expert RePeGlio. Des programmes RPGIV modulaires et commentés sont générés, de sorte qu il n y a pas de dépendance avec un éditeur. Les programmes peuvent être personnalisés sur le long terme par tout développeur RPG si nécessaire. La brochure vous permettra de réaliser des programmes pas à pas avec plusieurs niveaux d apprentissage : Du niveau de base Niveau 0 au niveau 4. Un programme basic sera généré au niveau 0 puis enrichi et modifié à mesure avec les niveaux 1, 2, 3 et 4. A l issue du niveau 4, Smart/Excel Report pourra être utilisé pour les applications complexes en production. Ergonomie 2 Fonctions à retenir pour une meilleure prise en main du produit : F10 pour quitter un menu déroulant et revenir sur le corps du texte F09 Pour valider un écran.
Page : 3 2. Exemple exécution d un pgm Smart Excel/Report Note : cet écran est facultatif pour l utilisateur. L utilisateur choisit par exemple : Ses sorties. Ici.csv pour Excel et sortie.pdf L utilisateur saisit ses critères de sélection pour le programme : Société 01 départ. 01 Tout le mois de Janvier 2007 Le Report et l extraction sont soumis en batch Finalement l utilisateur récupère dans sa directory :.csv : www.repeglio.com/detailduclient00010.csv.pdf Report : www.repeglio.com/detailduclient00010.pdf
Page : 4 3. Niveau 0. Création d un programme Smart Excel/Report très Basique nouveau Depuis menu général RePeGlio Choisir le modèle PRT pour faire *pgm Smart Excel/Report de base en RPG PRT Saisir le nom Ne pas oublier le séparateur
Page : 5 a. Niveau 0 : Etape 2 : choisir un fichier Maître. 132 ou 198 colonnes/page Etape 2 : choisir un fichier Sélectionner une bibliothèque dans la *libl pour le fichier Sélectionner ARC_DEMOFR bibliothèque de test et de formation F4=Sélection F9=Valider
Page : 6 b. Niveau 0. Etape 3 : Design Choisir un fichier Maître. Pour le niveau 0 nous n aurons qu un seul fichier. Curseur + Entree pour sélectionner le fichier logique détail commande avec clés uniques F9=Valider ETAPE 3 : Design Niveau 0 : nous allons juste sélectionner quelques zones du fichier commandes au niveau détail.
Page : 7 c. Niveau 0 Design Détail Report Saisir 2 car pour le Niveau 0 nous n allons pas définir de rupture. Gérer Détail qui correspond à la ligne de sous-fichier pour le PRTF. Ajouter des données sélectionnées dans la partie détail. Curseur + ENTREE dans l espace compris entre fichier et clés «Détail Commande»
Page : 8 Design Suite Sélectionner des données 1+ENTREE Ou F11 tout sélectionner F20=A droite F19=A Gauche Nous verrons dans le chapitre suivant comment : Changer les sous-titres Mettre un code édition Ajouter une donnée de travail Effectuer un calcul ou un pré-affichage Déplacer une colonne Pour le moment nous allons seulement modifier le titre général, aussi valider F9=Valider d. Niveau 0. Gérer formats début Gérer Format DEBUT puis Début page à l Overflow
Page : 9 Lignes entête Cliquer sur le titre pour le modifier Remplacer «TITRE EDITION» par votre titre. F9=Valider F9=Valider Vous devez avoir un report très simple qui ressemble à ceci. F9=Valider F9=Valider
Page : 10 1=Générer le Smart Excel/Report F9=Valider Depuis le menu principal RePeGlio : /IBM i OS/ puis WRKSBMJOB/session Afin de suivre le déroulement du travail en cours. Vous devez avoir 1 1 pour source RPG et pour la compilation. Si 0 erreur génération ou 0 compilation. d. Niveau 0. Appeler le programme Smart Excel/Report Note : ESAMRTA_QC est le CLLE d appel du programme en batch. Entre autre, il contient un OVRPRTF que vous pourrez modifier au besoin. Pour le moment, nous allons appeler le programme pour le tester. Depuis le menu général RePeGlio : /CALL *PGM/ le programme étant sélectionné (en rouge)
Page : 11 Commande CALRPT ENTREE=Valider 4 2 5 3 1 1=Affichage de cet écran intermédiaire pour l utilisateur. Si 0 les valeurs par défaut doivent être préalablement renseignées. Si 0 l écran intermédiaire ne s affichera pas. 6 7 8 1) *JOBD sera prise au niveau du SBMJOB avec la *LIBL de la JOBD. Sinon *CURRENT *LIBL Session en cours. 2) Sortie Excel=1 Détail.csv=1 pour le détail Si 0 il doit y avoir dans l édition une ligne total à rupture. 3) Choix entre sorties : spool ou/et.pdf ou/et.htm ou/et.txt 4) Le nom dans la directory par défaut est le nom du programme. Exemple : ESAMRTA.pdf ESAMRTA.csv 5) La directory utilisateur dans l IFS doit exister. 6) Paysage 132 ou 198 ou Portrait 7) Lien contenant le logo facultatif et taille relative à la taille réelle du logo en %. Le logo doit être un.jpg 8) 2 lignes facultatives figurant en bas de l édition. /IBM i OS/ puis WRKSBMJOB Pour suivre l exécution du travail Dans le Drive partagé Windows vers L IFS. Voir plus loin comment déclarer un Drive sous Windows. Vous devez avoir: le.txt ou le.pdf ou le.xls ou le.htm
Page : 12 Niv1 Colonnes et données de travail
Page : 13 4. Niveau 1 : Colonnes et données de travail a. Niveau 1 Déplacer une colonne. Rappel : se positionner sur Design et Détail : Curseur + ENTREE sur le programme à traiter (rouge) Menu Général puis /RePeGlio/ 3) Design Saisir 2 pour aller directement au Design sans les ruptures (traitées plus loin) /Gérer Elément PRTF/ Gérer Formats DETAIL PRTF Soit à déplacer le code article APRES la Quantité commandée. La position de la Quantité commandée est comprise entre 54 et 69. Curseur + ENTREE sur colonne «Code Article» En regard de «Colonne insertion» Saisir par exemple 54< 60 >69 Et la colonne ira après la colonne visée La colonne est déplacée APRES celle visée, ici «Quantité Commandée».
Page : 14 b. Niveau 1 : Données de travail. Total niveau Ligne. Nous allons ajouter une donnée de travail «Prix Total» qui est égal à la quantité * prix Au niveau détail du Design : /Opération/ «Ajout donnée/objet» Placer le curseur sur la ligne : «DONEES DE TRAVAIL» Puis ENTREE F6=Ajout Puis saisir le nom de la variable de travail, les libellés des deux sous-titres et la longueur en numérique N F9=Valider 1 Sélection= 1 en regard de TOTLIGN ENTREE= Avec titre. Puis F9=Valider
Page : 15 Curseur + ENTREE sur la colonne pour code édition et calculs F20=+40 F11=Edit code Code édition = 4 F9=Valider ENTREE = SUITE Pour une donnée de travail, il y a toujours des finitions. 1 Sélection=1 en regard de «W_CALCUL» Sélection= 1 en regard «EVAL» «Calculs libres» 1
Page : 16 Sélectionner CDDQSA puis * puis CDDPVB Note : vous pouvez soit écrire la formule directement en regard de EVAL TOTLIGN = CDDQSA * CDDPVB soit sélectionner les champs et opération. La sélection est une aide à la saisie. Note 2 : Arrondi règle du 5 par défaut. Formule TOTLIGN =
Page : 17 Niveau 2 Ajout fichiers secondaires. Autres données de travail.
Page : 18 5. Niveau 2 : Ajout fichiers secondaires. Autres données de travail. a. Niveau 2 : Ajout fichiers secondaires Sélectionner le programme de type PRT. Nous allons ajouter des fichiers secondaires. 3) fichiers utilisés Puis fichiers secondaires. Nous allons ajouter le fichier secondaire «ENTETE Commande» et le fichier secondaire «CLIENT» en relation avec le fichier «ENTETE» par le code client. Note : si la liste des fichiers ne correspond pas, il est nécessaire de restaurer la liste des fichiers en ligne. Sélectionner «CDENTL0» fichier entête commande. Curseur + ENTREE F4=Zones du fichier CDLDETL0 pour sélectionner la clé étrangère. Rechercher les 3 clés de l entête commande 1 à 1 dans le fichier majeur CDLDETL0 détail commandes.
Page : 19 Sélectionner CDDSOC à mettre en regard du code société du fichier entête. Note : les zones de même taille et même nature que la clé sont en rose afin de faciliter la sélection. CDLENTL0 a 3 clés de jointure avec CDLDETL0 Sélectionner pour renseigner les 3 clés afin d établir la relation. F9=Valider Vous devez obtenir ce graphe avec les 3 clés étrangères. Ajouter le fichier CAASTPF client commande F4 F4 ATTENTION : sélectionner le fichier secondaire CDLENTL0 pour la clé code client. F9=Valider
Page : 20 Vous devez avoir le dessin suivant avec un fichier primaire et deux fichiers secondaires, dont CAASTPF fichier clients. b. Niveau 2 : ajout d une date donnée de travail- Nous allons ajouter la date commande dans le fichier aaaammjj affichée sous forme jj/mm/aaaa Il nous faudra créer une donnée de travail Numérique de 8 avec un masque d édition pour la date. Saisir une donnée numérique de 8 de long Sélectionner la donnée de travail F9=Valider
Page : 21 Sélectionner la colonne Date Commande (position curseur + ENTREE) F11=Code édition Note : le code édition peut être appelé directement curseur sur colonne + F11 Y pour un masque d édition sur la date. F9=Valider. ENTREE=Suite Le système détecte une donnée de travail, donc propose des pré-affichages et calculs. Sélectionner W_PREAFP pré-affichages. Sélectionner CVTDATPRT préaffichage date
Page : 22 Sélectionner le format de la date vu par l utilisateur dans le.csv ou.pdf Sélectionner la date commande du fichier Entête CDLENTL0 Sélectionner le format de la date commande CDDATC dans le fichier CDLENTL0 F9=Valider
Page : 23 Ecran de validation. OK. F9=Valider Avec Excel la date doit apparaitre ainsi : Le total ligne est également une donnée de travail calculée.
Page : 24 c. Niveau 2. Donnée de travail : concaténations séparées par des blancs Au niveau du détail : Ajouter une donnée de travail alphanumérique pour y peupler des champs concaténés. Sélectionner la donnée concaténée F9=Valider Sélectionner la colonne «Données concaténées» Curseur + ENTREE ENTREE = Suite
Page : 25 Sélectionner finitions : W_PREAFP + CONCAT_1B pour concaténation de champs, contenus séparés par un blanc. WCONCFLD est la donnée de travail à peupler. Sélectionner les données dans l ordre, l une après l autre. Vérifier WCONCFLD. Si les données sont les bonnes et dans le bon ordre : F9=Valider Si refaire : F5=Effacer Au niveau du.csv Code postal + ville + adresse doivent être concaténés en fonction de la longueur du champ résultat
Page : 26 Niveau 3. Critères de sélection
Page : 27 6. Niveau 3 : Critères de sélection a. Niveau 3 : critères de sélection autre que dates Curseur + ENTREE pour sélectionner ESAMRTA type PRT /Critères de Sélection/ Nouveau *PGM critères de sélection _QE : Programme interactif de saisie des critères _QC : CL soumis en batch _QJ ; Filtres en fonction des critères de sélection. /Gérer élément/ Gérer corps puis : /Opt_champ/ Ajout données
Page : 28 /Opt Champ/ puis Données pour sélection Sélectionner les critères de sélection un après l autre en précisant l opération comme décrit plus bas F4=Opérations Sur les critères Pour la date commande procéder comme ci-après :
Page : 29 b. Niveau 3 : critère de sélection date Saisir type de donnée = 1 pour la date 1 Sélectionner CDDATC Date commande Saisir GE >= avec le format saisie et le format de la date dans le fichier F9=Valider Puis saisir LE <= afin d avoir les valeurs entre deux dates. Ici même donnée CDDATC date commande. F9=Valider Parmi les opérateurs classiques nous avons : SC SCAN qui permet un scan de recherche avec conversion des majuscules en minuscules et le caractère de remplacement * Exemple : SCAN sur la raison sociale du client ou sur un libellé produit. VA Liste de plusieurs valeurs 2 à 9 maxi qui correspondent à des OU inclusifs.
Page : 30 c. Niveau 3 : Ajout d un calendrier sur la date. Pour ajouter un calendrier sur les dates, Curseur+ENTREE sur la date ENTREE=Finitions F4=Liste de sélection OU calendrier pour date. Note : nous verrons les listes de sélection plus loin. Sélectionner P_F04 puis SELDAT Sélectionner Curseur+ENTREE le format de la date saisie par l utilisateur et à retourner par le calendrier Ici : jjmmaaaa F9=Valider F9=Valider
Page : 31 Niveau 4. Gestion des ruptures
Page : 32 7. Niveau 4 : Gestion des ruptures. Entête et pieds. a. Niveau 4 : Déclarer une rupture Curseur+ENTREE sur le programme PRT puis menu Design CDDSOC + CDDDEP + CDDNUM sont les trois clés majeures qui formeront une seule rupture. A chaque changement d une des trois valeurs, un pied sera affiché ainsi qu un entête. Il peut y avoir de 1 à 9 numéros de rupture, 9 étant le plus grand et 1 le plus petit.
Page : 33 F9=Valider Répéter 3 fois pour chaque rupture de niveau 1 même niveau pour les trois clés-. Le saut de page peut être demandé à chaque rupture ou à l Overflow. Nous allons faire une sommation du montant total des lignes, donnée de travail numérique alignée sur la colonne «Total Ligne»
Page : 34 b. Niveau 4 : Ajout d une donnée de travail Total colonne à rupture Fin Nous allons ajouter une donnée de travail pour le total commande qui sera la sommation du total ligne. Curseur+ ENTREE sur Données de travail Saisir la donnée de travail total commande 13,2 1 1=Sélectionner TOTCOM F9=Valider F9=Valider
Page : 35 Placer la donnée avec le libellé à proximité de la colonne Total ligne Curseur+ENTREE sur TOTCOM Pour déplacer le libellé puis la donnée au-dessus du total Curseur+ENTREE Réajuster le libellé et le champ au-dessus du total F9=Valider Sélectionner W_CALCUL puis SUM puis Total ligne Afin d effectuer la sommation colonne F9=Valider F9=Valider
Page : 36 Annexe A : Mise en œuvre de Smart Excel Report
Page : 37 8. Annexe A : Mise en œuvre de Smart Excel Report a) Gestion des paramètres pour l utilisateur et programme. Le programme pour mettre à jour les paramètres du fichier PARM_REP: A partir du menu général RePeGlio : /Système/ puis «Parms Smart Report.» Conseil : pour obtenir les valeurs par défaut pour un utilisateur, outre F6=Créer, vous pouvez utiliser 3=copier b) Priorités du pré-affichage paramètres dans le fichier PARM_REP : Priorité 1 : Si un enregistrement Profil Utilisateur + Nom de programme existe, les valeurs sont prises en pré-affichage. Sinon Priorité 2 : Si valeur *ALL programmes + Nom Utilisateur, les valeurs par défaut sont prises en pré-affichage. Sinon Priorité 3 : Si valeur Nom Programme + *ALL Utilisateurs, les valeurs par défaut sont prises en pré-affichage Sinon Priorité 4 : Si *ALL Programmes + All Utilisateurs, les valeurs par défaut sont prises en pré-affichage Sinon Un enregistrement par défaut *ALL + *ALL est créé avec sortie spool uniquement ET priorité 4 appliquée. c) Contenu des critères de sélection Le contenu des critères de sélection est stocké dans un fichier ARC_OBJ/WUSRRQST Ce fichier est indexé par programme+utilisateur. Les paramètres sont concaténés les uns à la suite des autres dans une zone de 1024 caractères. Il peut être intéressant d intervenir par programme dans ce fichier afin de lancer automatiquement une extraction, la valeur de OKSEL= 0 de la commande de lancement CALRPT.
Page : 38 d) Compilation du programme RPG xxx_qj en production. ** COMMENT COMPILER XXX_QJ -voir xxx_qc pour WWRKFILE- ** ** CPYF FROMFILE(xxx) TOFILE(QTEMP/WWRKFILE) + ** CRTFILE(*YES) NBRRCDS(1) ** MONMSG MSGID(CPF0000) ** CLRPFM FILE(QTEMP/WWRKFILE) ** MONMSG MSGID(CPF0000) ** RMVLIBLE QTEMP ** MONMSG MSGID(CPF0000) ** ADDLIBLE QTEMP *FIRST ** CRTBNDRPG PGM(XXX/XXX_QJ) + ** SRCFILE(YYYY/ZZZZ) + ** SRCMBR(XXX_QJ) + ** REPLACE(*YES) ** Note technique : l instruction bien connue CPYF avec CRTFILE(*YES) est capable de créer un fichier Physique en reprenant la définition de tout fichier, y compris un fichier joint ou un LF ou un index SQL. Seul bémol, cette instruction ne fonctionne que si un enregistrement au minimum est créé NBRRCDS(1). D où l instruction qui suit CLRPFM Par la suite un OVRDBF va substituer le fichier WWRKFILE au fichier Primaire d édition. e) Source des programmes W_REPORT de lancement et exécution Les membres source programmes de lancement se trouvent dans HARCHIPEL/REPSRC : W_REPOR_2 RPGLE MAJ Fic Parms Smart Report W_REPOR_3 CLLE retrieve _qe W_REPOR_4 CLLE retrieve _jobq outq W_REPOR_5 CLLE Control OUTQ and LIB W_REPOR_6 CLLE sbmjob report W_REPORT RPGLE Pgm de lancement Pour les compiler, procéder comme suit : Mettre dans une bibliothèque en amont dans la *libl le programme W_REPORT que vous avez modifié. Compiler les 6 programmes RPG avec la commande pdm option 15 CRTRPGMOD Ensuite lancer ces deux commandes avec ARC_OBJ en ligne : CRTSRVPGM SRVPGM(xxxxx/W_REPOR_5) MODULE(W_REPOR_5) + EXPORT(*ALL) + ACTGRP(*CALLER) Puis : CRTPGM PGM(xxxxxx/W_REPORT) MODULE(W_REPORT + W_REPOR_2 + W_REPOR_3 + W_REPOR_4 + W_REPOR_6 + ) + BNDSRVPGM( + W_REPOR_5 + WCLRMSG + WSNDMSG + ) + ACTGRP(REPEGLIO) Où xxxxxx est votre bibliothèque avant ARC_OBJ dans la *libl
Page : 39 Annexe B : Lecteur réseau partagé entre PC et IBM i.
Page : 40 9. Annexe B : Lecteur réseau pour lister la Directory de l IFS a) Objectif Obtenir un lecteur réseau comme par exemple Z : qui liste la directory de l IFS de l IBM i. Demande le mot de passe Liste la directory de l IFS pour accéder aux documents générés. Pour configurer le lecteur réseau vous devez avoir : -) version V5R2 minimum de l IBM i -) Windows sur le PC : aucun logiciel supplémentaire n est nécessaire -) IBM i Navigator côté PC est requis.
Page : 41 b) Configurer NetServer Le sous-système QSERVER doit être démarré pour démarrer NetServer. S en assurer avec un WRKACTJOB côté IBM i. Avec IBM i Navigator aller : Click droit sur NetServer puis OPEN pour Ouvrir NetServer (Started). Pour changer les propriétés de NetServer, Click droit et «Properties» (propriétés) Si vous changez les propriétés il faut redémarrer NetServer Vous pouvez ouvrir NetServer depuis l IBM i avec les commandes : STRTCPSVR *NETSVR ENDTCPSVR *NETSVR Autres commandes IBM i à connaitre : WRKLNK pour lister la directory et MKDIR pour créer une directory Soit créer une directory nommée MaDirectory avec la commande MKDIR Wrkaut /MaDirectory pour réviser les droits, ou encore l option 9 avec WRKLNK
Page : 42 c) Créer le partage dans l IBM i NetServer Click droit sur «File Shares» fichiers partagés puis sur «Open NetServer» Click droit sur «Shared Objets» Objets partagés puis Fichier, nouveau. Nom partagé : tel qu il apparaitra sur le network. Access : Read/Write pour autoriser les modifications du document par l utilisateur Enfin la Directory.
Page : 43 d) Rattacher le Réseau de Windows au Serveur Le réseau est maintenant accessible! Sur le PC cliquer sur «Outil» puis «Connecter un lecteur réseau» La lettre Y : correspond au lecteur réseau de l IFS MaDirectory En cliquant sur poste de travail, les réseaux doivent s afficher. Il suffit ensuite de créer un raccourci sur le bureau pour accéder directement à l IFS à condition d avoir les droits.