birt guide

IBM Tivoli Change and Configuration Management Database 7.1.1 IBM Maximo Asset Management 7.1 IBM Tivoli Service Request Manager 7.1 IBM Tivoli Asset Management for IT 7.1

Guide de dveloppement des rapports

ImportantAvant d'utiliser les prsentes informations et le produit associ, prenez connaissance des informations figurant la section Remarques la page 47.

LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis jour priodiquement. Chaque nouvelle dition inclut les mises jour. Les informations qui y sont fournies sont susceptibles d'tre modifies avant que les produits dcrits ne deviennent eux-mmes disponibles. En outre, il peut contenir des informations ou des rfrences concernant certains produits, logiciels ou services non annoncs dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncs. Pour plus de dtails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, rfrez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous votre partenaire commercial. Vous pouvez galement consulter les serveurs Internet suivants : http://www.fr.ibm.com (serveur IBM en France) http://www.can.ibm.com (serveur IBM au Canada) http://www.ibm.com (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualit Tour Descartes 92066 Paris-La Dfense Cedex 50 La prsente dition s'applique la version 7.1.0 d'IBM Maximo Asset Management, d'IBM Tivoli Asset Management for IT et d'IBM Tivoli Service Request Manager et la version 7.1.1 d'IBM Tivoli Change and Configuration Management Database, ainsi qu' toutes les ditions et modifications ultrieures, sauf indication contraire dans les nouvelles ditions. Copyright International Business Machines Corporation 2008. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Table des matires

A propos de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Chapitre 1 : Chargement et configuration de BIRT Report Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outil de gnration de rapports BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dfinition des composants BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIRT Report Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation de BIRT Report Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIRT Report Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation de BIRT Report Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fichiers BIRT Report Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fichiers source de BIRT Report Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure des fichiers de BIRT Report Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dossier des bibliothques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dossier des rapports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dossier Scriptlibrary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dossier des modles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dossier des outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration systme des fichiers de la phase de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prrequis de l'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation des fichiers de la phase de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration de BIRT Report Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1 2 2 2 2 2 3 3 3 4 4 4 4 5 5 5 7

Chapitre 2 : Cration d'un rapport BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Prparation de la cration d'un premier rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Comprendre les modles de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Cration d'un rapport BIRT regroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Chapitre 3 : Fonctions de gnration de rapports BIRT avances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vrification des types de base de donnes, des informations SQL et de la fonctionnalit de mise jour . . . . Mappage des types de donnes BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remarques sur la conception SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Formatage des dates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Test de la valeur Null. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fonctions scalaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SQL conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ajout de la fonctionnalit de mise jour de la base de donnes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Excution de requtes supplmentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requtes dans la mthode d'extraction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requtes dans la mthode d'ouverture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Association des ensembles de rsultats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mise en forme du rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cration d'un lien hypertexte d'un rapport vers un autre. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dbogage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enregistrement d'un rapport avec l'accs la barre d'outils de l'application. . . . . . . . . . . . . . . . . . . . . . . . . . . . Enregistrement d'un rapport pour plusieurs applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 17 18 19 19 19 20 20 20 21 22 22 23 24 24 25 26 28

Chapitre 4 : Configuration de rapports localiss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Localisation des libells de rapport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Activation des libells de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Copyright IBM Corp. 2007, 2008

iii

Importation de libells de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Localisation des donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exemples de donnes de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mise en forme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 5 : Utilisation des paramtres de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Types de rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres Active/Slectionne/Tout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rapports bass sur des paramtres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres lis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres non lis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Active/Slectionne/Tout et Bass sur des paramtres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres lis et non lis dans les instructions SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres lis dans les instructions SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paramtres non lis dans les instructions SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ajout de paramtres non lis au SQL d'un rapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilisation de valeurs boolennes comme paramtres. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 6 : Importation et exportation de fichiers de conception. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cration du fichier d'importation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importation de fichiers de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importation de fichiers de conception. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exportation de fichiers de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30 30 31 31 33 33 33 33 34 34 34 34 34 35 35 37 39 39 40 41 42

Annexe A : Description des fichiers de proprits systme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Annexe B : Description des fichiers de tche Cron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Remarques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

iv


Avis aux lecteurs canadiensLe prsent document a t traduit en France. Voici les principales diffrences et particularits dont vous devez tenir compte. Illustrations Les illustrations sont fournies titre dexemple. Certaines peuvent contenir des donnes propres la France. Terminologie La terminologie des titres IBM peut diffrer dun pays lautre. Reportez-vous au tableau ci-dessous, au besoin. IBM France ingnieur commercial agence commerciale ingnieur technico-commercial inspecteur IBM Canada reprsentant succursale informaticien technicien du matriel

Claviers Les lettres sont disposes diffremment : le clavier franais est de type AZERTY, et le clavier franais-canadien de type QWERTY. OS/2 et Windows - Paramtres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (franais-canadien), le code pays 002, le code clavier CF.

Copyright IBM Corp. 2008

v

Nomenclature Les touches prsentes dans le tableau dquivalence suivant sont libelles diffremment selon quil sagit du clavier de la France, du clavier du Canada ou du clavier des tats-Unis. Reportez-vous ce tableau pour faire correspondre les touches franaises figurant dans le prsent document aux touches de votre clavier.

