DataWarehouse et Outils Dcisionnels

Outil de Reporting - BIRT

NF 26

Sujet

Vous allez dans un premier temps vous familiariser avec loutil de reporting BIRT laide du Tutoriel en
ligne. Dans une deuxime phase, vous allez crer un ou deux rapports qui rsument une analyse des ventes selon
quelques critres judicieusement choisis.

Tutoriel

2.1

Ouvrir BIRT

Lancez la version dEclipse qui contient lenvironnement BIRT partir dun terminal en tapant la commande
> birt &
Une fois la session BIRT sous Eclipse dmarre, choisissez dans le menu Window la commande Open Perspective et la sous-commande Report Design. Si Report Design napparat pas, choisissez Other . . . puis Report
Design dans la liste des items.
Vous pourrez visualiser vos tables et des versions intermdiaires ou dfinitives des rapports au fur et mesure
de leur dveloppement dans un navigateur. Pour cela, vous devez configurer votre environnement de faon
choisir le navigateur disponible. Dans le cas de votre installation cest Firefox. Pour ce faire, dans le menu
Window, sous menu Preferences, dployez Gnral, puis choisissez Web browser, cochez Firefox, puis validez.

2.2
2.2.1

2.2.2

2.2.3

Cration dun rapport

Cration dun projet
Choisissez File New Project.
Ouvrez le dossier Business Intelligence and Reporting Tools et choisissez Report Project.
Cliquez Next.
Dans la fentre Project name donnez un nom de projet (exemple MonProjet).
Cliquez Finish.
Cliquez OK si ncessaire pour basculer dans lenvironnement Report Design (ce qui se produit dans le cas
o lon cre un projet BIRT dans un environnement diffrent de Report Design).
Cration du rapport
Choisissez File New Report.
Dans la hirarchie de rpertoires choisissez le projet que vous venez de crer : MonProjet.
Dans le champ de texte File name entrez : Customers.rptdesign.
Cliquez Next.
Choix du format de tableau

Une liste de formats de tableaux par dfaut (Templates) vous est propose :
My First Report vous dirige vers un tutoriel en ligne.
Blank Report cre un rapport vide sans contenu pr-dfini.
Simple Listing cre un tableau sans regroupement.
Grouped Listing cre un tableau avec regroupement tel que les valeurs rptes napparaissent quune
seule fois. Il est aussi possible de crer des sous-totaux.
Dual Column Listing cre un tableau deux colonnes cte cte.
Chart & Listing cre un tableau avec un histogramme en dbut de rapport.

 Dual Column Chart & Listing combine les histogrammes et les tables de faon pouvoir prsenter deux
jeux de donnes dans un seul rapport.
Side by Side Chart & Listing cre un rapport dans lequel lhistogramme et le tableau de chaque groupe
sont cte cte.
Slectionnez Grouped Listing.
Cliquez sur Finish.
BIRT ouvre un nouveau rapport dans le workspace dEclipse.

2.3

Prsentation de linterface utilisateur

Lenvironnement BIRT sous Eclipse propose un certain nombre de fentres contenant des outils pour la
ralisation des rapports.
Pour avoir une prsentation exhaustive de linterface reportez-vous dans le tutoriel disponible ladresse :
http://www.eclipse.org/birt/phoenix/tutorial/
Voici ci-dessous un rsum de lenvironnement.
2.3.1

Feuilles de rfrences (Cheat Sheets)

Fentre de droite contient des notes pour vous guider dans la procdure de construction de rapports.
2.3.2

Editeur de mise en forme (Layout editor)

Fentre centrale de cration du rapport. Elle contient cinq onglets : Layout, Preview, Script, XML Source,
Master Page.
2.3.3

Vues (Views)

Sur les cts et en bas on trouve diffrentes vues pour naviguer dans lditeur : Palette (contient les items
insrer dans le rapport par glisser-dposer) ; Outline (structure du rapport) ; Navigator (projets et rapports) ;
Data explorer (sources de donnes via des connections, jeu de donnes via des requtes et paramtres du rapport) ;
Property Editor (vue qui montre les proprits des items du rapport et contient des onglets pour organiser ces
proprits en catgories) ; Properties (vue standard Eclipse) ; Library Explorer View (pour la rutilisation dobjets
de rapports).
2.3.4

