Vous êtes sur la page 1sur 14

Utilisation de BIRT

par Silvera David (http://dsilvera.developpez.com/)


Date de publication : 15 aot 2011 Dernire mise jour :

Ce tutoriel a pour but de vous initier BIRT. Il vous expliquera comment et pourquoi utiliser cet outil de reporting. Bonne lecture!

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

I - Introduction..............................................................................................................................................................3 I-A - Pourquoi BIRT................................................................................................................................................3 I-B - Installation...................................................................................................................................................... 7 I-C - Fonctionnalits............................................................................................................................................... 7 I-D - Gnration et exportation de rapport Birt......................................................................................................8 II - Data Source........................................................................................................................................................... 8 III - Data Set................................................................................................................................................................ 8 IV - Data Cube.............................................................................................................................................................9 V - Report Parameters................................................................................................................................................ 9 VI - Script..................................................................................................................................................................... 9 VII - La palette de BIRT.............................................................................................................................................. 9 VIII - Les proprits................................................................................................................................................... 10 IX - Master Page....................................................................................................................................................... 12 X - XML Source......................................................................................................................................................... 12 XI - Conclusion.......................................................................................................................................................... 14 XII - Remerciement....................................................................................................................................................14

-2Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

I - Introduction
Le reporting permet de synthtiser des donnes sous forme de rapport. Ainsi, il est plus agrable, plus pratique, plus lisible, plus prsentable d'exploiter nos donnes. Des exemples simples de rapports sont nos bulletins de paye, nos factures, un calendrier de l'anne, le bilan de l'anne, Aujourd'hui, il est facile de gnrer ce type de rapport l'aide d'outil comme Jasper, Pentaho, Business Object, crystal reports, cognos, mais aussi BIRT, celui que j'ai choisi de vous prsenter.

I-A - Pourquoi BIRT


Voici une liste de tableaux comparatifs entre BIRT 2.6.0, Jaspersoft 3.7 Community et Pentaho 3.5. BIRT 2.6.0 Site Internet www.birtexchange.com www.eclipse.org/birt License Eclipse Public License REPORT DESIGNER BIRT Report Designer 2.6.0 Plateforme du Windows, Linux, Mac Designer OS X Plug-in pour Eclipse OUI Plug-in pour NON NetBeans Design Paradigm Web Page Design paradigm: frames, tables, lists Format des rapports XML (les fichiers .RPTDESIGN sont entirement en XML) XML (les fichiers .RPTDESIGN sont entirement en XML) Compilation des Non requis rapports Composant du Designer: BIRT 2.6.0 Sous rapport OUI - dition de rapport OUI - Palette - Explorateur - dition des proprits - Aperu du rapport - Structure du rapport - Expression - Gnrateur de rapport Jaspersoft 3.7 Community OUI OUI Pentaho 3.5 OUI OUI Jaspersoft 3.7 Pentaho 3.5 Community www.jasperforge.com reporting.pentaho.com GNU Lesser General GNU Lesser General Public License Public License Jasper iReport 3.7 Pentaho Report Designer 3.5.0 stable Windows, Linux, Mac Windows, Linux, Mac OS X OS X NON NON OUI NON positionnement des pixels Les fichiers .JRXML sont compils en fichiers .JASPER, qui sont en Java Byte Code Requis positionnement des pixels XML (Les fichiers .PRPT sont des ZIP contenant un fichier XML et d'autres ressources) Requis

-3Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

- Graphique - Gnrateur de Script - diteur Tableaux Tableaux croiss Tri horizontal panoramique Plug-in pour NetBeans Nouvelle/ mise en page multicolonne Lien vers un autre rapport Graphe actionnable Cascading Style Sheets (CSS) Mise en forme conditionnelle Source des donnes :

OUI OUI OUI

NON OUI

NON NON OUI

Toujours dfiler vers le bas, mme si c'est un tableau crois cellules cte cte OUI NON OUI OUI NON OUI NON NON OUI

NON Exprimentale sur Pentaho 3.5 NON

OUI lien, au passage Lien partiel de la souris OUI NON OUI Partielle

BIRT 2.6.0 Plusieurs sources et requtes par rapport OUI + possibilit de jointure

Jaspersoft 3.7 Community Seulement avec des sous-requtes. Une seule source de donnes par sousrequte NON

Pentaho 3.5 Seulement avec des sous-requtes ou des graphes. Une seule source de donnes par sousrequte NON

Possibilit de joindre plusieurs sources de donnes dans le designer Les rapports peuvent re-trier, filtrer ou regrouper les donnes retournes par une requte. Type de source de donnes

OUI

OUI

- Database JDBC - XML File - Web Services - CSV, SSV, PSV, TSV - data source customise - OLAP MDX - POJO,EJB, Hibernate, XML Stream

Partial Jasper peut manipuler les donnes avant de construire un tableau crois - Database JDBC - XML File - CSV File - Microsoft Excel - JavaBeans - Hibernate HSQL - Spring Hibernate EJBQL - XMLA Server - Mondrian OLAP - fichier texte - NetBeans JDBC - POJOs

NON

- Database JDBC - XML files - Table - OLAP MDX - Pentaho Metadata - Pentaho Data Integration - OLAP MDX - POJO, EJB, Hibernate

-4Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

Requte Designer de requte graphique Script

OUI Seulement un prototype - JavaScript - Java Event Handlers

- Custom - Fichier XML OUI OUI OUI (SQL Leonardo) OUI (SQL-Leonardo) - JavaScript - Groovy - Java - JavaScript - Bean Script Framework (BSF) - Bean-Script Host (BSH) - Single Value Query

Format de sortie : BIRT 2.6.0 HTML pagin HTML non pagin PDF Excel (XLS) XML Texte brut RTF Powerpoint (PPT) CSV Postscript OpenOffice (document et feuille de calcul) Microsoft Office 2007 (DOCX, XLSX) Flash (SWF) Format customis Forme gomtrique et ligne Code barre Graphes Assistant Graphe OUI OUI OUI OUI OUI OUI OUI OUI OUI OUI NON NON NON OUI OUI OUI OUI OUI Jaspersoft 3.7 Community OUI NON OUI OUI OUI OUI OUI NON OUI OUI OUI OUI OUI OUI OUI Pentaho 3.5 OUI NON OUI OUI OUI OUI OUI NON OUI OUI NON NON NON OUI OUI OUI OUI NON NON NON NON OUI

OUI OUI 2 tapes assistes, Le reste est une boite de dialogue Interaction avec les OUI (lien, passage de OUI (seulement les graphes la souris) liens) Thmes des graphes OUI OUI Contrle prcis des OUI NON graphes Type de graphe : OUI OUI - 2D - 3D - Camembert - Camembert multiple Bar - Stacked Bar - Bar XY Line - Line XY Area - Area XY Stacked

-5Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

- Area Bar Line - Bubble Scatter Plot Multi-Axis Graphe en anneau Graphe en tube Graphe en cne Pyramide Sries de temps Mesure / Gauge Chute d'eau Radar Thermomtre Gantt chelle Paramtrer le rapport

NON OUI OUI OUI OUI OUI NON OUI NON OUI NON

NON NON NON NON OUI OUI NON NON OUI OUI NON

OUI NON NON NON NON NON OUI OUI NON NON OUI

BIRT 2.6.0 Paramtres statiques Slection des valeurs des paramtres Slection des valeurs des paramtres dans une liste Paramtres dynamiques Slection de la valeur du paramtre selon une liste tire de la base de donnes Paramtres en cascade Date du calendrier pour les paramtres de type date Spcification de la valeur par dfaut Liste case cocher Liste radio bouton Agrgation / Calcul BIRT 2.6.0 agrgations communes - Moyenne - Compte - Compte distinct - Premier - Les N premiers - Les N premiers pourcents - Les N deniers - Les N deniers pourcents OUI

Jaspersoft 3.7 Community OUI

Pentaho 3.5 OUI

OUI

OUI

OUI

OUI OUI OUI OUI OUI

OUI OUI OUI OUI OUI

OUI OUI OUI OUI OUI

Jaspersoft 3.7 Community - Moyenne - Compte - Compte distinct - Somme - Premier - Minimum - Maximum - cart type - Variance - Systme

Pentaho 3.5 - Moyenne - Compte - Compte par page - Compte par groupe - Somme - Minimum - Maximum - Somme - Pourcentage de somme

-6Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

Dfinitions de fonctions / d'expressions Dfinitions d'agrgations Chaque lment OUI peut avoir son propre code, vnement, fonction

- Dernier - Maximum - Mediane - Minimum - Modulo - Pourcentage - Pourcentage de rang - Somme des pourcentage - Quartile - Rang - Compte courant - Cumul - cart type - Somme - Variance - Moyenne pondre OUI OUI Java, JavaScript Java, JavaScript, ou Groovy OUI OUI

- Calcul - Somme par page - Somme - Compte (lors de l'excution) - Compte par groupe (lors de l'excution) - Compte distinct (lors de l'excution) - Moyenne (lors de l'excution) - Minimum (lors de l'excution) - Maximum (lors de l'excution) - Pourcentage du total (lors de l'excution) OUI OpenFormula (Excellike), Java OUI

Seulement le rapport Pas dans le designer lui-mme peut avoir ce type de fonctionnalit

I-B - Installation
Pour utiliser BIRT, il faut installer le logiciel Eclipse (version Helios Release par exemple) avec l'extension de BIRT (lien ici). De plus, il est possible d'ajouter une extension afin de pouvoir faire pivoter du texte (lien ici).

I-C - Fonctionnalits
BIRT (Business Intelligence and Reporting Tools) est un outil de reporting Open Source reposant sur Eclipse. Cette outil est graphique c'est--dire que nous avons une palette permettant de slectionner l'lment que nous voulons placer sur notre rapport (par exemple, un label, une image, un tableau).

Ensuite, nous avons la possibilit de connecter le rapport avec une base de donnes afin de pouvoir afficher le rsultat d'une requte SQL comme nous le souhaitons sur notre feuille de travail. Pour cela, nous devons ajouter une "Data Sources" qui permet de nous connecter une base de donnes. Puis, nous pouvons ajouter une "Data Set" qui, elle, contient la requte SQL. Cette dernire peut gnrer des requtes statiques mais aussi dynamiques en ajoutant des paramtres modifiables lors de l'excution du rapport. De plus, nous pouvons modifier le nom de certaines colonnes du rsultat de la requte, en crant des alias ce qui permet de pouvoir reconnaitre les champs plus facilement lorsque nous voulons les placer sur notre rapport (ceci est indispensable lorsque nous faisons une jointure avec deux tables dont deux champs ont le mme intitul comme 'libelle' ou 'id'). Le "Data Cube" permet de crer un tableau crois ("cross table"). Ceci est pratique lorsque nous voulons faire des statistiques sur une dure par exemple. Cette fonctionnalit possde beaucoup d'avantages, notamment l'affichage de donnes par colonne et le calcul du total automatique pour les statistiques. Comme dit prcdemment, nous pouvons gnrer des requtes dynamiques. Pour cela nous devons crer des variables qui serviront de paramtres au rapport. Ainsi, nous devons utiliser l'option "Report parameters" qui permet de crer ces paramtres et de prciser leurs types (entier, chaine de caractre, boolen) et leurs valeurs par dfaut.
-7Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

Il y a la possibilit d'insrer des graphiques. Sous BIRT, les graphiques sont entirement personnalisables et dpendent d'un data set ou d'un data cube. Nous pouvons l'afficher en 2D, 2D avec profondeur ou 3D. Les lments de la page peuvent tre personnaliss en modifiant les proprits. Parmi ces dernires, il y a la possibilit de changer l'aspect d'un lment (couleur, taille, police, fond) mais aussi de modifier le fonctionnement (ajouter une condition d'affichage, des liens). l'aide de l'onglet " Binding ", nous assignons une requte (" Data Set ") un lment afin de pouvoir utiliser l'un de ses champs pour l'affichage. BIRT permet aussi d'ajouter un haut de page et un bas de page statiques ou dynamiques modifiables avec l'onglet " Master Page ". Ici, nous pouvons insrer des textes automatiques situs dans la palette comme le numro de page ou la date et l'heure. Nous pouvons programmer des fonctions utilisables dans notre rapport en les stockant dans l'onglet "Script". Ces scripts peuvent tre excuts au dmarrage du rapport ou la fermeture du rapport, pour un lment prcis ou pour le rapport en entier. De plus, nous pouvons avoir accs au code source XML.

I-D - Gnration et exportation de rapport Birt


Tout d'abord, nous pouvons gnrer des rapports en temps rel l'aide de l'onglet "Preview". De plus, nous pouvons exporter le rapport sous diffrents formats. Ceci permet l'export sous format doc (document Word), HTML (page Internet), PDF, PPT (document PowerPoint), XLS (document Excel) ou Web viewer (application Web). Chacun d'entre eux ayant une interprtation diffrente, il faut faire attention pouvoir internationaliser nos rapports.

II - Data Source
La Data Source permet de se connecter une base de donnes. Sans cela, le rapport et ses donnes resteront statiques. Il est possible de charger n'importe quel driver SQL (mysql JDBS). Pour se connecter une base de donnes, il suffit de donner l'URL vers celle-ci via le driver. Dans l'exemple ci-dessous, l'URL est note comme jdbc:mysql:// localhost :3306/test o jdbc:mysql voque le type de connexion la base de donnes (ici, une connexion java avec mysql), localhost reprsente l'adresse (ici l'adresse locale), 3306 le port et test indique le nom de la base de donnes. Ensuite il suffit de donner le nom d'utilisateur et le mot de passe. Il est possible avant de valider de tester la connexion via le bouton "Test Connection". Il est possible de se connecter plusieurs Data Source.

III - Data Set


Un Data Set contient une requte SQL. Cette requte peut tre dynamique (avec paramtre) ou statique. Lorsque nous ditons notre requte via la console du Data Set, nous avons accs toutes les tables et champs des Data Source dans la partie Query > Available Items. Ceci permet de faciliter l'criture de nos requtes. Dans l'onglet Output Column, nous pouvons voir l'ensemble des colonnes que la requte renvoie et ainsi, nous pouvons modifier leurs noms en leurs donnant un alias. L'onglet "Computed column", permet d'ajouter des colonnes calculables via d'autres colonnes. Si nous voulons gnrer des requtes dynamiques dpendant de variables passes en paramtre au rapport, il suffit d'ajouter nos paramtres existant dans la partie "Parameters". Ainsi, lors de l'criture de la requte, si nous voulons en utiliser un, il suffit de placer un point d'interrogation sa place et le Data Set ira le chercher automatiquement. Dans le cas o il y a plusieurs paramtres, le Data Set prend les entres dans l'ordre. Par exemple si il y a deux points d'interrogations, le 1er correspond au 1er paramtre et le 2e au 2e paramtre. La console contient un onglet "Filters". Celui-ci donne l'occasion de filtrer nos champs. Par exemple, si nous rcuprons une date, nous pouvons l'encadrer. Ceci revient faire une condition dans le " where " de la requte. La partie "Property Binding" permet d'crire notre requte en utilisant les fonctionnalits du JavaScript. Il est possible de voir un aperu du rsultat avec l'onglet "Preview result".

-8Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

IV - Data Cube
Un Data Cube permet de calculer des statistiques en fonction des champs retourns par un Data Set. Celui-ci peut tre affich seulement avec un tableau crois (CrossTab). Dans la console du Data Cube, nous pouvons slectionner notre data set dans l'onglet "Dataset". Ensuite, lorsque nous allons dans "Group and Summaries", nous devons crer des groupes de donnes qui reprsenterons le haut et la colonne de gauche du tableau crois. Par exemple, si nous voulons afficher une date dans la partie suprieur du tableau, alors nous pouvons crer un groupe " date " contenant, un champ pour l'anne, un autre pour le mois et un autre pour le jour. Ensuite, nous devons afficher une oprations au centre du tableau. C'est la partie " Summary ". Celle-ci se rfre un champ du Data Set et effectue une opration en fonction des groupes crs et affichs dans le tableau crois. La partie " Link Group " affiche notre Data Cube sous forme de modlisation.

V - Report Parameters
Le rapport pouvant tre dynamique, il est donc possible de lui fournir des paramtres. Pour crer un paramtre, il faut lui donner un nom, un type (chaine de caractres, entier, boolen, case cocher) et lui dire s'il est obligatoire ou non. Selon le type du paramtre, nous pouvons lui slectionner des valeurs par dfaut ou mme des valeurs. En effet, si notre paramtre est une liste nous pouvons gnrer cette liste via un Data Set ou l'crire manuellement.

Lors de l'excution du rapport, une fentre s'affiche et demande d'entrer les paramtres. Dans le cas o le paramtre n'est pas obligatoire, alors celui-ci sera affich sous forme de deux boutons radios : le 1er avec la valeur que vous lui passez, le 2e avec la valeur "nulle".

VI - Script
Les scripts servent appliquer des fonctions sur des lments du rapport. Ils sont programms en JavaScript. Il est possible d'excuter des scripts diffrents moments de l'excution (avant l'ouverture, avant l'excution, aprs, pendant).

Lorsque nous voulons dclarer des fonctions utilisables dans le rapport entier, il est judicieux de les placer lors de l'initialisation de la page (clic sur la page, puis sur script, et slection sur " initialize "). Chaque lment peut se servir du script pour diffrentes raison. Par exemple, un Data Set peut modifier sa requte en affectant une chaine de caractres contenant la nouvelle requte la variable queryText. L'avantage de ceci est d'utiliser directement des paramtres du rapport via la syntaxe params['NomDuParametre'].value. De plus, nous pouvons utiliser les fonctionnalits du JavaScript afin par exemple d'ajouter la requte des conditions si certains paramtres sont renseigns, d'allger l'criture de la requte si certains endroit se rptent Les fonctions dclares dans les scripts peuvent tre utilises chaque fois que le symbole " fx " apparait.

VII - La palette de BIRT


Les deux premires lignes reprsentent un mode de slection (par groupe d'lments ou par lment individuel).

-9Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

Les quatre suivants servent afficher du texte : _ Le label affiche du texte statique. _ Le Texte (Text) :

_ Le texte dynamique (dynamic Text) :

_ La donne (Data)

Cet lment est semblable une variable utilisable qu'une seule fois. Elle est en gnral place dans un tableau et reprsente un lment d'un data set ou d'un data cube. Ainsi, chaque nouvelle ligne du rsultat du Data Set, ce texte sera mis jour selon la nouvelle valeur. Il est ainsi possible de modifier l'un des champs pour personnaliser son affichage via le bouton " fx ". Ensuite, nous avons . Il permet tous simplement d'insrer une image. Celle-ci peut tre fixe (une image quelconque uploade) ou dynamique (une image rcupre via un data set ou data cube).

Les cinq derniers reprsentent des containeurs. Ce sont eux qui vont permettre d'afficher le rsultat d'une requte. Ainsi, nous avons : _ une grille : cela permet de placer n'importe quels lments dans une partie du document. Par exemple, si nous voulons placer deux lments l'un ct de l'autre, il suffit de crer une grille deux colonnes ; _ une liste : elle affiche les donnes d'une requte sous forme de groupe de listes. Ainsi, nous pouvons agrandir ou rduire la liste :

_ un tableau : Cela permet d'afficher le rsultat de la requte telle quelle. Il est possible de crer des groupes sur des champs et de modifier l'ordre d'affichage. Un tableau est toujours attach un data set ; _ un graphique (Chart) : les graphiques sont entirement personnalisables sous BIRT. Ils peuvent tre sous n'importe quelle forme (camembert, graphe, diagramme). De plus, nous pouvons choisir de l'afficher en 2D, 2D profondeur ou 3D. Lors de l'ajout de cet lment une fentre s'ouvre. Trois onglets sparent cette dernire. Le premier sert choisir le type du graphique, sa dimension et son format (PNG, JPG, SVG). Le deuxime permet de slectionner les donnes soit d'un data set, soit d'un data cube. Enfin, le troisime permet de personnaliser le graphique. Nous pouvons modifier les couleurs, les libells, la visibilit, l'chelle, la lgende _ un tableau crois (Cross Tab) : il affiche les donnes d'un data cube. Il est souvent utilis pour afficher des statistiques selon deux champs d'un data cube. Il est possible de placer des tableaux dans des tableaux (qu'ils soient imbriqus ou non). Enfin, il est possible d'ajouter une extension et dans ce cas il peut y avoir ses lments :

Le premier permet de remplacer des chiffres par des ronds. Si le chiffre est 2 alors il y aura 2 ronds. Le deuxime permet tous simplement de faire pivoter le texte. Pour finir, il reste les qui sont des lments calculables placer dans un tableau comme un total ou une moyenne.

VIII - Les proprits


Dans l'diteur de proprits, nous pouvons remarquer que nous avons des onglets horizontaux et verticaux. Chaque lment a son propre diteur de proprits. Dans l'exemple ci-dessus, il s'agit de l'diteur d'un tableau. Dans les onglets horizontaux, nous trouvons : _ les proprits gnrales (properties). * Dans la partie gnrale, nous pouvons modifier le nom de l'lment, sa taille (width, height), sa position (verticale et horizontale), son style (feuille de style personnalisable), et le style du texte figurant dans l'lment (sa couleur, sa police, sa taille). * Ensuite, nous avons la partie border qui permet de dfinir les contours des cases du tableau :

- 10 Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

Sur l'image prcdente, nous pouvons observer que nous pouvons modifier les bordures soit en cliquant sur les traits du carr de droite, soit en slectionnant les boutons en bas gauche. * Nous pouvons dfinir des marges afin d'arer notre rapport.

* La partie page break permet de dfinir le moment o nous voulons que notre rapport change de page automatiquement :

Ainsi, nous pouvons sauter de page avant, pendant ou aprs l'affichage de l'lment. * Il est possible de masquer des lments sous certaines conditions lorsque le rapport est affich dans un format spcifique. Ceci est assez pratique si vous voulez masquer l'affichage d'un paramtre non obligatoire qui n'a pas t renseign :

ou masquer pour un format particulier non support par le rapport :

* Il y a encore plusieurs proprits pouvant tre modifies mais nous allons les passer et arriver directement la dernire qui est nomme 'Advanced'. Celle-ci permet de modifier l'ensemble du style de l'lment. C'est un tableau de style modifiable la vole :

_ Aprs les proprits gnrales, nous trouvons les Binding :

Les bindings reprsentent des donnes ainsi que des lments calculables (agrgations) pouvant tre affichs dans l'lment courant. Un lment grant les bindings ne peut slectionner qu'un seul Data Set ou un seul lment (donnes d'un lment). _ Il est possible de faire des groupements de donnes. Ceci est pratique lorsque nous voulons grouper des lments d'un tableau :

_ Le mapping consiste remplacer une donne lors d'une certaine condition par une autre donne. Ceci est pratique lorsque nous voulons remplacer toutes les donnes gales 0 par une chaine de caractres comme "donne indisponible" par exemple.

_ Le highlight consiste donner un style particulier un champ sous certaines conditions. Ceci est pratique dans la mesure ou nous pouvons personnaliser le style selon la donne. Par exemple, nous voulons griser le fond d'une ligne sur deux d'un tableau :

_ La partie sorting permet de trier un ensemble de lignes d'un composant listant des donnes :

_ Les filtres permettent des crer des jointures entre les lments de deux composants ou de filtrer les donnes de l'lment selon certaines conditions :

- 11 Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/)

IX - Master Page
Le master page permet de dfinir le haut de page et le bas de page du rapport. Il est possible d'y insrer toutes formes de donne. De plus, nous avons accs des donnes spcifiques cette partie comme le numro de page, la date d'impression, Ce sont des textes automatiques :

Le master page possde quelques proprits dj vues prcdemment, mais elle possde aussi la proprit suivante qui consiste pouvoir afficher le header avant ou aprs le footer :

X - XML Source
Le rapport BIRT peut tre converti en fichier XML. Ainsi, nous pouvons modifier directement le rapport via le XML. Les parties importantes du fichier XML sont : _ la dfinition du rapport ainsi que sa version :
<report xmlns=http://www.eclipse.org/birt/2005/design version="3.2.22" id="1">

_ la dfinition des mthodes dans le script dfinit entre les balises :


<method name="initialize"><![CDATA[ code ]]\></method>

_ les paramtres du rapport entre les balises "parameters" avec la syntaxe et les proprits suivantes :
<parameters> <scalar-parameter name="nom_du_parametre" id="2233"> <property name="valueType">static</property> <property name="isRequired">true</property> <property name="dataType">string</property> <property name="distinct">true</property> <simple-property-list name="defaultValue"> <value type="constant">valeur_par_defaut</value> </simple-property-list> <property name="paramType">simple</property> <property name="concealValue">false</property> <property name="controlType">text-box</property> <property name="autoSuggestThreshold">1</property> <structure name="format"> <property name="category">Unformatted</property> </structure> </scalar-parameter> </parameters>

_ la dfinition des Data Source comme suit :


<data-sources> <oda-data-source extensionID="org.eclipse.birt.report.data.oda.jdbc" name="Data Source" id="7"> <list-property name="privateDriverProperties"> <ex-property> <name>contentBidiFormatStr</name> <value>ILYNN</value> - 12 Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/) </ex-property> <ex-property> <name>metadataBidiFormatStr</name> <value>ILYNN</value> </ex-property> </list-property> <property name="odaDriverClass"> com.mysql.jdbc.Driver </property> <property name="odaURL"> jdbc:mysql://localhost:3306/developpez </property> <property name="odaUser"> Utilisateur </property> <encrypted-property name="odaPassword" encryptionID="base64"> Mot de passe crypt en base 64 </encrypted-property> </oda-data-source> </data-sources>

Remarquons que nous renseignons le driver, l'URL de la base de donnes, l'utilisateur et le mot de passe crypts en base 64. _ Ensuite, nous avons la dfinition des Data Set dans la balise :
<data-sets>

Chaque Data Set est dfini dans une balise :


<oda-dataset extensionID="org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" name="Data Set" id="2303">

Puis suit la liste des paramtres dans la balise :


<list-property name="parameters">

Chaque paramtre est dfini via la syntaxe suivante :


<structure>

<property <property <property <property <property <property </structure>

name="name">nom_parametre</property> name="paramName">nom</property> name="dataType">string</property> name="position">1</property> name="isInput">true</property> name="isOutput">false</property>

Puis la requte est crite dans les balises :


<xml-property name="queryText"><![CDATA[ Requete ]]\></xml-property>

_ Puis, nous avons la dfinition des styles entre les balises 'style' _ Pour terminer le header, nous dfinissons le master page entre les balises :
<page-setup> <simple-master-page name="Simple MasterPage" id="2"> <page-header>definition</page-header> <page-footer>definition</page-footer> - 13 Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/

Utilisation de BIRT par Silvera David (http://dsilvera.developpez.com/) </simple-master-page> </page-setup>

_ Enfin, nous avons dans la balise "body" le dtail de chaque lment du rapport.

XI - Conclusion
Ce tutoriel est termin. Vous avez pu analyser tout les lments que BIRT vous propose. Vous tes maintenant mme d raliser vos rapports. Merci d'avoir suivi ce tutoriel et bientot!

XII - Remerciement
Je tiens remercier ovh pour ses nombreuses ides ainsi que jacques_jean pour la relecture orthographique.

- 14 Copyright 2011 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://dsilvera.developpez.com/tutoriels/Business-Intelligence/utilisation-birt/