Brevets Il est possible quIBM dtienne des brevets ou quelle ait dpos des demandes de brevets portant sur certains sujets abords dans ce document. Le fait quIBM vous fournisse le prsent document ne signifie pas quelle vous accorde un permis dutilisation de ces brevets. Vous pouvez envoyer, par crit, vos demandes de renseignements relatives aux permis dutilisation au directeur gnral des relations commerciales dIBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance tlphonique Si vous avez besoin dassistance ou si vous voulez commander du matriel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.

vi


A propos de ce documentLe prsent document dcrit les tches de configuration, de cration et de conception du dveloppeur de rapports. Il prsente galement les fonctions de gnration de rapports avances.

Public visLe prsent guide est destin aux dveloppeurs de rapports qui doivent effectuer les tches suivantes : cration d'un rapport BIRT importation et exportation de fichiers de conception de rapports chargement et configuration de BIRT Report Designer configuration de rapports localiss utilisation de fonctions de gnration de rapports BIRT avances utilisation de paramtres de rapport

Copyright IBM Corp. 2007, 2008

vii

Public vis

viii


Chargement et configuration de BIRT Report Designery

1

Le prsent document est destin aux programmeurs Java possdant une connaissance pratique de BIRT (Business Intelligence and Reporting Tools) Report Designer et de l'environnement Eclipse. Eclipse est une communaut de code source libre dont les projets visent laborer une plateforme de dveloppement libre. Ce chapitre contient les sections suivantes : Outil de gnration de rapports BIRT Fichiers BIRT Report Designer Fichiers source de BIRT Report Designer Structure des fichiers de BIRT Report Designer Configuration systme des fichiers de la phase de conception Configuration de BIRT Report Designer

Outil de gnration de rapports BIRTIBM utilise BIRT comme outil de gnration de rapports. BIRT est un systme de gnration de rapports source ouverte reposant sur la technologie Eclipse pour les applications Web. Cette section dfinit les composants de BIRT.

Dfinition des composants BIRTIBM Corporation intgre les composants BIRT suivants : BIRT Report Engine BIRT Report Designer


1

Fichiers BIRT Report Designer

BIRT Report EngineBIRT Report Engine est un outil Eclipse permettant d'afficher des rapports. BIRT Report Engine gnre un rapport au format HTML, CSV ou PDF pour que vous puissiez l'afficher dans votre navigateur.

Installation de BIRT Report EngineBIRT Report Engine est imbriqu dans votre systme. Lorsque vous avez install votre application, vous avez galement install BIRT Report Engine.

BIRT Report DesignerUtilisation de BIRT Report Designer pour le dveloppement de rapports. L'outil de conception est une interface Eclipse permettant de crer des rapports qui s'intgrent dans des applications Web.

Installation de BIRT Report DesignerPour des informations sur l'installation de BIRT Report Designer, accdez IBM developerWorks. IMPORTANT Si vous ne disposez pas de JDK 1.5 (5.0), vous devez l'installer.

Fichiers BIRT Report DesignerLes fichiers BIRT Report Design sont des fichiers xml, possdant l'extension .rptdesign. Les rapports BIRT peuvent contenir un ou plusieurs fichiers. Ces fichiers sont classs comme des fichiers de bibliothque ou des fichiers de ressources. Les fichiers de bibliothque BIRT sont galement des fichiers xml et possdent l'extension .rptlibrary. Les fichiers de bibliothque BIRT contiennent du code utilis plusieurs fois pour des lments tels que le type de police, la taille, les numros de page et l'horodatage. Chaque fichier peut tre rutilis plusieurs fois dans les conceptions et les modles de rapport BIRT. Les fichiers de ressources contiennent des lments tels que des images ou des fichiers externes. Les fichiers de ressources peuvent tre utiliss par les fichiers de conception de rapport ou les fichiers de bibliothque. Les fichiers de proprits sont galement des fichiers de ressources. De nombreuses conceptions de rapport diffrentes utilisent le mme fichier de proprits. Le fichier xml du rapport BIRT dtaille les fichiers de bibliothque et les fichiers de ressources requis par le rapport. Sans ces fichiers, le rapport BIRT n'est pas excut.

2


Fichiers source de BIRT Report Designer

Fichiers source de BIRT Report DesignerIBM vous offre plusieurs rapports pour que vous puissiez analyser des incidents spcifiques, afficher des donnes selon une mthode non disponible dans une application spcifique ou imprimer les rsultats des enregistrements pour conserver une trace des actions ou des enregistrements. IMPORTANT Pour une liste complte des rapports prts l'emploi fournis par IBM avec ce produit, reportez-vous au centre de documentation. En outre, vous pouvez personnaliser les rapports offerts par IBM pour ajouter ou supprimer un champ, ajouter le logo de votre socit ou modifier le tri. Vous pouvez galement crer vos propres rapports personnaliss pour rpondre aux besoins spcifiques de votre entreprise. Par consquent, IBM inclut les fichiers de conception de rapport pour que vous puissiez les personnaliser ou en consulter le contenu titre d'exemples pour la cration de vos propres rapports.

Structure des fichiers de BIRT Report DesignerLa structure des fichiers BIRT Report Designer contient les sous-rpertoires suivants : bibliothques rapports scriptlibrary modles outils Les sections ci-aprs dcrivent ces sous-dossiers en dtail.

Dossier des bibliothquesLe dossier des bibliothques contient tous les fichiers de proprits de l'application. Le fichier de proprits contient les titres et les libells des rapports. Ce fichier est requis pour importer un rapport et pour la localisation. Le dossier des bibliothques contient galement les fichiers de bibliothque systme suivants : libraries.xml MaximoSystemLibrary.rptlibrary IMPORTANT Ne modifiez pas les deux fichiers de bibliothque systme dans le dossier des bibliothques. Si vous modifiez ces fichiers, vous risquez d'altrer vos rapports.

