Création de fichiers de configuration pour la génération de rapports dans Rational Publishing Engine

Avant de générer un rapport, vous devez utiliser l'application Rational Publishing Engine Launcher pour créer un fichier de configuration, également appelé fichier de spécification de document. Ce fichier spécifie les sources de données et les modèles à utiliser pour générer un rapport ainsi que les formats de sortie du rapport. Un fichier de spécification de document a pour extension de nom de fichier .dsx.

Avant de commencer

Dans Rational Publishing Engine Document Studio, vous devez créer un canevas de rapport et importer au moins un schéma de source de données. Un canevas de rapport a pour extension de nom de fichier .dta.

Procédure

  1. Dans Rational Publishing Engine Document Studio, ouvrez la perspective RPE Launcher : en regard de la barre d'outils principale, cliquez sur RPE Launcher.
  2. Si aucune spécification de document n'est ouverte, cliquez sur Fichier > Ouvrir une spécification de document, accédez à un fichier .dsx et cliquez sur Ouvrir. Lorsque vous ouvrez un canevas dans la perspective RPE Studio, une spécification de document par défaut est créée pour ce canevas. Cette spécification de document peut être modifiée ou sauvegardée ou vous pouvez ouvrir un autre fichier de spécification de document.
  3. Dans la vue Spécification de document, dans la hiérarchie de sortie, supprimez les formats de sortie que vous ne souhaitez pas générer : cliquez avec le bouton droit de la souris sur un élément Cible :nom_format et cliquez sur Supprimer la sortie. Bien qu'un seul format soit requis, généralement,t les deux formats HTML et Microsoft Word sont générés.
  4. Configurez les formats de sortie restants : cliquez avec le bouton droit de la souris sur le nom de format et sélectionnez Configurer la sortie. Dans la fenêtre Configurer la sortie HTML qui apparaît, spécifiez le chemin vers le fichier de sortie et toute propriété de sortie supplémentaire. Pour plus d'informations sur la définition de valeurs pour les formats de sortie spécifiques, consultez le lien vers la rubrique de la tâche "Définition de formats de sortie" associée, à la fin de la présente rubrique. Les valeurs que vous indiquez sont affichées dans la vue Propriétés.
    Conseil : Vous pouvez également éditer les valeurs directement dans la vue Propriétés.
  5. Configurez le chemin vers le fichier (.dta) de canevas de rapport : dans la vue Spécification de document, dans la hiérarchie Canevas, développez Canevas et vérifiez le chemin vers le fichier de canevas de rapport. Pour modifier le nom de chemin, cliquez avec le bouton droit de la souris sur le nom de canevas et sélectionnez une option dans le menu contextuel.
  6. Pour chaque canevas, configurez les sources de données associées : dans la hiérarchie Canevas, développez Sources de données, puis cliquez avec le bouton droit de la souris sur un élément Source de données : et cliquez sur Configurer la source de données.

  7. Dans la fenêtre Configurer la source de données, complétez les zones suivantes :
    1. URL : indiquez l'URL de la ressource REST pour laquelle vous générez des rapports. Si vous ne disposez pas de l'URL, cliquez sur Reconnaître pour démarrer l'assistant REST Discovery afin de pouvoir localiser la ressource. Il n'est pas nécessaire de spécifier l'URL pour les sources de données qui sont configurées dynamiquement par le canevas à l'aide du contrôle Data Source Configuration.

      L'URL des sources de données non dynamiques doit spécifier une ou plusieurs ressources Design Management basées sur l'URL de service de génération de rapports Design Management. Cette URL peut également être spécifiée à l'aide de l'assistant de reconnaissance REST dans l'application Rational Publishing Engine Launcher.

    2. Obligatoire : Utilisateur et Mot de passe : vous devez spécifier des données d'identification de connexion pour chaque source de données Design Management, y compris pour les sources de données qui sont configurées dynamiquement au moment de la génération de rapports.

      Si cette spécification de document est partagée avec d'autres utilisateurs, vous pouvez laisser les zones de données d'identification vides. Si vous n'indiquez pas de données d'identification, puis que vous exécutez un rapport à l'aide de la spécification de document, la génération de rapports échoue et affiche une erreur indiquant qu'elle n'a pas pu configurer la source de données.

  8. Cliquez sur la perspective Spécification de document ; cliquez ensuite sur Fichier > Sauvegarder et spécifiez une destination pour la spécification de document.

Exemple

Pour consulter un exemple de création et de configuration d'un fichier de spécification de document, effectuez la leçon 1 du tutoriel de génération de rapports Design Management. Voir le lien associé à la fin de la présente rubrique.

Que faire ensuite

Une fois que vous avez créé un fichier de spécification de document, vous pouvez générer des rapports Design Management.

Commentaires