Affichage des vues

On peut cacher les vues en cliquant sur le "X" de chacune et les faire apparatre dans le menu
Window Show View.

2.4

2.5
2.5.1

Construction dune source de donnes

Allez dans la vue Data Explorer.
Slectionnez le nud Data Sources dans larbre.
Faites un click droit pour ouvrir le menu contextuel, choisissez New Data Source.
Choisissez Classic Models Inc. Sample Database.
entrez "Sample" dans le champ Data Source Name.
Cliquez Next.
Cliquez Finish.

Construction dun jeu de donnes

Construire le jeu de donnes
Allez dans la vue Data Explorer.
Slectionnez le nud Data Sets dans larbre.
Faites un click droit pour ouvrir le menu contextuel.
Slectionnez New Data Set. Une boite de dialogue New Data Set souvre.
Entrez "Customers" comme champ de Data Set Name.
Vrifiez que le champ Data Source contient Sample.
Vrifiez que le champ Data Set Type contient "SQL Select Query".
Cliquez Next.

 Entrez la requte suivante :

SELECT *
FROM CUSTOMERS
WHERE COUNTRY = USA
Cliquez Finish.
2.5.2

Editeur de jeu de donnes

Lditeur de jeu de donnes est maintenant ouvert. Il contient sur la gauche une sous-fentre qui permet
dappeler les fonctions suivantes :
Query : dition des requtes.
Data Source : Donne le nom des sources de donnes. On peut le modifier.
Preview Results : Permet de tester une requte et voir le rsultat.
Computed Columns : Rsultats calculs par BIRT (ventuellement via des instructions Java).
Parameters : pour le paramtrage des requtes SQL.
Filters : Filtres BIRT supplmentaires aux clauses WHERE.
Output Columns : pour dfinir des alias aux colonnes du rapport.
Navigation dans la base de donnes
Dans la sous-fentre de gauche choisissez Query :
Dployez la source de donnes Sample pour voir les schmas dans la base de donnes.
Dployez "CLASSICMODELS" pour voir la liste des tables de la base de donnes.
Dployez une table pour voir la liste de ses colonnes.
Cet diteur permet de manipuler le "glisser-dposer".
Test des requtes
Dans la sous-fentre de gauche cliquez sur "Preview Results". La page de prvisualisation apparat. Elle
montre les colonnes slectionnes dans la requte liste au dessus. Le nombre de lignes effectivement slectionnes
apparait en bas de la page.
Vrifiez que la liste des customers apparat.
Cliquez OK pour fermer lditeur de jeu de donnes.
2.5.3

Editer le jeu de donnes

Pour changer de jeu de donnes, double cliquer sur Customers dans le nud Data Sets du Data Explorer.

2.6
2.6.1

Construire une table

Les items (lments) dun rapport

On trouve les diffrents items qui vont constituer la Table dun rapport dans la palette. Cliquez sur longlet
Palette :
Label : texte qui sert dentte aux lignes et aux colonnes.
Text : texte libre pour les titres du rapport.
Dynamic Text : affiche une colonne de la base qui contient des donnes au format HTML.
Image : pour linsertion dimage dans le rapport.
Grid : Formatage de tableau pour les items du rapport.
List : pour afficher des donnes plus complexes quune simple ligne dune table.
Table : pour afficher des donnes qui proviennent dune table.
Chart : pour insrer des graphes, des histogrammes, . . .
Nous nutiliserons que quelques uns de ces item dans ce tutoriel.
2.6.2

Cration de la table

Nous allons insrer du contenu dans le tableau cr initialement.

