ETATS PDF. Pourquoi utiliser les états PDF? Comment créer un état PDF? Juin 2010

Transcription

1 ETATS PDF Pourquoi utiliser les états PDF? LEADER Informatique vous propose depuis maintenant plusieurs mois la création d état au format PDF. Ce nouveau format pour vos états offre de nombreux avantages : - La Fiabilité des données : on ne peut pas retoucher le rapport une fois qu il est créé. - Le Formatage des données : avec IReport vous pouvez réaliser des calculs, tris et groupements. - Mise en page personnalisée des données : IReport vous donne la possibilité de placer vos données comme vous le souhaitez. Vous pouvez également insérer un logo, un graphique, un lien html - Format universel : le format PDF est un standard qui assure sa compatibilité avec la majorité des utilisateurs (à la sortie). C est également un format standard à l entrée grâce au format Jasper. - Format convivial : les états en format PDF offre une plus grande lisibilité. Comment créer un état PDF? Dans un premier temps, il vous faut télécharger et installer IReport 3.0.0, indispensable pour la création d un état en PDF. Pour cela dans le module de requêtes, cliquer sur Etat PDF, puis sur Télécharger IReport pour réaliser vos états. Une fois IReport téléchargé, installer le sur votre poste. Ensuite, dans le module Requêtes, cliquez sur créer.

2 Nous prendrons ici l exemple d une liste des affaires nouvelles sur une période. Vous devez dans un premier temps sélectionner les champs que vous souhaitez voir apparaître dans votre états : 1. Sélectionner le champ dans les tables 2. Indiquer un libellé à votre convenance 3. Cliquer sur Ajouter Les champs sélectionnés apparaissent dans le tableau Pour l exemple qui nous concerne, voici les champs à sélectionner : Page 2

3 5. Faire le tri de vos champs pour organiser votre état. Par exemple ici, nous choisissons un tri par nom du client 6. Cliquer sur Générer le CSV. 7. Enregistrer le CSV. 8. Lancer Ireport 9. Il faut maintenant connecter votre source de données. Pour cela dans IReport, cliquer sur Données puis Connexions/Sources de données. 10. Cliquer ensuite sur Nouveau, puis sélectionner Source de données CSV de fichier. Page 3

4 11. Cliquer sur suivant, puis donner un nom à votre source de données. 12. Cliquer ensuite sur Parcourir pour récupérer le fichier CSV enregistré auparavant Aller ensuite dans l onglet «Separators» et choisir «Point -virgule» comme séparateur de champ Aller ensuite dans l onglet «Séparateurs» 15. Cocher la phrase «Ignorer la première ligne» Cliquer sur le bouton «Extraire les noms de colonnes...» Les noms des champs spécifiés au préalable s affichent dans la fenêtre. 17. Vous pouvez maintenant enregistrer Cliquer sur l icône «baguette magique» pour lancer l assistant de création de rapport. Page 4

5 19. Sélectionner votre source de données, puis cliquer sur suivant. 20. En cliquant sur >>, vous ajoutez tous les champs à votre rapport. 21. Pour l ensemble de vos champs numériques, vous devez impérativement sélectionner la classe de champ : java.lang.double 22. Cliquer sur le bouton suivant jusqu à la fin de l assistant. Votre rapport est créé, il vous reste à le mettre en forme. Personnalisation de votre rapport Par défaut, Ireport crée un rapport basique contenant les sections (bandes) suivantes : Title, pageheader, column- Header, detail et pagefooter. Si la forme de ce rapport est correcte, passer à l'étape suivante de création du rapport. Bandes Les bandes sont les différentes parties de votre rapport (title, pageheader, columnheader, detail et pagefooter). Elles ont chacune des propriétés d affichage différentes. title : Titre du rapport. Cette bande n apparaît qu une seule fois dans le rapport, sur la première page. pageheader : Cette section apparaît en haut de chaque page du rapport. C'est un bon emplacement pour une date ou pour un numéro de page. columnheader : Cette section constitue l'en-tête du tableau de votre rapport et est donc par défaut utilisée pour les textes statiques. detail : C'est l'endroit où les informations de chaque enregistrement sont placées. pagefooter : Cette section apparaît au bas de chaque page du rapport. On y place souvent le numéro de page. L ensemble de ces bandes peuvent être ajustées à votre convenance (plus ou moins hautes). Page 5

6 Mise en page À l origine, l ensemble de vos champs seront disposés de la manière suivante : Vous obtenez alors la mise en page suivante : Vous pouvez disposer vos champs différemment pour obtenir une tout autre mise en page. Vous pouvez également modifier les intitulés de vos titres et colonnes. Vous obtenez alors la mise en page suivante : Style Avec Ireport, vous avez la possibilité de modifier la police, la taille, les bordures, les alignements, de l ensemble de vos champs. Pour cela il vous suffit de sélectionner le ou les champs concernés, faire un clic droit, propriétés et mettre en place les modifications de vos choix. Page 6

7 Ajout de logo et image Afin de personnaliser votre rapport, vous allez pouvoir y insérer des logos et autres visuels. Pour cela, cliquer sur l icône «image» dans IRreport, et créer votre zone d image à l emplacement souhaité. Double-cliquer sur cette zone, rechercher votre image. Dans la fenêtre «Expression de l image», conserver uniquement le nom de l image et inscrire./(nom de l image) Réitérer le processus pour chaque visuel à ajouter. Remarque : Lors de la phase de finalisation n oubliez pas de charger dans NovaNet les visuels insérés dans votre rapport. Suivre les indications page 10. Page 7