Chargement et configuration de BIRT Report Designer

3

Fichiers source de BIRT Report Designer

Dossier des rapportsChaque application de votre systme correspond un dossier de votre sous-dossier de rapports. Votre licence contrle quelles applications vous pouvez visualiser. La structure des fichiers de conception de rapport de BIRT contient le chemin suivant :\reports\birt\reports\Prfrences. b Dveloppez le dossier Conception de rapport et slectionnez le modleCommentaire.

c Dslectionnez l'option spcifiant de gnrer un commentaire lors de lacration d'une conception de rapport.

Chargement et configuration de BIRT Report Designer

7

Configuration de BIRT Report Designer

5 Importez le projet de rapport. a Slectionnez Fichier>Importer b Dveloppez le dossier gnral et slectionnez les projets existants dansEspace de travail.

c Cliquez sur Suivant. d Accdez l'emplacement des fichiers de rapport :\reports\birt\reports

e Slectionnez le projet YourReports. Cliquez sur Terminer. 6 Importez le projet de bibliothque. Cette tape est facultative et ne s'appliqueque si vous modifiez les bibliothques.

a Slectionnez Fichier>Importer b Dveloppez le dossier gnral et slectionnez les projets existants dansEspace de travail. Cliquez sur Suivant.

c Accdez l'emplacement de la bibliothque de rapports partir del'tape 2.

d Slectionnez le projet YourReportLibraries. Cliquez sur Terminer. 7 Importez le projet du script du rapport. Cette tape est facultative et nes'applique que si vous gnrez les classes du script du rapport.

a Extrayez tous les fichiers source dans l'emplacement suivant :\applications\maximo\maximouiweb\webmodule\ WEB-INF\birt

b Slectionnez Fichier>Importer. c Dveloppez le dossier gnral et slectionnez les projets existants dansEspace de travail, puis cliquez sur Suivant.

d Accdez l'emplacement suivant :\applications\maximo\maximouiweb\webmodule\ WEB-INF\birt\script

e Slectionnez le projet YourReportScriptLibrary. Cliquez sur Terminer.

8


Cration d'un rapport BIRT

2

Ce chapitre dcrit comment crer votre premier rapport BIRT l'aide de BIRT Report Designer. Ce chapitre contient les sections suivantes : Prparation de la cration d'un premier rapport Comprendre les modles de rapport Cration d'un rapport BIRT regroup

Prparation de la cration d'un premier rapportAvant de crer un rapport dans BIRT Report Designer, IBM recommande de dvelopper et de tester toutes les requtes requises dans un outil d'interrogation de base de donnes. BIRT ne valide pas le code SQL et un outil d'interrogation peut gnrer des messages d'erreur plus clairs. En outre, vous devez connatre les types de donnes de tous les champs de votre rapport. Dterminez les types de donnes (maxtypes) des champs utiliss dans vos requtes l'aide de l'une des mthodes suivantes : interrogez directement l'attribut maxattribute, comme indiqu dans l'instruction SQL suivante :select attributename, maxtype from maxattribute where objectname = 'WORKORDER' order by attributename

ouvrez l'application Configuration de base de donnes et utilisez le champ Type de l'onglet Attributs de votre objet slectionn.

Comprendre les modles de rapportIBM a dvelopp un certain nombre de modles de rapport pour vous aider crer des rapports. Pour afficher ces modles, partir de BIRT Report Designer, slectionnez Fichier>Nouveau>Rapport ou choisissez Nouveau rapport dans la liste droulante. De nombreux modles sont affichs, mais vous ne devez slectionner que ceux qu'IBM cre et active spcifiquement pour vous. Ces modles sont identifis par les termes Tivoli Maximo. Ces modles contiennent le code ncessaire pour l'intgration et permettent dobtenir une prsentation cohrente des rapports.


9

Cration d'un rapport BIRT regroup

Le tableau suivant dcrit ces modles : Nom Modle de sous-rapport Tivoli Maximo Description Ce modle cre un rapport avec un ou plusieurs sous-rapports. Chaque sous-rapport peut comporter des champs de donnes diffrents. Ce modle cre un rapport avec un ou plusieurs groupes. Chaque groupe possde des champs de donnes identiques. Ce modle cre un rapport avec un seul en-tte. Ce rapport contient gnralement plusieurs lignes, suivant la quantit de donnes disponibles.

Modle de rapport regroup Tivoli Maximo Modle de rapport Liste Tivoli Maximo

Les modles ci-aprs incluent des lments graphiques, en plus des formats de gnration de rapports standard. Chaque modle inclut trois types de diagramme (un diagramme secteurs, un diagramme de Gantt et un diagramme courbe). Slectionnez un type de diagramme pour votre rapport et supprimez les deux autres. Modle de diagramme de sous-rapport Tivoli Maximo Modle de rapport de diagramme regroup Tivoli Maximo Modle de rapport de diagramme Liste Tivoli Maximo Ce modle cre un rapport avec un ou plusieurs sous-rapports. Chaque sous-rapport peut comporter des champs de donnes diffrents. Ce modle cre un rapport avec un ou plusieurs groupes. Chaque groupe possde des champs de donnes identiques. Ce modle cre un rapport avec un seul en-tte. L'en-tte contient plusieurs lignes de donnes.

