< Précédent | Suivant >

Leçon 2 : Créer le fichier de conception de rapport BIRT

Cette leçon explique comment créer un fichier de conception de rapport BIRT pour un rapport de modèle.
A propos de cette tâche
Vous utilisez la vue Explorateur de rapports pour créer un nouveau rapport UML. Vous démarrez avec un canevas qui remplit le rapport avec une source de données pour le métamodèle UML et certains fichiers standard.
Les sources de données et les fichiers fournissent les données pour les rapports BIRT :
  • Une source de données spécifie où obtenir les données. Pour les rapports de modèles, la source de données est un ensemble de modèles. Vous pouvez utiliser des métamodèles, des modèles d'instance ou les deux.
  • Un fichier spécifie les données à utiliser dans le rapport. Pour les rapports de modèle, chaque fichier est un tableau de données qui est extrait d'un modèle de source de données. Un fichier est constitué de deux parties : une partie "mappage de ligne", qui recherche les objets du modèle pour les lignes du tableau, et une partie "mappage de colonne", qui recherche les attributs des objets du modèle et les organise en colonnes. Les deux parties Mappage de ligne et Mappage de colonne contiennent toutes deux des expressions XPath qui utilisent les structures du métamodèle pour interroger le modèle d'instance cible lorsque vous exécutez la conception de rapport pour générer un rapport.

Pour créer le fichier de conception de rapport BIRT :

  1. Créez un dossier pour le fichier de conception de rapport :
    1. Dans la vue Explorateur de projets, cliquez avec le bouton droit sur l'exemple de projet de rapport, puis cliquez sur Nouveau > Dossier.
    2. Entrez MonRapport pour le nom du dossier, puis cliquez sur Terminer.
  2. Créez le fichier de conception de rapport :
    1. Cliquez sur Fenêtre > Afficher la vue > Autre ; développez Génération de rapports, puis double-cliquez sur Explorateur de rapports.
    2. Dans la vue Explorateur de rapports, développez puis cliquez avec le bouton droit sur Modèle UML puis cliquez sur Nouveau rapport.
    3. Dans la fenêtre Ajouter un nouveau rapport, pour le gestionnaire de rapports pour le canevas, sélectionnez Modèles UML.
    4. Pour le rapport à utiliser comme canevas de départ, cliquez sur Rapport de modèle UML vierge puis cliquez sur Suivant.
    5. Pour le nom affiché du rapport, entrez Rapport métier.
    6. Pour la description du rapport, entrez Est un rapport sur les cas d'utilisation métier et les acteurs métier d'un modèle UML auquel le profil Rational Business Modeling a été appliqué.
    7. Cliquez sur Suivant.
    8. Pour le nom de fichier du rapport, entrez businessReport.rptdesign.
    9. Pour le dossier du rapport, cliquez sur Parcourir, accédez au dossier MonRapport dans l'exemple de projet de rapport et cliquez sur Terminer. Le nouveau Rapport métier est affiché dans la catégorie Modèle UML de la vue Explorateur de projets.

      Le rapport n'est pas affiché dans la vue Explorateur de projets tant vous n'avez pas actualisé la vue.

  3. Spécifiez l'exemple de modèle métier comme source de données pour le rapport :
    1. Dans la vue Explorateur de rapports, cliquez avec le bouton droit sur Rapport métier, puis cliquez sur Ouvrir. Le fichier businessReport.rptdesign s'ouvre dans l'éditeur de conception de rapport.
    2. Cliquez sur l'onglet Explorateur de données pour ouvrir l'Explorateur de données, développez Sources de données, cliquez avec le bouton droit sur Package principal, puis cliquez sur Modifier.
    3. Dans la fenêtre Modifier une source de données, à côté de la zone d'affichage pour les modèles d'instance, cliquez sur Ajouter.
    4. Dans la fenêtre de chargement des ressources, cliquez sur Parcourir l'espace de travail. Développez l'exemple de projet de rapport, cliquez sur Sample Business Model.emx, cliquez sur OK puis à nouveau sur OK.
      Remarque : Si vous spécifiez un modèle d'instance comme source de données, vous pouvez utiliser des exemples de données pour créer des fichiers, et vous pouvez prévisualiser le rapport.

      Le modèle UML qui est répertorié dans la source de données sous Métamodèles est le métamodèle UML.ecore. Ce métamodèle est prédéfini pour chaque source de données UML, ce qui signifie que vous pouvez utiliser des éléments du métamodèle UML, ainsi que des exemples de données provenant du modèle d'instance spécifié, pour créer des fichiers.

    5. Dans la fenêtre Modifier une source de données, cliquez sur OK.
  4. Ajoutez le titre du rapport, le nom du modèle et la documentation du modèle à la conception de rapport :
    1. Si la Palette n'est pas affichée, cliquez sur Fenêtre > Afficher la vue > Palette.
    2. Pour ajouter un titre au rapport, dans la Palette, cliquez sur Libellé et faites glisser le curseur dans l'éditeur de conception de rapport.
    3. Dans la zone du libellé, entrez Rapport de cas d'utilisation métier UML.
    4. Spécifiez une police et une couleur d'arrière-plan pour le titre et centrez le texte du titre.
      Remarque : Pour spécifier des caractéristiques telles que la police, la couleur d'arrière-plan et l'alignement, cliquez avec le bouton droit sur le libellé puis cliquez sur Style > Nouveau style.

      Utilisez les pages de la fenêtre Nouveau style pour spécifier les caractéristiques du style. Par exemple, vous pouvez centrer le texte dans la page Bloc de texte. Vous pouvez aussi attribuer un nom descriptif à un style dans la page Général ; ceci facilite l'application du même style à d'autres éléments similaires de la conception de rapport. Cela vous aide aussi à trouver le style si vous voulez le modifier.

      Pour plus d'informations sur l'utilisation de fonctions BIRT telles que la palette et les styles, voir le Guide pratique de BIRT dans l'aide en ligne de votre produit. Vous pouvez tester différents styles lors de ce tutoriel.

    5. Dans la vue Explorateur de données, développez Fichiers puis développez Tous les éléments nommés.
    6. Faites glisser nom dans l'éditeur de conception de rapport en dessous du titre.
    7. Spécifiez la police et la couleur d'arrière-plan pour le nom du modèle, centrez le nom du modèle et affectez-y une marge inférieure de 24 points. Vous utilisez la page des cases de la fenêtre Style pour attribuer des marges.
    8. Dans la Palette, cliquez sur Texte dynamique et faites glisser le curseur dans l'éditeur de conception de rapport. Le générateur d'expression s'ouvre. Contrairement aux éléments de données, les éléments de texte dynamique conservent la mise en forme du texte enrichi provenant de la documentation du modèle.
    9. Dans la zone Expression, entrez row["documentation"] et cliquez sur OK.
    10. Cliquez sur Fenêtre > Afficher la vue > Editeur de propriétés et, dans la vue Editeur de propriétés – Texte dynamique, cliquez sur l'onglet Liaison.
    11. Dans la zone Fichiers, sélectionnez Racine de package.
    12. Pour sauvegarder le rapport, cliquez sur Fichier > Sauvegarder.
    13. Cliquez sur l'onglet Aperçu dans l'éditeur de conception de rapport. Le nom et la documentation du modèle provenant du modèle d'instance Sample Business Model.emx sont affichés. La version anglaise du rapport doit être similaire à la figure suivante, même si les caractéristiques des styles que vous avez utilisés dans votre rapport sont probablement différentes :
Résultats

Vous pouvez maintenant ajouter du contenu au rapport.

< Précédent | Suivant >

Vos commentaires