8 Pour exemple ici, nous changeons la police, la couleur, le style, les alignements, les bordures et ajoutons un logo. Comment faire une somme dans votre rapport? Grâce à IReport, vous pouvez insérer des sommes à votre rapport : 1. Vous devez ajouter une bande à la fin de votre rapport, où sera effectuée la somme. Pour cela, faire un clic droit sur votre rapport et sélectionner «propriétés de bande». Choisir «columnfooter» et inscrire une hauteur (de préférence inférieure à 100 ). Une bande s insère à la fin de votre page. Page 8

9 2. Vous devez maintenant créer votre variable SOMME. Pour cela, dans le menu de gauche, faire un clic droit sur «variables» puis sélectionner «add» et «variable». - Nommer cette variable : ex. SOMME TTC Annuel - Indiquer le type de classe : java.lang.double - Préciser le Type de calcul : Somme - Dans Expression de variable, sélectionner la variable à sommer. Ici, ttcannuel. Sélectionner la variable à sommer ici. 3. Ajouter le champ SOMME que vous avez créé dans la zone «columnfooter» Remarque : vous pouvez insérer une zone de texte statique dans la zone «columfooter» afin de préciser la nature de cette somme. Pour cela cliquer sur l icône T (Texte statique) de la barre d outils. Exemple ici : Total TTC annuel. Page 9

10 Finalisation de votre état 1 Une fois votre rapport terminé, vous devez le compiler. Cela vous permettra d obtenir votre rapport en.jasper, format utilisé dans NovaNet. 1. Pour cela, cliquer sur l icône «compilation». 2. Retourner dans le module de requête de NovaNet pour charger votre rapport. Cliquer sur Parcourir et sélectionner votre rapport en.jasper. Il se trouve dans le répertoire : C:\Program Files\JasperSoft\iReport-3.0.0\ 3. Si vous avez inséré des images à votre rapport, chargez les ici en cliquant sur Parcourir. Une fois le visuel sélectionné, cliquer sur charger. 4. Donner un nom à votre état. 5. Valider Maintenant que votre état est créé, vous devez créer la requête. Pour suivre notre exemple, voici ci-dessous la requête à effectuer : Rq : N oubliez pas de sélectionner Etat PDF Page 10

11 5. Sélectionner votre état dans le combo box, alors les champs de sortie apparaissent dans la fenêtre basse. 6. Donner un nom à votre requête. 7. Valider Exécuter votre requête, vous obtenez alors votre rapport au format PDF. Client 1 Client 2 Client 3 Client 4 Client 5 CL2RR CL5dd Page 11

12 Les trucs et astuces pour aller plus loin Paramètres saisis en entrée Lors du lancement d une requête, on entre parfois des paramètres avant l exécution de cette dernière. Il peut être utile de récupérer ces champs lors de la création d un état. Par exemple pour notre «Liste Police», nous saisissons les dates d effet permettant d obtenir la liste des polices pour une période donnée. Il vous faut ajouter ces champs dans IReport,. Pour cela, dans le menu de gauche, cliquer droit sur champs, puis add, puis field. Nommer ce champ de la manière suivante : «PI_ 1» (1 pour le premier champ, 2 pour le deuxième champ, etc ). Attention, il est important de respecter cette nomenclature. Vous retrouvez les champs créés dans le menu «champs» à gauche de l écran. Il vous suffit maintenant des les faire glisser sur votre page, à l endroit de votre choix. Menu «champs» Cet exemple nous permet d afficher en titre de page la période sélectionnée pour la liste des polices. Page 12

13 2. Affichage des «null» Il est possible de supprimer les «null» qui apparaissent dans votre rapport lorsque les champs ne sont pas renseignés. Pour cela, il vous suffit de cliquer droit sur chacun des champs concernés. Choisir Propriétés, Onglets Zone de Texte et cocher la case «vide si nul». Page 13

14 3. Groupement Avec IReport, il est possible de regrouper les informations de votre rapport selon le critère de votre choix. Pour cela, cliquer sur l icône groupement. La fenêtre 1 s affiche, cliquer sur Nouveau. La fenêtre 2 s affiche, nommer votre groupe et cliquer sur l icône «éditeur d expressions» La fenêtre 3 s affiche, sélectionner le champs à partir duquel vous voulez grouper. Pour notre exemple, nous souhaitons grouper les polices par numéro de client, nous choisissons donc numclient. Fenêtre 1 Fenêtre 3 Fenêtre 2 Cliquer sur Appliquer, puis OK. Fermer la première fenêtre. Deux nouvelles bandes apparaissent sur votre rapport, correspondant au Header et Footer de votre groupe. Placer dans la bande groupeheader, les champs que vous voulez voir apparaître en début de chaque groupement. Pour notre exemple, nous affichons le numéro client et le nom client. Dans la bande groupefooter, placer les champs que vous voulez voir apparaître en fin de chaque groupement. Pour notre exemple, nous affichons le total TTC annuel par client. (cf Somme par groupement). Nouvelle bande «groupeheader» Nouvelle bande «groupefooter» Page 14

15 4. Somme sur un groupement Pour réaliser une somme dans un groupement, suivre le paragraphe «Comment faire une somme dans votre rapport?» (pages 8/9). Attention, il y a une étape supplémentaire lors de la création de la variable somme. - Nommer cette variable : ex. TTC Annuel Clients - Indiquer le type de classe : java.lang.double - Préciser le Type de calcul : Somme - Dans Expression de variable, sélectionner la variable à sommer. Ici, ttcannuel. - Dans le champ Réinitialiser le type, choisir Groupe, - Puis dans le champ Réinitialiser le groupe, choisir le groupement créé auparavant. On obtient l état PDF «Liste Polices» ci-contre : CLIENT1 CLIENT2 CL2RR CLIENT3 CLIENT4 Page 15