Dans le Data Explorer, dployez le nud Data Sets, puis dployez le nud Customers pour afficher les
colonnes disponibles du jeu de donnes.
slectionnez la colonne CUSTOMERNAME.
Reprez dans la Table le label "Detail Row" qui apparat en gris.
Glissez-Dposez la colonne CUSTOMERNAME sur la deuxime cellule partir de la gauche de la ligne
"Detail Row". Cette opration ajoute un Data Element et un Label Elements la Table.
Glissez-Dposez la colonne PHONE dans la cellule Detail Row droite de la colonne Custumer Name.

2.6.3

Cration de groupements

On veut regrouper les clients par tat, puis par ville. Le groupement permet de faire apparatre ensemble
toutes les lignes qui correspondent au mme tat.
Reprez dans la table le label "Group Header Row" qui apparat en gris.
Glissez-Dposez la colonne STATE sur la cellule la plus gauche de la ligne "Group Header Row".
Nous allons maintenant regrouper les villes dans les tats.
Placez le curseur sur la Table et une petite icne Table va apparatre (en bas gauche).
Cliquez sur licne pour faire apparatre les icnes de lignes et de colonnes sur la Table.
Dans Property Editor slectionnez longlet Binding. Vous devez constater que la Table est lie au jeu de
donnes Customers. Sous la colonne Data Column Binding vous devez voir les trois colonnes de Table que
vous avez cres.
Slectionnez Add (situ tout droite dans la fentre), pour faire apparatre la boite de dialogue de Data
Binding
Entrez City dans le champ Display Name et slectionnez le signe fx ct de Expression. Le Expression
Builder de BIRT saffiche.
Slectionnez Available Data Sets dans Category, Customers dans Sub-Category, puis double-cliquez sur la
colonne CITY.
Slectionnez OK puis changez le nom de Column Binding Name de Column Binding en CITY, puis cliquez
sur OK. La colonne CITY est maintenant disponible lutilisation dans la Table.
Faites un click droit sur lentte du state group pour faire apparatre le menu contextuel.
Dans ce menu choisissez Insert Group Below. La boite de dialogue Group Details souvre.
Choisissez la colonne CITY dans le champ Group On et entrez City dans le champ Name.
Cliquez sur OK.
Vous pouvez noter que BIRT a insr automatiquement un lment Data dans le groupe city.
2.6.4

Ajout dune colonne Table

On doit ajouter une colonne pour faire apparatre les enttes de groupes.
Vrifiez que les icnes de table sont apparents. Faites un click droit sur lentte ombre de la premire
colonne.
Choisissez Insert Column to the Right dans le menu contextuel.
Dplacez le Data Element CITY (llment de la premire colonne et du second entte de groupe) dans la
seconde colonne du second entte de groupe par glisser-dposer.
2.6.5

Ajout dune entte de colonne

Nous allons amliorer les noms dentte de colonne qui ont t insrs automatiquement par BIRT.
Double cliquez sur le texte de lentte de la premire colonne pour le modifier, tapez "State", puis retour
chariot (Enter).
Dposez un label de la palette dans lentte de la seconde colonne, tapez "City", puis retour chariot (Enter).
Modifiez lentte de la troisime colonne en "Name".
Modifiez lentte de la troisime colonne en "Phone".

2.7

Tester le rapport

Pour pr-visualiser le rapport, cliquez sur longlet Preview dans le coin en bas gauche de lditeur de
rapport.
Une version HTML, sur une page, du rapport apparat dans le navigateur inclus dans BIRT.
Vous pouvez maintenant modifier lapparence du rapport en ajoutant un titre, mettre de la couleur dans les
enttes de colonne, sortir les clients en ordre alphabtique, ajouter des histogrammes, . . .
Vous pouvez galement pr-visualiser le rapport au format PDF en choisissant le menu :
Run View Report As PDF.
Enfin, vous tes invit consulter le tutoriel en ligne pour utiliser les nombreuses amliorations de prsentation, de style et de constitution dun rapport ladresse :
http://www.eclipse.org/birt/phoenix/tutorial/

Travail raliser

Vous devez raliser deux types de rapport synthtique que la direction de la chane de magasins souhaiterait
avoir rgulirement. Le premier est un rapport sur le modle Grouped Listing utilis ci-dessus (voir paragraphe
3.2), le second sera un cube dont un exemple de construction vous est donne au paragraphe 3.3