Cration d'un rapport BIRT regroupCette section dcrit comment crer un rapport BIRT regroup. Le rapport utilis par cet exemple est le rapport Configuration de base de donnes. Le nom de fichier de ce rapport est listtabl.rptdesign. Ce fichier se trouve l'emplacement suivant :\reports\birt\reports\configur

1 Dveloppez et testez toutes les requtes SQL de base de donnes dans un outild'interrogation. Crez un rapport

2 Slectionnez Fichier>Nouveau>Autre. Dveloppez le dossier BusinessIntelligence and Reporting Tools.

3 Cliquez sur Rapport, puis sur Suivant. Affectez le rapport un projet etnommez-le.

4 Cliquez sur Suivant. Slectionnez le modle de rapport regroup TivoliMaximo.

5 Cliquez sur Terminer. La conception du rapport apparat.

10



Spcifiez la requte

6 Dans la vue de l'explorateur de donnes, slectionnez le fichier. Cliquez surl'onglet Script. Slectionnez la mthode d'ouverture dans la liste droulante.

7 Copiez votre requte de l'outil d'interrogation dans le corps de la mthodesous l'exemple de requte existant. Mettez en forme votre requte conformment l'exemple. Crez les colonnes de sortie

8 Cliquez deux fois sur le fichier pour ouvrir la bote de dialogue Proprits.Dans l'diteur de colonnes de sortie, entrez une colonne pour chaque champ de votre requte et chaque colonne tabulations. Si vous laissez la mthode d'ouverture visible lors de cette opration, vous pouvez l'utiliser comme rfrence dans les colonnes. Vous pouvez affecter aux colonnes de sortie des noms autres que les champs de base de donnes ou conserver les noms existants. Dfinissez le type de donnes de chaque colonne de sortie en fonction du paramtre maxtype du champ, comme spcifi dans le diagramme Mappage des types de donnes BIRT. Pour plus d'informations, voir Mappage des types de donnes BIRT, la page 18. IMPORTANT Si vous avez besoin de plusieurs fichiers, vous pouvez copier le fichier existant avant de poursuivre cette procdure. Des fichiers supplmentaires sont souvent ncessaires lorsque vous crez des sous-rapports.

Extrayez les lignes de donnes

9 Dans la page Script, choisissez la mthode d'extraction dans la listedroulante. Conformment l'exemple fourni dans le modle, ajoutez une ligne pour chaque colonne qui extrait la valeur du fichier et met jour la colonne de sortie avec cette valeur. Utilisez la mthode approprie en fonction du type de donnes du champ, conformment au mappage des types de donnes BIRT.

Activez le dbogage

10 Cliquez sur la vue Structure, slectionnez le rapport, puis l'onglet Script.Slectionnez bien la mthode d'initialisation dans la liste droulante. Ajoutez les lignes de dbogage.

Ajoutez les paramtres de rapport

11 Accdez la vue Fichier, cliquez l'aide du bouton droit de la souris surParamtres de rapport, puis slectionnez Nouveau. Remplissez les donnes. Cliquez sur OK.

Incorporez le paramtre de rapport dans votre clause SQL dans la mthode d'ouverture de fichier

12 Ajoutez un paramtre non li facultatif.Crez le SQL appropri l'aide de la mthode createParamWhereClause(). Voici un exemple de texte que vous pouvez ajouter la mthode d'ouverture :// Gnration de la clause where avec le paramtre non li DBTable var where = params["where"]; if (params ["DBTable"].value) where = where + " and " + MXReportSqlFormat.createParamWhereClause ("mo.objectname", params["DBTable"]);

Crez la prsentation du rapport

13 Slectionnez l'onglet Mise en page et ajoutez le titre du rapport. 14 Si le rapport ne requiert pas l'affichage des paramtres d'entre dans l'en-tte,supprimez la grille contenant les paramtres.


11


Ajoutez les donnes de dtail

15 Dans la vue Donnes, dveloppez le fichier. A l'aide de la souris, dplacez descolonnes de sortie sur la ligne de dtail de la mise en page. Pour ajouter d'autres colonnes au tableau, slectionnez l'onglet Table, puis l'onglet Colonne. Pour viter toute discontinuit dans la prsentation, insrez toujours les colonnes gauche.

16 Vrifiez l'apparence de votre prsentation.Ajoutez les en-ttes de colonne

17 Accdez la vue Palette. Faites glisser un libell existant sur les autres en-ttesde colonne. Par exemple, si l'en-tte de la premire colonne s'intitule Statut, vous pouvez ajouter ce libell aux autres colonnes.

Ajoutez les dtails du groupe

18 Ouvrez la vue Structure et cliquez sur Corps>Table> Groupes. Cliquez deuxfois sur l'entre Groupe de la table pour afficher l'diteur de groupe. Ajoutez la colonne de regroupement. Cliquez sur OK pour ajouter les dtails du groupe.

Prvisualisez le rapport

19 Cliquez sur l'onglet Aperu. Le rapport est excut avec les paramtres pardfaut.

20 Pour spcifier des paramtres autres que ceux par dfaut, cliquez sur Afficherles paramtres de rapport et entrez des valeurs valides.

21 Ajoutez des libells de groupe.Associez le rapport un fichier de proprits de localisation de libells qui stocke les paires cl/ valeur des libells

22 Pour effectuer cette tche, procdez comme suit : a Slectionnez la vue Structure. b Dans la page Proprits, slectionnez Ressources. c S'il existe un fichier de proprits pour votre application, slectionnez-le.Sinon, entrez le nom du nouveau fichier de proprits. Le nom que vous entrez doit correspondre au nom de votre dossier d'applications dans les rapports. Le systme cre le fichier de proprits l'emplacement suivant :...\reports\BIRT\libraries

