Tutoriel 3 Création d'un rapport avec des sous-rapports côte à côte
Cette section décrit en détail comment créer un rapport qui affiche une liste de clients. Pour chaque client, le rapport contient les informations de commandes et de paiements. Les informations de commandes et de paiements se trouvent dans des sous-rapports distincts qui s'affichent côte à côte. Le rapport des clients est le rapport principal, appelé également rapport externe, et les sous-rapports des commandes et des paiements sont les rapports détaillés, appelés rapports internes.
Chaque rapport accède aux données depuis une table différente de l'exemple de base de données Classic Models. Le rapport des clients utilise les données de la table des clients. Le sous-rapport des commandes utilise les données de la table des commandes. Le sous-rapport des paiements utilise les données de la table des paiements.
Les rapports sont liés par une zone commune, CUSTOMERNUMBER. La valeur de cette zone de liaison dans le rapport principal détermine les données qui apparaissent dans les rapports détaillés. Par exemple, si le numéro du client dans le rapport principal est 173, le rapport détaillé affiche les informations des commandes et des paiements du client portant l'ID 173.
La figure 13-1 montre une partie d'un rapport complet.
Figure 13-1 : Rapport principal des clients avec les sous-rapports des commandes et des paiements
Dans ce tutoriel, vous allez exécuter les tâches suivantes :
Tâche 1 : Création d'un rapport
Si vous utilisez BIRT Report Designer, cette tâche suppose que vous avez déjà créé un projet pour les rapports. Si vous utilisez BIRT RCP Report Designer, aucune exigence de projet ne s'applique.
- Choisissez Fichier->Nouveau->Rapport.
- Dans Nouveau rapport, sélectionnez le projet dans lequel vous voulez stocker le rapport.
- Tapez le texte suivant comme nom de fichier :
- Sélectionnez Suivant.
- Sélectionnez Rapport vierge, puis choisissez Terminer. Le nouveau rapport apparaît dans l'éditeur de présentation.
Tâche 2 : Génération d'une source de données
Avant de concevoir le rapport dans l'éditeur de présentation, vous créez une source de données pour connecter le rapport à la base de données Classic Models.
- Choisissez Explorateur de données.
- Cliquez avec le bouton droit de la souris sur Sources de données, puis choisissez Nouvelle source de données dans le menu contextuel.
- Sélectionnez Base de données d'exemple Classic Models Inc dans la liste des sources de données, utilisez le nom de source de données par défaut, puis choisissez Suivant. Les informations de connexion de la nouvelle source de données apparaissent.
- Sélectionnez Terminer. BIRT Report Designer crée une source de données qui se connecte à la base de données d'exemple. Elle apparaît dans les sources de données dans l'explorateur de données.
Tâches 3 : Génération d'un fichier pour le rapport des clients
Dans cette procédure, vous allez générer un fichier pour indiquer les données à extraire de la table des clients. Le rapport des clients que vous créez ensuite utilise ce fichier.
- Dans l'explorateur de données, cliquez avec le bouton droit de la souris sur Fichiers, puis choisissez Nouveau fichier.
- Dans Nouveau fichier, tapez le texte suivant pour le nom de fichier :
- Utilisez les valeurs par défaut pour les autres zones :
- Source de données indique le nom de la source de données que vous avez créée.
- Type de fichier indique que le fichier utilise une requête SQL SELECT.
- Sélectionnez Suivant. Requête affiche les informations qui vous aident à créer une requête SQL. La zone de texte sur la droite indique les mots-clés nécessaires à une instruction SQL SELECT.
- Développez la table CUSTOMERS. Les colonnes de la table s'affichent.
- Utilisez l'instruction SQL SELECT pour indiquer les données à extraire. Vous pouvez taper les noms de colonnes et de tables, ou vous pouvez les faire glisser depuis la la gauche vers l'emplacement approprié dans l'instruction SELECT.
Cette instruction que vous avez créée, indiquée dans la
figure 13-2, obtient les valeurs des colonnes CUSTOMERNAME et CUSTOMERNUMBER de la table CUSTOMERS.
Figure 13-2 : Requête
- Choisissez Terminer pour enregistrer le fichier. Modifier le fichier affiche les colonnes définies dans la requête, et fournit des options permettant de modifier le fichier.
- Choisissez Aperçu des résultats pour confirmer que la requête est valide et qu'elle retourne les données appropriées. Si vous avez créé l'instruction SELECT correctement, vous devez voir les résultats qui apparaissent dans la figure 13-3. Il s'agit des lignes de données que retourne la requête.
Figure 13-3 : Aperçu des données
- Cliquez sur OK.
Tâche 4 : Génération d'un fichier pour le sous-rapport des commandes
Dans cette procédure, vous allez générer un fichier pour indiquer les données à extraire de la table des commandes. Le sous-rapport des commandes que vous aller créer utilise ce fichier.
- Dans l'explorateur de données, cliquez avec le bouton droit sur Fichiers, puis choisissez Nouveau fichier dans le menu contextuel.
- Dans Nouveau fichier, tapez le texte suivant pour le nom du fichier :
- Utilisez les valeurs par défaut pour les autres zones, puis choisissez Suivant.
- Dans Requête, développez la table des commandes pour afficher ses colonnes.
- Utilisez l'instruction SQL SELECT suivante pour indiquer les données à extraire :
Cette instruction sélectionne les colonnes ORDERNUMBER et ORDERDATE de la table des commandes. La clause WHERE a un marqueur de paramètre pour la valeur CUSTOMERNUMBER. Lorsque le rapport s'exécute, le sous-rapport des commandes obtient la valeur en cours CUSTOMERNUMBER du rapport des clients.
- Choisissez Terminer pour enregistrer le fichier. Modifier le fichier contient les colonnes définies dans la requête et fournit des options permettant de modifier le fichier.
- Créez un paramètre de fichier pour fournir la valeur CUSTOMERNUMBER dans la clause WHERE :
- Choisissez Paramètres dans la partie gauche de la fenêtre. Modifier le fichier affiche les informations de paramètres.
- Définissez les valeurs suivantes dans la première ligne de la table :
- Nom : CustID
- Type de données : entier
- Sens : entrée
- Valeur par défaut : 103
103 est l'une des valeurs figurant dans la colonne CUSTOMERNUMBER. Une valeur par défaut est nécessaire à BIRT Report Designer pour exécuter la requête à des fins de vérification.
Modifier le fichier doit se présenter comme indiqué dans la
figure 13-4.
Figure 13-4 : Définition des paramètres dans le sous-rapport des commandes
- Choisissez Aperçu des résultats pour confirmer que la requête est valide et qu'elle retourne les données appropriées. Si vous avez créé l'instruction SELECT et le paramètre de fichier correctement, les résultats indiqués dans la figure 13-5 doivent apparaître. Il s'agit des lignes de données que retourne la requête pour le client 103.
Figure 13-5 : Aperçu des données du sous-rapport des commandes
- Choisissez OK pour enregistrer le fichier.
Tâche 5 : Génération d'un fichier pour le sous-rapport des paiements
Dans cette procédure, vous allez générer un fichier pour indiquer les données à extraire de la table des paiements. Le sous-rapport des paiements que vous aller créer utilise ce fichier.
- Dans l'explorateur de données, cliquez avec le bouton droit de la souris sur Fichiers, puis choisissez Nouveau fichier dans le menu contextuel.
- Dans Nouveau fichier, tapez le texte suivant pour le nom du fichier :
- Utilisez les valeurs par défaut pour les autres zones, puis choisissez Suivant.
- Dans Requête, développez la table des paiements pour afficher ses colonnes.
- Utilisez l'instruction SQL SELECT suivante pour indiquer les données à extraire :
Cette instruction sélectionne les colonnes PAYMENTDATE, CHECKNUMBER et AMOUNT de la table des paiements. La clause WHERE a un marqueur de paramètre pour la valeur CUSTOMERNUMBER. Lorsque le rapport s'exécute, le sous-rapport des paiements obtient la valeur en cours CUSTOMERNUMBER du rapport des clients.
- Choisissez Terminer pour enregistrer le fichier. Modifier le fichier contient les colonnes définies dans la requête et fournit des options permettant de modifier le fichier.
- Créez un paramètre de fichier pour fournir la valeur CUSTOMERNUMBER de la clause WHERE :
- Choisissez Paramètres. Modifier le fichier affiche les informations des paramètres.
- Définissez les valeurs suivantes dans la première ligne de la table :
- Nom : CustID
- Type de données : entier
- Sens : entrée
- Valeur par défaut : 103
- Choisissez Aperçu des résultats pour confirmer que la requête est valide et qu'elle retourne les données appropriées. Si vous avez créé l'instruction SELECT et le paramètre de fichier correctement, les résultats indiqués dans la figure 13-6 doivent apparaître. Il s'agit des lignes de données que retourne la requête pour le client 103.
Figure 13-6 : Aperçu des données du sous-rapport des paiements
- Choisissez OK pour enregistrer les modifications dans le fichier.
Tâche 6 : Création du rapport principal des clients
Vous utilisez une liste pour créer le rapport principal et y organiser les sous-rapports des commandes et des paiements. La liste lit les lignes de données des clients et crée les sous-rapports des commandes et des paiements pour chaque enregistrement. Dans un souci de simplification, le rapport des clients contient uniquement le nom du client. Il peut, naturellement, contenir d'autres données, telles que l'adresse, le numéro de téléphone et le plafond de crédit du client.
- Choisissez Palette.
- Faites glisser une liste de la palette et déposez-la sur le rapport. La liste apparaît dans le rapport, comme indiqué dans la figure 13-7.
Figure 13-7 : Liste
- Associez, ou liez, la liste au fichier des clients :
- Dans l'Editeur de propriétés,choisissez l'onglet Liaison.
- Pour le fichier, sélectionnez Customers dans la liste déroulante.
- Choisissez Explorateur de données, puis développez Fichiers, puis Customers. Les colonnes que vous avez définies dans la requête apparaissent sous Customers.
- Faites glisser CUSTOMERNAME depuis l'explorateur de données et déposez l'élément dans la zone de détail de la liste. BIRT Report Designer crée une colonne nommée qui est liée à la zone de fichier. Sélection de la liaison de données affiche la liaison de colonne.
- Choisissez OK pour acceptez la liaison de colonne par défaut. Dans l'éditeur de présentation, la liste affiche la zone que vous avez ajoutée, comme indiqué dans la figure 13-8.
Figure 13-8 : Zone Fichier dans la liste
- Choisissez Aperçu pour prévisualiser le rapport. Le rapport doit se présenter comme celui indiqué dans la figure 13-9. Le rapport contient tous les noms des clients selon l'ordre dans lequel la requête les a retournés.
Figure 13-9 : Aperçu des données du rapport principal
- Triez les noms des clients en ordre croissant :
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Dans l'éditeur de présentation, sélectionnez la liste. Placez le pointeur de la souris dans l'angle inférieur gauche jusqu'à ce que l'onglet Liste s'affiche. Choisissez l'onglet.
- Dans l'éditeur des propriétés, choisissez l'onglet Tri.
- Dans la page Trier, choisissez Ajouter pour créer une expression de tri. Une ligne apparaît sous Trier.
- Cliquez sur la zone sous Clé de tri, puis sélectionnez le bouton fléché qui apparaît, puis CUSTOMERNAME dans la liste déroulante.
- Utilisez la valeur par défaut, Ascendant comme sens de tri, comme indiqué dans la figure 13-10.
Figure 13-10 : Expression de tri
- Prévisualisez le rapport. Les noms des clients sont triés en ordre croissant.
Tâche 7 : Création du sous-rapport des commandes
Le sous-rapport des commandes contient la liste des commandes de chaque client dans un format de ligne et de colonne. Il affiche le numéro et la date de chaque commande. Pour lire les lignes du fichier de commandes et les afficher dans une ligne et une colonne, vous utilisez l'élément table.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Faites glisser la table depuis la palette et déposez-la sous l'élément de données [CUSTOMERNAME] dans la zone de détail. Insérer une table demande de définir le nombre de colonnes et de lignes de détail à créer pour la table.
- Indiquez que vous voulez créer 2 colonnes et 1 ligne de détail, puis choisissez OK. Une table comportant deux colonnes et une ligne de détail apparaît dans l'éditeur de présentation.
- Liez la table au fichier des commandes :
- Dans l'éditeur des propriétés, choisissez Liaison.
- Pour Fichier, sélectionnez Orders dans la liste déroulante.
- Choisissez Explorateur de données, puis développez Fichiers et Orders. Les colonnes que vous avez définies dans la requête apparaissent sous Orders.
- Faites glisser ORDERNUMBER depuis l'explorateur de données et déposez l'élément dans la première cellule de la ligne des détail de la table. BIRT Report Designer crée une colonne nommée qui est liée à la zone de fichier. Sélection de la liaison de données affiche cette liaison de colonne.
- Choisissez OK pour accepter la liaison de colonne par défaut.
Dans l'éditeur de présentation, la cellule de table dans laquelle vous avez déposé la zone de fichier contient un élément de données qui affiche [ORDERNUMBER]. Au-dessus de l'élément donnée figure un intitulé qu'ajoute automatiquement l'éditeur de présentation à la ligne d'en-tête. Cet intitulé affiche le nom de champ sous la forme d'un texte statique et fait office d'en-tête de colonne.
- Faites glisser ORDERDATE depuis l'explorateur de données et déposez l'élément dans la deuxième cellule dans la ligne de détail. Choisissez OK pour accepter la liaison de colonne par défaut. La page de rapport doit se présenter comme indiqué dans la figure 13-11.
Figure 13-11 : La conception de rapport inclut le sous-rapport des commandes
- Triez les lignes de commande en fonction du numéro de commande :
- Sélectionnez la table des commandes.
- Dans l'éditeur de propriétés, choisissez Tri.
- Dans la page Trier, choisissez Ajouter pour créer une expression de tri. Une ligne apparaît sous Trier.
- Cliquez sur la zone sous Clé de tri, puis sélectionnez le bouton fléché qui apparaît, puis ORDERNUMBER dans la liste déroulante.
- Utilisez la valeur par défaut, Ascendant, comme sens de tri.
- Prévisualisez le rapport.
Le rapport doit se présenter comme celui indiqué dans la
figure 13-12.
Figure 13-12 : La prévisualisation du rapport montre des enregistrements de commande répétés
Les mêmes enregistrements de commande apparaissent pour chaque client, car vous avez défini la valeur par défaut 103 pour customerNumber lorsque vous avez créé le paramètre de fichier CustID. Du fait de cette valeur par défaut, le sous-rapport des commandes affiche toujours les enregistrements de commande du client 103.
La solution consiste à mettre à jour dynamiquement la valeur du paramètre CustID chaque fois que la ligne client dans le rapport principal change. Cette procédure est décrite dans la tâche suivante.
Tâche 8 : Liaison du sous-rapport des commandes au rapport principal des clients
Vous liez le sous-rapport des commandes au rapport principal des clients en liant le paramètre CustID à la zone de fichier CUSTOMERNUMBER dans le rapport des clients. Chaque fois que le rapport des clients atteint un nouvelle ligne client, le paramètre CustID est mis à jour avec la nouvelle valeur CUSTOMERNUMBER.
Pour pouvoir lier le paramètre CustID à la zone de fichier CUSTOMERNUMBER, vous devez créer une liaison de colonne et la lier au champ de fichier. Les paramètres ne peuvent pas accéder aux zones de fichier directement.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Créez une liaison de colonne avec la zone de fichier CUSTOMERNUMBER :
- Sélectionnez la liste.
- Dans l'éditeur de propriétés, choisissez Liaison.
- Dans la page Liaison, choisissez Ajouter.
- Dans le générateur d'expressions, choisissez Fichiers disponibles, Clients, puis cliquez deux fois sur CUSTOMERNUMBER. Le générateur d'expressions affiche l'expression dataSetRow["CUSTOMERNUMBER"], comme indiqué dans la figure 13-13.
Figure 13-13 : Le générateur d'expressions montre l'expression de liaison de colonne
- Cliquez sur OK. La nouvelle liaison de colonne apparaît dans la page de liaison de l'éditeur des propriétés avec le nom de colonne en surbrillance.
- Remplacez le nom de nouvelle liaison par le nom suivant :
- Sélectionnez la table des commandes.
- Dans l'éditeur des propriétés, choisissez Liaison.
- Dans la page Liaison, choisissez Liaison de paramètre de fichier. Liaison de paramètre de fichier affiche le paramètre CustID, comme indiqué dans la figure 13-14. Sa valeur est la valeur par défaut 103, que vous avez définie lors de la création du paramètre de fichier.
Figure 13-14 : Liaison de paramètre de fichier pour la table des commandes
- Remplacez la valeur du paramètre par la zone CUSTOMERNUMBER dans le rapport des clients :
- Cliquez dans la zone Valeur, puis choisissez le bouton qui apparaît sur la droite.
Le générateur d'expressions apparaît.
- Dans le générateur, choisissez Liaisons de colonnes disponibles, choisissez Liste, puis cliquez deux fois sur CUSTOMER_NUMBER. Le générateur d'expressions affiche l'expression row["CUSTOMER_NUMBER"], comme indiqué dans la figure 13-15.
Figure 13-15 : Zone CUSTOMERNUMBER dans le générateur d'expressions
- Choisissez OK pour enregistrer l'expression. La page Liaison de paramètre de fichier affiche la nouvelle valeur row["CUSTOMER_NUMBER"] du paramètre CustID.
- Choisissez OK pour enregistrer la liaison de paramètre de fichier.
- Prévisualisez le rapport qui doit se présenter comme celui de la figure 13-16.
Figure 13-16 : La prévisualisation du rapport montre les données de commandes appropriées
Tâche 9 : Création du sous-rapport des paiements
Le sous-rapport des paiements montre, dans un format de ligne et de colonne, les paiements de chaque client. Il contient la date du paiement, le numéro du chèque et le montant de chaque commande. Pour lire les lignes de fichier de paiement et les afficher dans un format de ligne et de colonne, vous utilisez l'élément table.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Faites glisser une table depuis la palette et déposez-la sous le sous-rapport des commandes dans la zone de détail. Insérer une table demande de définir le nombre de colonnes et de lignes de détail à créer pour la table.
- Indiquez que vous voulez créer 3 colonnes et 1 ligne de détail, puis choisissez OK. Une table comportant deux colonnes et une ligne de détail apparaît dans l'éditeur de présentation.
- Liez la table au fichier des paiements :
- Dans l'éditeur des propriétés, choisissez Liaison.
- Pour Fichier, sélectionnez Payments dans la liste déroulante.
- Choisissez Explorateur de données, puis développez Fichiers, puis Paiements. Les colonnes que vous avez définies dans la requête apparaissent sous Payments.
- Faites glisser les zones suivantes depuis l'explorateur de données, et déposez-les respectivement dans la première, la deuxième et la troisième cellules, dans la ligne de détails de la table. Choisissez OK pour accepter les liaisons de colonne par défaut pour toutes les zones.
- PAYMENTDATE
- CHECKNUMBER
- AMOUNT
La page de rapport doit se présenter comme indiqué dans la
figure 13-17.
Figure 13-17 : La conception de rapport inclut le sous-rapport des paiements
La table montre les zones de fichier que vous avez ajoutées. Elle contient également les intitulés que l'éditeur de présentation a ajoutés automatiquement à la ligne d'en-tête. Les intitulés affichent les noms de zone sous la forme d'un texte statique et font office d'en-têtes de colonnes.
- Triez les lignes de paiement en fonction de la date de paiement.
- Sélectionnez la table des paiements.
- Dans l'éditeur de propriétés, choisissez Trier.
- Dans page Trier, choisissez Ajouter pour créer une expression de tri. Une ligne apparaît sous Trier.
- Cliquez sur la zone sous Clé de tri, puis sélectionnez le bouton fléché qui apparaît, puis sélectionnez PAYMENTDATE dans la liste déroulante.
- Utilisez la valeur par défaut,Ascendant, comme sens de tri.
- Prévisualisez le rapport. Le rapport doit se présenter comme celui indiqué dans la figure 13-18.
Figure 13-18 : La prévisualisation de rapport montre des enregistrements de paiement répétés.
Comme pour le sous-rapport des commandes lorsque vous l'avez créé, les mêmes enregistrements de paiement apparaissent pour chaque client, car vous avez défini la valeur 103 pour customerNumber lorsque vous avez créé le paramètre de fichier CustID pour le fichier des paiements. Du fait de cette valeur par défaut,le sous-rapport des paiements affiche toujours les enregistrements de paiement du client 103.
Comme vous l'avez fait pour le sous-rapport des commandes, vous devez mettre à jour dynamiquement la valeur du paramètre CustID pour chaque client dans le rapport principal
Tâche 10 : Liaison du sous-rapport des paiements au rapport principal des clients
Vous liez le sous-rapport des paiements au rapport principal des clients en liant son paramètre CustID à la zone de fichier CUSTOMERNUMBER dans le rapport des clients.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Sélectionnez la table des paiements.
- Dans l'éditeur de propriétés, choisissez l'onglet Liaison.
- Dans la page Liaison, choisissez Liaison de paramètre de fichier. Liaison de paramètre de fichier affiche le paramètre CustID. Sa valeur est la valeur par défaut 103, que vous avez définie lors de la création du paramètre de fichier.
- Remplacez la valeur du paramètre par la zone CUSTOMERNUMBER dans le rapport des clients :
- Cliquez dans la zone Valeur, puis choisissez le bouton qui apparaît sur la droite.
- Dans le générateur d'expressions,choisissez Liaisons de colonnes disponibles, choisissez Liste, puis cliquez deux fois sur CUSTOMER_NUMBER. Le générateur d'expressions affiche l'expression row["CUSTOMER_NUMBER"].
- Choisissez OK pour enregistrer l'expression. La page Liaison de paramètre de fichier affiche la nouvelle valeur row["CUSTOMER_NUMBER"] du paramètre CustID.
- Choisissez OK pour enregistrer la liaison de paramètre de fichier modifiée.
- Prévisualisez le rapport. Désormais, le rapport affiche les différents enregistrements de paiement des différents clients. Les clients n'ont pas tous des enregistrement de paiement. Pour afficher uniquement les clients ayant des paiements, changez la requête du rapport des clients.
Tâche 11 : Affichage uniquement des clients ayant des commandes ou des paiements
La base de données contient les clients qui n'ont pas de paiements ou de commandes. La requête du rapport des clients retourne tous les clients. Lorsque vous exécutez le rapport, il existe des lignes client qui contiennent uniquement les en-têtes de colonne des tables des commandes et des paiements, comme indiqué dans la figure 13-19.
Figure 13-19 : Le rapport ne montre aucune donnée de commande ou de paiement pour un client
Vous pouvez exclure les clients sans commandes ou paiements en changeant la requête du rapport des clients.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Dans l'explorateur des données, développez Fichiers, cliquez avec le bouton droit de la souris sur Customers, puis choisissez Editer.
- Ajoutez les lignes SQL suivantes à la fin de la requête existante :
La clause WHERE EXISTS recherche les valeurs CustomerNumber dans les tables des commandes et des paiements, qui correspondent aux valeurs customerNumber dans la table des clients. Seules les lignes ayant des valeurs customerNumber correspondantes sont sélectionnées. La requête complète doit être identique à celle de la
figure 13-20.
Figure 13-20 : Clause WHERE EXISTS dans Modifier le fichier
- Sélectionnez Aperçu des résultats pour vérifier que la requête retourne les lignes, puis choisissez OK.
- Prévisualisez le rapport. Faites défiler le rapport vers le bas pour vérifier la sortie. Le rapport ne contient plus les clients n'ayant pas de paiements ou de commandes.
Tâche 12 : Affichage de sous-rapports côte à côte
Maintenant que les sous-rapports affichent les données appropriées, vous pouvez vous attacher à présenter les rapports côte à côte. Vous ne pouvez pas placer deux tables côte à côte, car BIRT Report Designer crée des éléments au niveau du bloc, ce qui implique que chaque élément commence sur une nouvelle ligne. Pour pouvoir afficher les tables côte à côte, vous devez insérer les tables dans une grille. La grille permet d'aligner aisément les éléments.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Faites glisser une liste de la palette et déposez-la sur la ligne de détail au-dessus de la table des commandes. Insérer une grille demande de définir le nombre de colonnes et de lignes de la grille.
- Dans Nombre de colonnes, tapez 2, et dans Nombre de lignes, tapez 1. Choisissez OK.
Une grille comportant deux colonnes et une ligne apparaît dans l'éditeur de présentation.
- Transférez la table des commandes vers la première cellule de la grille. Pour ce faire, sélectionnez l'onglet Table dans l'angle inférieur gauche, puis faites glisser la table et déposez-la dans la cellule de la grille.
- Transférez la table des paiements vers la deuxième cellule de la grille. La présentation du rapport doit être identique à celleindiqué dans la figure 13-21.
Figure 13-21 : Sous-rapports côte à côte dans la conception de rapport
- Prévisualisez le rapport. Le rapport doit se présenter comme celui indiqué dans la figure 13-22.
Figure 13-22 : Aperçu du rapport montrant les rapports côte à côte
Tâche 13 : Formatage du rapport
Maintenant que le rapport contient les données correctes et qu'il a la présentation appropriées, vous pouvez améliorer son apparence. Dans cette section, vous allez effectuer les tâches suivantes :
Mise en surbrillance des noms des clients
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Dans l'éditeur, sélectionnez l'élément de données [CUSTOMERNAME].
- Choisissez l'onglet Propriétés de l'éditeur des propriétés.
- Sélectionnez Général dans la liste située sous Propriétés. L'éditeur des propriétés affiche les propriétés générales de formatage de l'élément donnée.
- Pour la taille, choisissez Grande pour afficher le texte de l'élément dans une grande taille. La taille du texte augmente.
- Choisissez G pour mettre les données en gras. Les données apparaissent en gras.
Modification des en-têtes de colonne
Lorsque vous insérez une zone de fichier dans une table, BIRT Report Designer ajoute automatiquement un intitulé avec la zone de champ de fichier dans la ligne d'en-tête. Bien souvent, les noms de zone de fichier ont un format non adapté aux rapports, et vous devez donc les changer.
- Cliquez deux fois sur le premier en-tête de colonne dans la table des commandes. Le texte est mis en surbrillance.
- Remplacez ORDERNUMBER par le texte suivant, puis appuyez sur Entrée :
- Répétez les étapes précédentes pour remplacer les en-têtes de colonne restants par le texte suivant :
La présentation de rapport doit être identique à celle de la
figure 13-23.
Figure 13-23 : En-têtes de colonne modifiés dans la conception de rapport
- Prévisualisez le rapport. Le rapport doit se présenter comme celui indiqué dans la figure 13-24.
Figure 13-24 : En-têtes de colonne modifiés dans l'aperçu de rapport
Changement des formats de dates
Lorsque vous insérez un élément de données de type date, BIRT Report Designer affiche les dates en fonction des paramètres régionaux de votre système. BIRT Report Designer fournit un grand nombre de formats différents que vous pouvez sélectionner si vous ne voulez pas utiliser le format par défaut. Dans cette procédure, vous allez créer un style qui remplace le format des valeurs ORDERDATE et PAYMENTDATE, à savoir Jun 3, 2005 12:00 AM par 6/3/05.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Sélectionnez l'élément données qui affiche [ORDERDATE].
- Sélectionnez Elément->Nouveau style dans le menu principal. Nouveau style affiche les propriétés que vous pouvez définir pour un style, comme indiqué dans la figure 13-25.
Figure 13-25 : Nouveau style
- Pour le style personnalisé, tapez :
- Choisissez Format Date-Heure dans la liste des propriétés de style sur la gauche.
- Choisissez le format m/j/aa dans la liste déroulante. Les valeurs de cette liste sont mises à jour dynamiquement avec la date en cours.
- Cliquez sur OK.
Le style Date_data est appliqué à l'élément de données [ORDERDATE], comme indiqué dans la
figure 13-26.
Figure 13-26 : Style Date_data appliqué à l'élément de données
- Appliquez le style Date_data à la date de paiement.
- Sélectionnez l'élément de données qui affiche [PAYMENTDATE], comme indiqué dans figure 13-27.
Figure 13-27 : Elément [PAYMENTDATE] sélectionné
- Cliquez avec le bouton droit de la souris sur l'élément sélectionné, puis choisissez Style->Appliquer un style->Date_data.
- Prévisualisez le rapport. Le format de date Jun 3, 2005 12:00 AM est remplacé par 6/3/05.
Changement des formats des nombres
Lorsque vous insérez un élément de données de type entier, BIRT Report Designer affiche les nombres en fonction des paramètres régionaux de votre système. BIRT Report Designer fournit un grand nombre de formats différents que vous pouvez sélectionner si vous ne voulez pas utiliser le format par défaut. Dans cette procédure, vous allez créer un style qui remplace le format des montants de type 48425.69 par $48,425.69.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Sélectionnez l'élément de données qui affiche [AMOUNT] dans la table des paiements.
- Choisissez Elément->Nouveau style dans le menu principal. Nouveau style affiche les propriétés de la catégorie générale.
- Pour le style personnalisé, tapez :
- Choisissez Format Nombre dans la liste des propriétés de style sur la gauche.
- Définissez les attributs de formatage suivants, comme indiqué dans la figure 13-28 :
- Pour Formater le nombre sous la forme, sélectionnez Devise dans la liste déroulante.
- Pour Positions de la décimale, utilisez la valeur par défaut 2.
- Sélectionnez Utiliser le séparateur de milliers.
- Pour Symbole, sélectionnez $ dans la liste déroulante.
- Utilisez les valeurs par défaut pour les autres attributs.
Figure 13-28 : Propriétés de formatage des numéros
- Cliquez sur OK. Le style Currency_dataest appliqué à l'élément de données [AMOUNT], comme indiqué par la propriété Style de l'élément dans l'éditeur de propriétés.
- Prévisualisez le rapport. Les numéros apparaissent dans le format de devise, comme indiqué dans la figure 13-29.
Figure 13-29 : Format de devise dans l'aperçu de rapport
Augmentation de l'espace vertical entre les éléments
Dans cette procédure, vous allez augmenter l'espace entre chaque nom de client et les lignes qui le précèdent et qui le suivent. Vous pouvez ajuster l'espace vertical entre les éléments de différentes manières :
- Vous pouvez augmenter le remplissage supérieur ou inférieur ou les marges des éléments.
- Vous pouvez organiser les éléments dans une grille et ajuster les hauteurs des lignes de la grille.
- Vous pouvez organiser les éléments de la grille et utiliser des lignes vides avec des hauteurs définies pour espacer les éléments.
Une grille facilite le formatage et permet de prévoir plus précisément le résultat. Les valeurs des propriétés de remplissage et des marges peuvent donner des résultats différents dans différents navigateurs Web. Dans cette procédure, vous utilisez la troisième méthode.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Placez l'élément de données [CUSTOMERNAME] dans la grille qui contient les deux tables en procédant comme suit :
- Sélectionnez la grille. Placez le pointeur de la souris dans l'angle inférieur gauche jusqu'à ce que l'onglet Grille s'affiche. Choisissez l'onglet. Des cellules-guides apparaissent en haut et sur le côté gauche de la grille sélectionnée.
L'éditeur de présentation affiche les bordures des éléments de données, des grilles, des tables et des cellules, et il peut s'avérer difficile parfois de déterminer l'emplacement d'un élément. Si vous voulez avoir une vue plus claire des conteneurs et des éléments dans les conteneurs, utilisez la vue Structure pour obtenir une vue arborescente de la conception du rapport. Vous pouvez utiliser également la vue Structure pour sélectionner un élément s'il est trop difficile à sélectionner. Par exemple, la sélection de la grille à la place de la table dans la grille peut être difficile. Pour ouvrir la vue Structure, choisissez Fenêtre>Afficher la vue>Structure.
- Cliquez avec le bouton droit de la souris sur la cellule-guide à gauche de la première ligne de la grille, puis choisissez Insérer>Ligne->Au-dessus, comme indiqué dans la figure 13-30.
Figure 13-30 : Insertion d'une nouvelle ligne
Une nouvelle ligne apparaît au-dessus de la ligne sélectionnée.
- Transférez l'élément de données[CUSTOMERNAME] de son emplacement actuel vers la première cellule de la nouvelle ligne de la grille, comme indiqué dans la figure 13-31.
Figure 13-31 : Transfert de l'élément de données vers la nouvelle ligne
- Ajoutez une nouvelle ligne de grille au-dessus et en dessous de la ligne qui contient l'élément de données [CUSTOMERNAME] en suivant les procédures décrites précédemment.
- Sélectionnez la grille, puis la première ligne de la grille, comme indiqué dans la figure 13-32.
Figure 13-32 : Sélection de la première ligne
- Dans les propriétés générales de l'éditeur de propriétés, définissez une hauteur de ligne de 0,2 pouce, comme indiqué dans la figure 13-33.
Figure 13-33 : Définition de la propriété de hauteur de ligne
- Sélectionnez la troisième ligne de la grille et définissez une hauteur de ligne de 0,1 pouce. La conception de rapport doit être identique à celle de la figure 13-34.
Figure 13-34 : Nouvelles hauteurs de ligne dans la conception de rapport
- Prévisualisez le rapport. Il existe plus d'espace au-dessus et en dessous du nom du client. Le rapport doit se présenter comme celui de la figure 13-35.
Figure 13-35 : Prévisualisation du rapport avec l'espace ajouté
Augmentation de l'espace horizontal entre les tables de commandes et de paiements
Dans cette procédure, vous aller augmenter l'espace entre les tables des commandes et des paiements. Comme pour l'espacement vertical, vous pouvez ajouter l'espace horizontal entre les éléments de différentes manières :
- Vous pouvez augmenter le remplissage gauche et droit ou les marges des éléments.
- Vous pouvez organiser les éléments dans une grille et ajuster les largeurs des colonnes de la grille.
- Vous pouvez organiser les éléments dans une grille et utiliser des colonnes vides avec des largeurs définies pour espacer les éléments.
Là encore, Une grille facilite le formatage et permet de prévoir plus précisément le résultat. Les valeurs des propriétés de remplissage et des marges peuvent donner des résultats différents dans différents navigateurs Web. Dans cette procédure, vous utilisez la troisième méthode.
- Choisissez Structure pour revenir à l'éditeur de présentation.
- Sélectionnez la grille. Placez le pointeur de la souris dans l'angle inférieur gauche jusqu'à ce que l'onglet Grille s'affiche. Choisissez l'onglet. Des cellules-guides apparaissent en haut et sur le côté gauche de la grille sélectionnée.
- Cliquez avec le bouton droit de la souris sur la cellule-guide au-dessus de la première colonne, puis choisissez Insérer->Colonne à droite, comme indiqué dans la figure 13-36.
Figure 13-36 Insertion d'une colonne
Une nouvelle colonne apparaît entre la première colonne et la troisième colonne. Par défaut, BIRT Report Designer crée des colonnes de même largeur.
- Sélectionnez la colonne que vous avez ajoutée, et utilisez l'éditeur de propriétés pour définir la largeur 0,4 pouce pour la colonne, comme indiqué dans la figure 13-37.
Figure 13-37 Définition d'une largeur de colonne
La largeur de la deuxième colonne diminue.
- Prévisualisez le rapport.
Il existe plus d'espace entre les tables des commandes et de paiements, comme indiqué dans la
figure 13-38.
Figure 13-38 : Prévisualisation du rapport montrant l'espace ajouté entre les tables
Ajout de bordures autour des tables
Dans cette procédure, vous allez ajouter un cadre autour des tables des commandes et des paiements pour les identifier clairement sous forme de deux sous-rapports distincts.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Sélectionnez la table des commandes. Placez le pointeur de la souris dans l'angle inférieur gauche jusqu'à ce que l'onglet Liste s'affiche. Choisissez l'onglet. Des cellules-guides apparaissent en haut et sur le côté gauche de la table sélectionnée.
- Choisissez Bordure dans l'éditeur des propriétés, puis définissez les propriétés de la bordure :
- Définissez un trait plein comme style.
- Choisissez tous les boutons pour ajouter des bordures autour de la table, comme indiqué dans la figure 13-39.
Figure 13-39 : Ajout de bordures à une table
- Répétez les étapes précédentes pour tracer une bordure autour de la table des paiements.
- Prévisualisez le rapport. Le rapport doit être identique à celui indiqué dans la figure 13-40.
Figure 13-40 : Bordures autour des tables dans l'aperçu de rapport
Augmentation de l'espace entre les bordures des tables et le contenu
Les bordures supérieure et inférieure des tables sont trop près du contenu des tables. Dans cette procédure, vous aller augmenter l'espace entre les bordures supérieure et gauche et le contenu.
- Choisissez Présentation pour revenir à l'éditeur de présentation.
- Sélectionnez la première cellule dans la ligne d'en-tête de groupe de la table des commandes. Veillez à sélectionner la cellule,comme indiqué dans la figure 13-41, et non pas l'élément de données dans la cellule.
Figure 13-41 : Sélection d'une cellule
Le titre qui apparaît dans l'éditeur des propriétés indique le nom de l'élément sélectionné. Vérifiez qu'il affiche le texte suivant :
- Choisissez les propriétés de remplissage dans l'éditeur des propriétés, puis définissez 6 points pour la haut et pour la gauche.
Figure 13-42 : Propriétés de remplissage des cellules dans l'éditeur des propriétés
Dans l'éditeur de présentation, de l'espace a été ajouté en haut et à gauche de la cellule, comme indiqué dans la
figure 13-43.
Figure 13-43 : Remplissage de cellules dans la conception de rapport
- Sélectionnez la cellule située à côté de la cellule qui vous venez de formater, et définissez la valeur 6 points pour les propriétés de remplissage en haut et à gauche.
- Sélectionnez les deux cellules dans la ligne de détail, et définissez la valeur 6 points pour les propriétés de remplissage de gauche.
- Sélectionnez les cellules qui se trouvent dans les mêmes positions dans la table des paiements, et appliquez les paramètres que vous avez utilisés pour les cellules de la table des commandes.
- Prévisualisez le rapport. Le rapport doit être identique à celui de la figure 13-44.
Figure 13-44 : L'aperçu de rapport montre l'espace ajouté dans les tables


|