3.1

Ouvrir une connexion vers votre base Oracle

Crez un nouveau projet en suivant la mme procdure que celle dcrite dans la section 2.2.
3.1.1

Cration de la source

Allez dans la vue Data Explorer.

Slectionnez le nud Data Sources dans larbre.
Faites un click droit pour ouvrir le menu contextuel.
Choisissez New Data Source
Choisissez JDBC Data Source Connection for Query Builder.
entrez "UnNomDeBaseAppropri" dans le champ Data Source Name.
Cliquez Next.
La fentre de dialogue de dfinition de la connexion New Connection Profile souvre
3.1.2

Ouverture de la connexion

Dans cette fentre choisissez Oracle, puis Next

A droite du champ Oracle Thin Driver, cliquez sur licne New Driver Definition
Choisissez la ligne Oracle Thin Driver Oracle 11, puis cliquez sur longlet JAR List et effectuez les oprations
suivantes afin de slectionner le driver appropri :
1. Slctionnez ojdbc14.jar et cliquez sur Remove JAR/Zip
2. Cliquez sur Add JAR/Zip
3. Dans le Frame de gauche, slectionnez Systme de fichiers, puis dans le Frame de droite local2, puis
data-integration, puis libext, puis JDBC, puis ojdbc6_g.jar, puis cliquez sur Ok
Dans la fentre New Connection Profile, remplissez les champs suivants :
1. SID : nf26
2. Host : sme-oracle.sme.utc
3. Port Number : 1521
4. User Name : votre login
5. Password : votre mot de passe
6. NOTE : Le champ Connection URL est rempli automatiquement
7. Cliquez sur test Connection, puis Finish si le test a t russi
3.1.3

Cration du jeu de donnes

Allez dans la vue Data Explorer.

Slectionnez le nud Data Sets dans larbre.
Faites un click droit pour ouvrir le menu contextuel.
Slectionnez New Data Set. Une boite de dialogue New Data Set souvre.
Entrez "UnNomAppropri" comme champ de Data Set Name.
Vrifiez que le champ Data Source contient LeNomdeDataSourceDfiniEn3.1.1.
Vrifiez que le champ Data Set Type contient "SQL Select Query" et cliquez sur next.
Entrez un script de requte SQL appropri soit directement dans la partie haute de la fentre, soit en vous
aidant du menu contextuel qui souvre par un clic droit dans la partie du milieu de la fentre.
Cliquez Ok.

3.2

Cration de rapport simple

Ralisez au moins un rapport synthtique de lactivit et de la performance des magasins sur le modle
Grouped Listing auquel vous ajouterez des lments graphiques.

3.3

Cration de cube

Crez un nouveau Data Set. Dans la fentre Query Builder entrez trois tables qui permettront de croiser
deux dimensions avec la table des Ventes. Par exemple, choisissez les dimensions Magasins et Dates. Dans
cette fentre, crez les liens appropris entre ces trois tables et slectionnez les champs sur lesquels vous voulez
construire un cube. Cliquez sur finish quand vous avez termin.
Toujours dans la vue Data Explorer, faites un click droit sur le nud Data Cubes pour ouvrir le menu
contextuel et slectionnez New Data Cube. Dans Primary dataset slectionnez le nom du Data Set que vous avez
dfini ci-dessus. Dans la partie gauche de la fentre slectionnez Groups and Summaries, puis crez les dimensions
(ventuellement hirarchises) Lieux et Temps par glisser-dposer des champs sur lesquelles vous voulez travailler.
Faites un glisser-dposer des Quantits dans le premier champ de Summaries.
Dans la fentre Layout, faire un click droit et choisissez Insert Cross Table, puis glissez-dposez les champs
appropris dans les lignes et les colonnes correspondantes.
A partir de cet exemple, construisez un autre cube avec au moins une hirarchie dans lune des deux
dimensions, crez un rapport synthtique que vous complterez par des lments graphiques.