Un fichier Eclipse Modeling Framework (EMF) est une base de données en format tabulaire
dont les lignes et les colonnes sont mappées avec une source de données EMF. Le fichier est formaté de façon à pouvoir utiliser BIRT (Business Intelligence and Reporting Tools) pour générer un rapport sur ces données.
Avant de commencer
La source de données doit exister avant le lancement de cette tâche. Pour créer une nouvelle source de données, reportez-vous à la tâche associée nommée "Création de sources de données EMF".
Procédure
- Ouvrez la vue Explorateur de rapports. Cliquez sur .
- Dans la vue Explorateur de rapports, cliquez avec le bouton droit sur
une conception de rapport, puis cliquez sur Ouvrir.
- Ouvrez la vue Explorateur de données. Cliquez sur .
- Dans la vue Explorateur de données, cliquez avec le bouton droit sur Fichiers, puis cliquez sur Nouveau fichier.
Si vous voulez joindre les données de plusieurs
tables, vous pouvez aussi cliquer
sur Nouveau fichier de jointure. Pour plus de détails, consultez la rubrique "Comment joindre des données" dans le Guide pratique de BIRT.
- Saisissez un nom pour le fichier, sélectionnez le type Fichier EMF, sélectionnez une source de données, puis cliquez sur Suivant.
- Sur la page Paramètres de requête, établissez la liste de tous les paramètres de requête nécessaires pour définir des requêtes dans le fichier, puis cliquez sur Suivant. Utilisez cette page pour ajouter, supprimer, réorganiser et renommer des paramètres. Les paramètres de cette page sont identifiés par le nom interne du paramètre. Le nom interne est le nom que vous utilisez dans les expressions XPath ; il doit donc être conforme aux conventions d'attribution de nom XPath pour les variables ; il doit commencer par une lettre ou un trait de soulignement (_), et il peut contenir toute séquence de lettres, chiffres ou caractères de trait de soulignement. Les modifications que vous apportez sur cette page apparaissent également sur la page Paramètres ; voir l'étape 10.
Les paramètres constituent un outil souple et puissant, qui vous permet d'inclure de nombreux types spéciaux d'informations dans les rapports. Pour des informations sur l'utilisation des paramètres, reportez-vous au concept associé nommé "Paramètres dans les fichiers EMF et UML".
Remarque : Après avoir défini un paramètre, vous pouvez y faire référence dans les requêtes de mappage de ligne et dans les requêtes de mappage de colonne en utilisant son nom interne précédé d'un signe dollar ($).
- Définissez le mappage de ligne pour le fichier. Vous définissez une collection d'éléments qui forment les lignes d'une table et qui spécifient les types des éléments. Pour définir le mappage de ligne, procédez selon les étapes suivantes :
- Sélectionnez un des modèles spécifiés dans la source de données que vous utilisez.
- Pour définir le mappage de ligne, spécifiez une expression XPath. Par exemple, pour mapper toutes les classes du modèle, l'expression serait //Class et le type serait Class.
Remarque : Lorsque vous écrivez des expressions XPath de mappage de ligne, n'oubliez pas que la racine
est l'instance de ressource. Pour de plus amples informations sur la syntaxe
XPath, reportez-vous aux liens à la fin de cette rubrique.
Vous pouvez taper l'expression directement, ou bien la créer à partir d'éléments de la structure EMF, que vous ajoutez à la zone Expression en sélectionnant un noeud dans la structure EMF et en cliquant sur le bouton avec une flèche droite (>).
- Si l'expression commence avec un paramètre en tant que contexte, et non pas avec la racine de la ressource, vous pouvez décocher la case pour Evaluer pour chaque modèle d'instance de source de données. Ceci peut améliorer les performances, car l'expression ne doit pas s'exécuter pour chacune des ressources.
- Sélectionnez un élément de la structure EMF qui a le type requis pour l'expression XPath, puis cliquez sur le bouton avec la flèche droite (>) pour la zone Type. Par exemple, pour //Class, le type de résultat est Class.
- Cliquez sur
Suivant.
- Définissez les colonnes de votre fichier. Dans les expressions XPath de définition des colonnes, la racine est un objet du type que vous avez indiqué à l'étape précédente. Vous pouvez définir les colonnes soit en saisissant leurs valeurs directement dans la matrice, soit en effectuant les étapes suivantes :
- Cliquez sur Parcourir pour afficher un type à explorer.
- Sélectionnez dans l'arborescence une entrée à utiliser comme colonne de table, puis cliquez sur la flèche droite (>).
- Indiquez toutes les colonnes dont vous avez besoin. Vous pouvez supprimer des colonnes ou changer leur ordre en utilisant les boutons à droite de la matrice de mappage de table.
- Ajustez les valeurs de Requête et de Type de façon appropriée pour chaque colonne.
- Une fois la configuration de la table terminée, cliquez sur Terminer. La fenêtre Modifier le fichier s'ouvre.
- Si le fichier inclut des paramètres, utilisez la page Paramètres de la fenêtre Modifier le fichier pour compléter la définition des paramètres. Spécifiez le nom d'affichage, qui est initialement défini avec le nom interne, le type, qui est initialement défini à Chaîne, le sens, qui est initialement défini à Entrée et le nom du paramètre du rapport (le cas échéant) pour effectuer la liaison avec le paramètre du fichier. Lorsque vous liez des valeurs à un paramètre du fichier sur la page Liaison de propriété, vous utilisez le nom d'affichage du paramètre.
- Vous pouvez continuer l'édition, cliquer sur Aperçu des résultats pour vérifier votre travail, ou bien cliquer sur OK pour fermer la fenêtre.
Remarque : Vous pouvez à tout moment modifier votre fichier en cliquant avec le bouton droit sur le fichier dans l'Explorateur de données, puis en cliquant sur Modifier.
Que faire ensuite
Vous pouvez maintenant utiliser la fonction BIRT pour finaliser la conception du rapport, en y incorporant des éléments du fichier. Pour plus d'informations, voir le
Guide pratique de BIRT.
Remarque : Certaines informations, telles que les liens d'accès à la documentation Eclipse ou aux guides de développement, sont disponibles uniquement depuis
les rubriques d'aide installées avec le produit.