Le nom du fichier de proprits du rapport Configuration de base de donnes est configur.properties.

d Cliquez sur OK.Slectionnez un libell localiser dans l'diteur de prsentation

23 Effectuez les tapes suivantes : a Dans la page Proprits, slectionnez le paramtre Localisation. b Cliquez sur Dtail () en regard du champ Cl du texte . c Entrez une nouvelle paire de valeurs de cl ou slectionnez-en uneexistante.

d Cliquez sur OK.Rptez cette tape pour tous les libells de votre prsentation. Pour plus d'informations sur l'activation des rapports localiss, voir Chapitre 4, Configuration de rapports localiss.12Guide de dveloppement des rapports


Dfinissez les longueurs de colonne pour garantir un affichage correct dans les fichiers PDF Affichez le rapport au format PDF

24 Slectionnez un onglet et la colonne correspondante du tableau. Vous pouvezredimensionner la colonne pour dfinir une largeur spcifique. Procdez de mme pour toutes les colonnes de tableau et de grille.

25 Pour afficher le rapport au format PDF, slectionnez l'icne d'affichage desrapports. Cliquez sur Afficher le rapport comme PDF.

26 Le rapport apparat. Retournez l'diteur de prsentation et ajustez lescolonnes si ncessaire.

27 Crez le fichier d'importation du rapport, reports.xml. Il existe un fichierd'importation dans chaque rpertoire de rapport d'application. Pour plus d'informations sur le fichier reports.xml, voir Chapitre 6.


13


Le texte suivant reprsente le fichier reports.xml du rapport Configuration de base de donnes :\reports\birt\tools

29 Pour importer tous les rapports de l'application Configuration de base dedonnes, excutez la commande suivante :importreports configur

Pour plus d'informations sur l'importation de rapports, voir Chapitre 6.

14



Connectez-vous au systme pour vrifier que vous avez charg votre rapport

30 Connectez-vous votre systme en tant qu'administrateur de rapport etouvrez l'application Administration des rapports. Dans le champ Nom du fichier de rapport, entrez Base de donnes pour filtrer dans le rapport Configuration de base de donnes.

31 Slectionnez votre rapport ; l'onglet des dtails du rapport apparat. Sincessaire, appliquez les privilges de scurit. IMPORTANT Vous dfinissez la scurit au niveau du rapport dans l'onglet Scurit. Vous dfinissez la scurit au niveau de l'application via l'action Dfinir la scurit de l'application.

32 Avant d'excuter le rapport pour la premire fois, cliquez sur Gnrer la pagede demande.

33 Pour prvisualiser votre rapport, cliquez sur Aperu. Entrez une valeur pourla table de base de donnes Paramtre ou cliquez sur Soumettre pour excuter le rapport sur tous les enregistrements. Le rapport BIRT regroup apparat dans le navigateur de rapports.


15


16


Fonctions de gnration de rapports BIRT avances

3

Ce chapitre contient des informations sur les fonctions de gnration de rapports avances pour vous aider utiliser BIRT Report Designer. Il aborde les sujets suivants : Vrification des types de base de donnes, des informations SQL et de la fonctionnalit de mise jour Excution de requtes supplmentaires Mise en forme du rapport Cration d'un lien hypertexte d'un rapport vers un autre Dbogage Enregistrement d'un rapport avec l'accs la barre d'outils de l'application Enregistrement d'un rapport pour plusieurs applications

Vrification des types de base de donnes, des informations SQL et de la fonctionnalit de mise jourCette section contient les sous-sections suivantes pour vous aider crer un rapport BIRT : Mappage des types de donnes BIRT Remarques sur la conception SQL Formatage des dates Test de la valeur Null Fonctions scalaires SQL conditionnel Ajout de la fonctionnalit de mise jour de la base de donnes


17

Vrification des types de base de donnes, des informations SQL et de la fonctionnalit de mise jour

Mappage des types de donnes BIRTCe diagramme indique le type de base de donnes, le type de donnes BIRT correspondant et la mthode utilise dans BIRT Designer pour extraire sa valeur. Ce diagramme dfinit les champs de donnes utiliss lors de la mthode d'extraction et la manire dont les colonnes de sortie des ensembles de donnes sont alimentes. Type de base de donnes Type de donnes BIRT Chane Chane DateHeure Dcimal Mthode de fichier utilise pour l'extraction getString(String attributeName) getBooleanString(String attributeName) getTimestamp(String attributeName) getDouble(String attributeName)

ALN, CLOB, GL, LONGALN, LOWER, UPPER YORN (Voir la section suivante sur le type de base de donnes YORN) DATE, DATETIME, TIME AMOUNT, DECIMAL, DURATION (Voir la section suivante sur le type de base de donnes DURATION.) FLOAT DURATION (Voir la section suivante sur le type de base de donnes DURATION.) INTEGER, SMALLINT IMPORTANT Type de base de donnes YORN

Variable flottante Chane Entier

getFloat(String attributeName) getDuration(String attributeName) getInteger(String attributeName)

