Paramètres dans les fichiers EMF et UML

Vous pouvez définir des paramètres dans les fichiers EMF et UML, les utiliser dans des requêtes sur les fichiers pour le mappage de ligne et le mappage de colonne, et y lier des valeurs pour les utiliser dans la conception de rapport. Vous pouvez utiliser des paramètres pour créer des variations dans des fichiers génériques, et éviter ainsi de créer plusieurs fichiers qui sont pratiquement identiques les uns aux autres. Vous pouvez également utiliser des paramètres pour joindre des objets.

Utilisation de paramètres pour créer des variations dans des fichiers génériques

Vous pouvez utiliser des paramètres lorsque vous avez besoin de plusieurs fichiers qui sont identiques à l'exception d'une légère variation. Pour éviter de créer plusieurs fichiers, vous pouvez créer un seul fichier qui utilise un paramètre pour représenter la variation, et lier le paramètre à la valeur modifiée.

Par exemple, au lieu d'avoir un fichier qui reçoit toutes les classes des packages appelée A et une autre qui reçoit toutes les classes des packages appelée B, vous pouvez créer un seul fichier qui reçoit toutes les classes des packages appelée $nom. Vous pouvez ensuite lier $nom à A et à B. Ceci rend vos fichiers plus concis et plus réutilisables.

Pour plus d'informations sur l'utilisation de paramètres et sur la liaison de valeurs aux paramètres, consultez le Guide pratique de BIRT.

Utilisation de paramètres pour joindre des objets

Vous pouvez utiliser des paramètres pour joindre des objets dans des fichiers lorsque vous concevez des rapports pour des modèles EMF et UML. Selon la relation entre les objets, vous pouvez utiliser une clé pour joindre les objets ; lorsque vous ne pouvez pas utiliser une clé, vous pouvez définir un paramètre pour joindre les objets. Cependant, vous pouvez aussi utiliser des paramètres alors même qu'une clé fonctionnerait.

Objets que vous pouvez joindre sans paramètres

Il n'est pas nécessaire de créer des paramètres pour joindre des objets dans les situations suivantes :

Objets requérant des paramètres lorsque vous les joignez

Il faut des paramètres pour joindre des objets dans les situations suivantes :
  • Relations qui ont une multiplicité 1–à-*, où l'extrémité avec une multiplicité de 1 n'est pas navigable
    " "
  • Relations qui ont une multiplicité *-à-*
    “ "

Des paramètres sont nécessaires dans ces situations car les fichiers EMF et UML ne prennent pas en charge les colonnes avec une multiplicité supérieure à 1. Cela signifie que vous ne pouvez pas représenter une extrémité navigable avec une multiplicité de * à l'aide d'une colonne dans un fichier qui représente l'autre extrémité de la relation. Ces types de relations sont très courantes dans les modèles EMF et UML.

Conseils pour les jointures d'objets

Vous pouvez utiliser des paramètres dans un fichier pour joindre deux objets qui sont liés par un type quelconque de relations dans le modèle. Pour utiliser des paramètres pour joindre des objets, vous définissez un fichier qui représente une extrémité navigable d'une relation, et vous définissez pour celui-ci un paramètre qui représente l'objet à l'autre extrémité de la relation. Ensuite, dans la requête de mappage de ligne, vous utilisez ce paramètre comme contexte pour naviguer à partir de celui-ci vers les objets qui représentent les lignes du fichier.

Par exemple, dans un fichier qui représente la classe Y, vous pouvez définir un paramètre $X qui représente un objet de la classe X, puis spécifier sa requête de mappage de ligne sous la forme de l'expression XPath $X\y. De cette façon, le fichier représente les objets de type Y qui sont liés d'une façon spécifique à un objet de contexte de type X.

Les paramètres de fichier sont typés avec un des types parmi les types scalaires pris en charge par BIRT (Business Intelligence Reporting Tools). Par exemple, vous pouvez définir un paramètre de type chaîne $nom, puis écrire l'expressions XPath de mappage de ligne suivante : Class->ownedAttribute[@name=$nom].

Les paramètres d'objet peuvent être représentés par un ID scalaire que vous pouvez utiliser pour résoudre l'objet. Dans les modèles EMF et UML, l'ID unique d'un objet est son identificateur URI codé en tant que chaîne. Par conséquent, vous sélectionnez chaîne comme type pour les paramètres d'URI et vous les liez aux colonnes d'URI d'objet lors de l'exécution.

Définition des paramètres

Pour des informations sur la définition des paramètres lorsque vous créez un fichier, consultez la rubrique "Création de fichiers EMF" et "Création de fichiers UML".

Vous pouvez aussi ajouter des paramètres à des fichiers existants. Dans l'Editeur de fichiers, vous commencez par la page Paramètres de requête (et non pas par la page Paramètres) pour définir des paramètres pour les requêtes de fichier EMF et UML. Vous utilisez les deux pages comme suit :
  • Utilisez la page Paramètres de requête 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.
  • Utilisez la page Paramètres pour procéder à la définition du paramètre. 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.

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 ($). Lorsque vous liez des valeurs à un paramètre du fichier sur la page Liaison de données, vous utilisez le nom d'affichage du paramètre.

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.

Vos commentaires