Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Création du document : Stéphanie GORGONE – Chloé MANDON Groupe Restitution Jasp

Création du document : Stéphanie GORGONE – Chloé MANDON Groupe Restitution Jasper Date : 12/02/2011 RAPPORT TECHNIQUE JASPER PROJET DARTIES – GROUPE2 1 RAPPORT TECHNIQUE JASPER PROJET DARTIES – GROUPE2 I. CONTENU I. Contenu.......................................................................................................................................1 II. Introduction..................................................................................................................................2 III. Création d’un document jasper.................................................................................................3 1. Les tableaux.............................................................................................................................3 Création de modeles de tableaux................................................................................................3 Les différentes zones d’un rapport...............................................................................................5 Respect du SFD..........................................................................................................................5 2. Les graphiques.........................................................................................................................6 Creation de modeles de graphiques............................................................................................6 Respect du SFD..........................................................................................................................6 IV. Intégration des tableaux et graphiques en Java.......................................................................7 1. Choix du fichier Jasper.............................................................................................................7 2. Chargement et compilation d’un rapport jrxml..........................................................................8 3. Changement de requêtes.........................................................................................................8 Changement de la clause WHERE de la requête........................................................................8 CHANGement de la clause select de la requete..........................................................................9 4. Passage des paramètres.......................................................................................................10 Titres et sous-titres des rapports................................................................................................10 Periodes dans l’entete des tableaux..........................................................................................10 V. Conclusion.................................................................................................................................11 2 II. INTRODUCTION iReport est un éditeur graphique permettant de concevoir des modèles de rapport. Ce logiciel Open Source fonctionne à partir de la librairie JasperReports. Il permet de créer différents types de rapports (tableaux, graphiques, etc.) et d’en visualiser le rendu. La création d’un rapport permet d’obtenir un fichier XML (fichier jrxml). Nous utilisons ces fichiers XML dans notre application pour afficher les tableaux et graphiques. En effet, un dossier « TableauxXML » comporte tous les fichiers XML des tableaux et graphiques créés sous iReport. Ensuite, nous utilisons les objets JAVA qui permettent la génération d’un rapport (ces derniers seront détaillés dans la deuxième partie du rapport). Les données des tableaux ou des graphiques seront alimentées par une base de données. La sélection de ces données se fera par une requête associée à chacun des tableaux ou graphiques. Pour simplifier la création de ces différents tableaux, nous avons choisi de créer un tableau pour chaque couple indicateur-caractéristiques. Plus précisément, pour chaque onglet, nous avons un tableau pour un indicateur et une caractéristique (par exemple un tableau CA-toutes caractéristiques, un autre CA-Réalisé etc.). Si un onglet permet de voir toutes les caractéristiques (Objectifs, Réalisé, Toutes) et tous les indicateurs (CA, Ventes, Marges, Toutes), il y aura 12 modèles de rapport créés (en fichier jrxml). 3 III. CRÉATION D’UN DOCUMENT JASPER 1. Les tableaux CRÉATION DE MODELES DE TABLEAUX La première étape de création d’un rapport consiste à créer un document vide avec une requête SQL générale (sans quoi la génération du rapport ne fonctionne pas). La liaison entre un tableau et la base de données se fait via un dataset (ensemble de données récupérées par partir d’une requête SQL). La création d’un tableau se fait à l’aide du dataset. Il permet de récupérer les champs de la base de données que l’on veut afficher dans le tableau. Ensuite on peut remplir le tableau en associant une expression (champs résultant de la requête ou champs saisissables) à chaque case de celui-ci. Nous avons dû réaliser toutes les requêtes pour les affichages dans les tableaux. Pour pouvoir afficher les écarts, le calcul a été fait dans la requête SQL. De même pour le rang, il a été calculé avec l’utilisation de la clause SQL RANK OVER(). Or pour pouvoir afficher la ligne des totaux (somme correspondant au total d’une colonne et écart total), nous avons utilisé des variables. Celles-ci donnent la possibilité d’effectuer des opérations de calculs sur les expressions et de les afficher. L’opération utilisée dans ce cas est un SUM de l’expression à sommer. Dans l’exemple ci-dessous, on peut voir que l’on fait la somme (calculation SUM) de la variable SUM(CAOBJECTIFFAITS) (propriété variable expression). Le dataset palmares a été créé et permet de récupérer les champs résultat (Fields) de la requête SQL. Champs saisissables Champs provenant des Fields du dataset 4 Pour les écarts totaux, nous avons effectué un calcul utilisant les deux variables des totaux. iReport permet aussi la création de paramètres. Ce sont des données prédéfinies que l’on ne peut pas trouver dans la source de données. Les paramètres sont définis pour les titres. Ces derniers seront remplacés par les choix effectués par l’utilisateur dans les filtres. Les deux titres sont affichés dans la zone « Title » du rapport (voir explication partie suivante) et sont des paramètres qui prendront la valeur définie par l’utilisateur (à l’aide du code JAVA). Par exemple, si l’utilisateur veut afficher le CA, Réalisé, pour la famille Hifi, le sous-titre contiendra : « CA | Réalisé | Hifi ». Le premier titre contient le nom de l’onglet et la période choisie. Il en est de même pour les tableaux où l’entête correspond au mois ou à l’année choisis par l’utilisateur dans les filtres « périodes ». Des paramètres ont été créés pour pouvoir être associés aux choix de l’utilisateur. Propriété de la variable sélectionnée 5 LES DIFFÉRENTES ZONES D’UN RAPPORT Un rapport comporte plusieurs zones. La zone « Title » est pour le titre et n’apparait qu’une fois en première page du rapport. Les zones « Page Header » et « page Footer » correspondent à l’entête et pied de page du document. Elles apparaissent donc sur toutes les pages du rapport. Ensuite, « Column Header » et « Column Footer » correspondent aux noms de colonnes du tableau de données et sont répétés sur chaque page. C’est dans la zone « Détail » que sont affichées les lignes de résultats des colonnes que l’on désire afficher. Enfin, la zone « Summary » résume des informations présentes dans la zone « Détail » Pour l’application, nous avons défini le titre et sous titre de chaque tableau/graphique dans la zone « Title ». Les tableaux et graphiques, quant à eux sont disposés dans la zone « Détail ». Ils pourraient être placés dans la zone « Column Header » mais celle-ci est limitée en taille et cela génère une erreur lorsque le tableau contient trop de lignes. Les autres zones ne sont pas utilisées. RESPECT DU SFD Chaque tableau est ensuite mis aux normes du SFD avec les règles suivantes :  La police est ARIAL de taille 10,  Les données et les contours sont en bleu,  Le contour du tableau, des colonnes et de certaines lignes sont deux fois plus épais que le contour standard, réservé aux lignes et aux séparations entre caractéristiques,  Un seul chiffre après la virgule n’est autorisé pour les données,  Les milliers sont séparés par un espace,  Les nombres sont justifiés à droite, avec un retrait de 2 pixels, les textes sont justifiés à gauche et les titres sont centrés,  Les cellules des entêtes de colonnes sont grisées, 6  Les titres sont centrés de couleur et taille définis dans le SFD. Pour pouvoir utiliser la couleur rouge pour les écarts négatifs et la couleur verte pour les écarts positifs, nous avons dû utiliser les styles conditionnels. Ces styles correspondent à un rapport. Nous avons tout simplement ajouté un style auquel nous avons ajouté deux conditions (nombre positif ou négatif). Ensuite, on peut modifier les propriétés de chaque condition. Par exemple, pour mettre en vert les valeurs des écarts positifs, nous avons créé un style CA comportant deux styles conditionnels. En première condition, si sa valeur est supérieure à 0, on lui met la couleur verte : Le second style conditionnel dans CA met la couleur rouge si le champ ECARTCA est inférieur à 0. Le style CA possède la couleur bleue du SFD comme couleur de texte par défaut. Ainsi, si le champ vaut 0 (aucune des deux conditions vérifiées), le texte sera bleu. 2. Les graphiques CREATION DE MODELES DE GRAPHIQUES Un modèle de rapport se crée de la même manière que ce soit pour y afficher des résultats sous la forme de tableau ou de graphique (création d’un rapport vide puis d’un dataset). Ensuite il faut choisir un type de graphique, dans notre cas, ce sera des camemberts ou des histogrammes. iReport permet d’ajouter autant de séries qu’on le désire. Les histogrammes en nécessitent 2 (réalisé et objectif). Quant aux camemberts, c’est un affichage des régions. Ils nécessitent donc autant de séries que de régions, soit 5. RESPECT DU SFD Pour respecter le SFD, nous avons personnalisés les séries des graphiques, c'est-à-dire la couleur que doit représenter une donnée. La propriété « series color » d’un graphique permet de définir toutes les couleurs que l’on souhaite. Les légendes peuvent être affichées si le SFD le demande (généralement objectif ou réalisé ou encore le nom des villes). Propriété du style sélectionné Couleur verte Condition 7 IV. INTÉGRATION DES TABLEAUX ET GRAPHIQUES EN JAVA Une fois tous les tableaux et graphiques créés, ils doivent être intégrés dans l'interface de l'application développée en Java sous l'architecture MVC (Modèle-Vue-Contrôleur). Ainsi, dans la partie Jasper du modèle, il existe un traitement par profil distinct (Responsable magasin, Responsable régional et Directeur commercial) ainsi qu'un traitement générique d'un document jasper. Ce dernier permet notamment le chargement d'un tableau ou d'un graphique à partir du document jrxml, et le traitement par profil concerne le changement de requêtes en fonction des paramètres choisis par l'utilisateur. C'est dans la partie contrôleur que le bon fichier Jasper est choisi et appelé au chargement dans le modèle, car uploads/s3/ rapport-technique-jasper.pdf