Les types de base de donnes suivants ne sont pas pris en charge dans les rapports : BLOB, CRYPTO et CRYPTOX. Les champs YORN sont stocks dans la base de donnes sous forme de nombres (0 et 1), mais sont prsents dans le systme sous forme de texte localis. La mthode getBooleanString(String attributeName) effectue les deux tches : elle extrait la valeur numrique et la convertit en texte. Vous pouvez galement obtenir la valeur convertie partir de l'entier, l'aide de la mthode getBooleanString(int intValue). La base de donnes stocke DURATION sous forme de nombre (fractions d'heure), mais le systme prsente DURATION sous forme de chane au format HH:MM. La mthode getDuration renvoie la chane formate. Si vous avez besoin de la valeur numrique la place, utilisez la mthode getDecimal. Une mthode utilitaire supplmentaire, MXReportUtil.getDuration(String attributeName)permet de convertir la chane du format "double" au format "single".

Type de base de donnes DURATION

18


Vrification des types de base de donnes, des informations SQL et de la fonctionnalit de mise jour

Remarques sur la conception SQLUtilisez bien un SQL indpendant de la base de donnes chaque fois que possible. Utilisez la syntaxe des jointures SQL ANSI (jointures externes gauches, jointures externes droites). Par ailleurs, utilisez des fonctions ANSI, telles que CASE et COALESCE au lieu des fonctions propritaires, telles que DECODE et ISNULL. N'utilisez pas de qualification de propritaire (MAXIMO.workorder) et rfrencez tous les objets de base de donnes en minuscules.

Formatage des datesLe systme offre des mthodes MXReportSqlFormat statiques pour prendre en charge le formatage des dates. Toutes les chanes renvoyes des fonctions de date formates par JDBC peuvent tre utilises dans les instructions SQL des rapports pour toutes les bases de donnes prises en charge. Les instructions suivantes offrent un exemple :"where actualdate = " + MXReportSqlFormat.getStartDayTimestampFunction(params["startdate"] ); sqlText = "select job plan, description from job plan where " + params["where"] + " and job plan.wopriority = " + params["wopriority"];

36


Utilisation de valeurs boolennes comme paramtres

Utilisation de valeurs boolennes comme paramtresLes rapports qui acceptent des valeurs boolennes comme paramtres doivent suivre les instructions suivantes :

1 Vous devez dfinir le paramtre dans la conception du rapport commeparamtre de type chane.

2 Si la valeur du paramtre doit tre transmise une instruction SQL, la valeurdu paramtre doit tre convertie en entier (1 ou 0) car la base de donnes en a 1 ou 0. Pour cela, IBM a ajout un appel d'API au code du fichier (getBooleanInteger(string)). En voici un exemple :var isActiveFlag = params["isactive"]; mySQL = "select isactive from collection where isactive=?"; myDataSet.setQuery(mySQL); myDataSet.setQueryParameterValue(1, myDataSet.getBoolenanInteger(isActiveFlag));

ormySQL = "select isactive from collection where isactive=?"; myDataSet.setQuery(mySQL); myDataSet.setQueryParameterValue(1, myDataSet.getBooleanInteger(params["isactive"]));

3 N'utilisez pas de valeur par dfaut pour les paramtres YORN. Si des valeurspar dfaut sont requises, vous pouvez utiliser true ou false.

Utilisation des paramtres de rapport

37

Utilisation de valeurs boolennes comme paramtres

38


Importation et exportation de fichiers de conceptionCe chapitre contient les sections suivantes : Cration du fichier d'importation Importation de fichiers de conception Exportation de fichiers de conception

6

Cration du fichier d'importationDeux mthodes permettent d'importer des rapports BIRT dans la base de donnes systme : importation des rapports l'aide de l'application Administration des rapports utilisation de l'utilitaire d'importation. Si vous utilisez cet utilitaire, vous devez crer un fichier xml correspondant. Chaque dossier d'application sous \reports\birt\reports contient un fichier d'importation intitul reports.xml. Par exemple, le dossier des rapports Configuration de base de donnes (CONFIGUR) contient un fichier reports.xml. Si vous avez dfini les paramtres du rapport dans le fichier xml avec les attributs appropris, l'outil d'importation insre ou met jour le tableau des paramtres du rapport (reportlookup) en y intgrant ces informations. Les noms d'attribut des paramtres correspondent aux colonnes du tableau reportlookup. Si le nom de paramtre que vous avez dfini dans le fichier reports.xml d'un rapport donn n'existe pas dans ce rapport, le systme l'ignore. Certaines des valeurs d'attribut utilisent les valeurs du rapport comme valeurs par dfaut si ces valeurs ne sont pas spcifies dans le fichier d'importation.


39

Importation de fichiers de conception

Lorsque vous spcifiez un symbole "suprieur " ou "infrieur " comme oprateur de paramtre, vous devez le prcder d'un caractre d'chappement, comme suit : < > & ' " < > & ' " infrieur suprieur perlute apostrophe guillemet

Le rapport Groupe de scurit (security_group.rptdesign) du dossier SECURGROUP est un exemple de rapport contenant des paramtres. Le rapport Liste des gammes d'oprations (jobplan.rptdesign) du dossier JOBPLAN est un exemple de rapport sans paramtre.

Importation de fichiers de conceptionL'importation d'un rapport a pour objet de charger report.xml et les fichiers de conception dans la base de donnes. Ces deux types de fichier sont ncessaires pour importer un rapport : Fichier reports.xml Ce fichier varie en fonction de l'application et contient toutes les informations ncessaires pour que vous puissiez importer un rapport (nom du fichier, description, paramtres). Fichier de conception Il peut s'agir d'un fichier de bibliothque (code utilis plusieurs fois pour le type de police, la taille, les numros de page et l'horodatage) ou d'un fichier de ressources (images ou fichiers externes). Pour importer un fichier, utilisez l'application Administration des rapports. Pour plus d'informations, reportez-vous l'aide en ligne. Pour importer plusieurs fichiers, utilisez la commande d'importation de rapports (importreports.cmd). La section ci-aprs dcrit les types de commande d'importation.

40


Importation de fichiers de conception

Importation de fichiers de conceptionEffectuez les oprations suivantes pour importer plusieurs fichiers de conception :

1 Accdez l'emplacement suivant :\reports\birt\tools et ouvrez le fichier

reporttools.properties.

2 Mettez jour ou vrifiez les proprits suivantes :maximo.report.birt.hostname maximo.report.birt.mxename maximo.report.birt.registryport maximo.report.birt.username maximo.report.birt.password maximo.report.birt.outputfolder

3 Sur un serveur d'applications, accdez au dossier suivant l'aide de l'invite decommande :\reports\birt\tools

4 Excutez la commande importreports.cmd pour importer des rapports, desbibliothques et des fichiers de ressources. Les commandes d'importation suivantes sont disponibles : Commande importreports.cmd Description importe tous les rapports, les fichiers de ressources et toutes les bibliothques fournit des dtails sur la manire d'excuter la commande et divers paramtres importe toutes les bibliothques importe tous les rapports importe tous les rapports. Par exemple, si vous excutez : importreports CONFIGUR La commande importe tous les rapports de l'application Configuration de base de donnes.

importreports help

importreports libraries importsreports importreports

Importation et exportation de fichiers de conception

41

Exportation de fichiers de conception

Exportation de fichiers de conceptionUtilisez la commande d'exportation (exportreport.cmd) pour exporter des fichiers de conception. Les commandes suivantes sont disponibles pour exporter des fichiers : Commande exportreports Description exporte toutes les bibliothques, les rapports et divers sous-dossiers de rapports exporte tous les rapports et divers sous-dossiers de rapports exporte toutes les bibliothques exporte tous les rapports de l'application spcifie. Par exemple, si vous excutez : exportreports CHANGE La commande exporte tous les rapports dans le dossier de rapports WOTRACK. Le rapport est export dans le dossier que vous avez dfini dans les emplacements suivants : la proprit maximo.report.birt.outputfolder du fichier reporttools.properties le champ Dossier du rapport de l'application Administration des rapports

exportreports report exportreports library exportreports

42


Description des fichiers de proprits systme..

A

Le tableau suivant identifie et dcrit brivement les fichiers spcifiques aux rapports du fichier de proprits systme : Fichier de proprits mxe.report.birt.maxconcurrentrun mxe.report.birt.queueideltimeseconds Description Nombre maximal de rapports que vous pouvez excuter simultanment. Nombre de secondes d'inactivit du Gestionnaire de file d'attente de rapport aprs que vous ayez excut un rapport. Contrles ActiveX que vous activez pour pouvoir imprimer un rapport avec des documents en pices jointes. Nombre de rapports devant tre affichs dans une page de rapports en ligne. La valeur par dfaut est 5.

mxe.activex

mxe.report.reportsInAPage


43

44


Description des fichiers de tche Cronx

B

Le tableau suivant identifie et dcrit brivement les fichiers spcifiques aux rapports du fichier de tche Cron : Tche Cron REPORTLOCKRELEASE REPORTSCHEDULE REPORTUSAGECLEANUP Description Signaler tche de libration de file d'attente verrouille Signaler tche priodique de planification Signaler tche de nettoyage du journal d'utilisation


45

46


RemarquesLe prsent document contient des informations sur les produits et services disponibles aux Etats-Unis. Le prsent document peut contenir des informations ou des rfrences concernant certains produits, logiciels ou services IBM non annoncs dans ce pays. Pour plus de dtails, rfrez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous votre partenaire commercial IBM. Toute rfrence un produit, logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou service puisse tre utilis. Tout autre lment fonctionnellement quivalent peut tre utilis, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilit de l'utilisateur d'valuer et de vrifier lui-mme les installations et applications ralises avec des produits, logiciels ou services non expressment rfrencs par IBM. IBM peut dtenir des brevets ou des demandes de brevet couvrant les produits mentionns dans le prsent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous dsirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par crit l'adresse suivante : IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. Pour le Canada, veuillez adresser votre courrier : IBM Director of Comercial Relations IBM Canada Ltd. 3600 Steeles Avenue East Markham, Ontario L3R 9Z7 Canada Les informations sur les licences concernant les produits utilisant un jeu de caractres double octet peuvent tre obtenues par crit l'adresse suivante : IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales.


47

LE PRESENT DOCUMENT EST LIVRE "EN L'ETAT" SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable. Le prsent document peut contenir des inexactitudes ou des coquilles. Ce document est mis jour priodiquement. Chaque nouvelle dition inclut les mises jour. IBM peut, tout moment et sans pravis, modifier les produits et logiciels dcrits dans ce document. Les rfrences des sites Web non IBM sont fournies titre d'information uniquement et n'impliquent en aucun cas une adhsion aux donnes qu'ils contiennent. Les lments figurant sur ces sites Web ne font pas partie des lments du prsent produit IBM et l'utilisation de ces sites relve de votre seule responsabilit. IBM pourra utiliser ou diffuser, de toute manire qu'elle jugera approprie et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies. Les licencis souhaitant obtenir des informations permettant : (i) l'change des donnes entre des logiciels crs de faon indpendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des donnes ainsi changes, doivent adresser leur demande : IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Ces informations peuvent tre soumises des conditions particulires, prvoyant notamment le paiement d'une redevance. Le logiciel sous licence dcrit dans ce document et tous les lments sous licence disponibles s'y rapportant sont fournis par IBM conformment aux dispositions de l'ICA, des Conditions internationales d'utilisation des logiciels IBM ou de tout autre accord quivalent. Les informations concernant des produits non IBM ont t obtenues auprs des fournisseurs de ces produits, par l'intermdiaire d'annonces publiques ou via d'autres sources disponibles. IBM n'a pas test ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilit. Elle ne peut recevoir aucune rclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit tre adresse aux fournisseurs de ces produits. Toute instruction relative aux intentions d'IBM pour ses oprations venir est susceptible d'tre modifie ou annule sans pravis, et doit tre considre uniquement comme un objectif.

48


Le prsent document peut contenir des exemples de donnes et de rapports utiliss couramment dans l'environnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de socits, de marques ou de produits des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de socits ou des donnes relles serait purement fortuite. Si vous visualisez ces informations en ligne, il se peut que les photographies et illustrations en couleur n'apparaissent pas l'cran.

MarquesLes termes qui suivent sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays : IBM AIX DB2 developerWorks Everyplace ibm.com Lotus Maximo Notes QuickPlace Tivoli WebSphere Adobe, le logo Adobe, PostScript et le logo PostScript sont des marques d'Adobe Systems Incorporated aux Etats-Unis et/ou dans certains autres pays. Java ainsi que tous les logos et toutes les marques incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays. Linux est une marque de Linus Torvalds aux Etats-Unis et/ou dans certains autres pays. Intel, le logo Intel, Intel Inside, le logo Intel Inside, Intel Centrino, le logo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, et Pentium sont des marques d'Intel Corporation ou de ses filiales aux Etats-Unis et dans certains autres pays. Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays. UNIX est une marque enregistre de The Open Group aux Etats-Unis et/ou dans certains autres pays.

49

50


Index

Aaccs la barre d'outils de l'application 26 activation des libells de rapport pour localisation 29

type de base de donnes 18

Eenregistrement d'un rapport avec l'accs la barre d'outils de l'application 26 pour plusieurs applications 28 ensembles de rsultats association 23 exportation fichiers de conception 42

BBIRT composants 1 Report Designer 2 Report Engine 2 BIRT Report Designer 39 ajout de la fonctionnalit de mise jour de la base de donnes 20 association des ensembles de rsultats 23 configuration 7 cration d'un lien hypertexte entre des rapports 24 cration d'un rapport 10 dossier des bibliothques 3 dossier des modles 4 dossier des outils 4 dossier des rapports 4 dossier scriptlibrary 4 fichiers 2 fichiers source 3 fonctions scalaires 20 formatage des donnes 19 mise en forme du rapport 24 modles 9 remarques sur la conception SQL 19 SQL conditionnel 20 test de la valeur null 19 types de donnes 18

Ffichier de tche cron REPORTLOCKRELEASE 45 REPORTSCHEDULE 45 fichiers de conception exportation 42 importation 40 fichiers de la phase de conception configuration systme 5 installation 5 fonctionnalit de mise jour de la base de donnes ajout 20 fonctions scalaires 20 format pour localisation 31 formatage des dates 19

I Ccration du fichier d'importation 39 importation cration du fichier 39 fichiers de conception 40 libells de rapport pour localisation 30

Ddbogage de BIRT Report Designer 25 dossier des bibliothques 3 dossier des modles 4 dossier des outils 4 dossier des rapports 4 dure Copyright IBM Corp. 2007, 2008

51

Index

Lliens hypertextes 24 localisation donnes 30 libells de rapport 29 mise en forme 31 localisation des donnes 30

Rrapport activation des libells pour localisation 29 cration d'un premier rapport 10 importation de libells 30 liens hypertextes 24 localisation des libells 29 mise en forme 24 types 33 rapports bass sur des paramtres 33 remarques sur la conception SQL 19 requtes excution de requtes supplmentaires dans la mthode d'extraction 22 excution de requtes supplmentaires dans la mthode d'ouverture 22

Mmthode d'extraction pour l'excution de requtes 22 mthode d'ouverture pour l'excution de requtes 22 modles 9 diagramme de sous-rapport Tivoli Maximo 10 rapport de diagramme Liste Tivoli Maximo 10 rapport de diagramme regroup Tivoli Maximo 10 Rapport Liste Tivoli Maximo 10 Rapport regroup Tivoli Maximo 10 Sous-rapport Tivoli Maximo 10

Sscriptlibrary 4 SQL conditionnel 20 SQL d'un rapport ajout de paramtres non lis 35 system properties mxe.activex 43 mxe.report.birt.maxconcurrentrun 43 mxe.report.birt.queueideltimeseconds 43 mxe.report.reportsInAPage 43

Pparamtres Active/Slectionne/Tout 33 ajout de paramtres non lis au SQL d'un rapport 35 lis 34 lis dans les instructions SQL 34 non lis 34 non lis dans les instructions SQL 35 utilisation de valeurs boolennes 37 paramtres Active/Slectionne/Tout 33 paramtres lis 34 dans les instructions SQL 34 paramtres non lis 34 dans les instructions SQL 35 plusieurs applications 28 prrequis de l'installation 5 pour la cration d'un premier rapport 9

Ttest de la valeur null 19 type de base de donnes dure 18 YORN 18 types de donnes 18 types de rapport 33

Vvaleurs boolennes utilisation comme paramtres 37

YYORN type de base de donnes 18

52


birt guide

Documents