Vous pouvez définir IBM® Rational Change comme source de données dans IBM
Rational Publishing Engine.
Conseil : L'installation de
Rational
Publishing Engine
inclut un ensemble d'exemples de rapport. Avant de commencer à publier des documents,
vous pouvez explorer cet exemple de scénario de génération de documents. Voir
Création de l'exemple de canevas REST.
Avant de commencer
- Familiarisez-vous avec le service REST de Rational Change et les diverses URL requises pour extraire les données
de Rational Change à l'aide de Rational
Publishing Engine.
Pour rechercher le centre de documentation de votre version de Rational Change, voir About the Rational Change
information center.
- Connectez-vous à un schéma de source de données. Voir Ajout d'un schéma de source de données.
- Le schéma peut se trouver sur le système de fichiers local. Par exemple, https://serveur:port/ibm/report/com.ibm.change.project.artifacts.xsd
est un fichier de schéma qui utilise l'argument artifacts. Vous pouvez
utiliser ce schéma pour ajouter des éléments de données spécifiques de votre projet Rational Change.
- Le schéma peut correspondre à toute URI accessible à partir de l'ordinateur. Vous
pouvez créer une URL qui pointe vers le schéma de source de données. Ouvrez votre schéma
de source de données et, à partir du fichier XML, prenez l'URI d'une ressource
particulière. Ajoutez ?metadata=schema à la fin de l'URI. Par exemple :
https://serveur:port/ibm/report/com.ibm.change.project.artifacts.xsd
- Vous pouvez utiliser les éléments du schéma de source de données pour ajouter des
requêtes dans votre canevas. Ces requêtes précisent
que les éléments d'informations sont générés en dernier lieu dans le rapport.
- Une fois que vous vous êtes connecté au schéma de source de données, vous pouvez
créer ou importer une conception de canevas. Avec Rational
Publishing Engine
Document Studio, vous pouvez générer une conception de canevas de rapport. Cette
conception détermine la présentation du rapport. Voir Création de canevas avec Document Studio.
- Planifiez la structure de votre document et définissez le contenu pour extraire les
données. Pour un aperçu du processus de développement de canevas, voir Conception de canevas de document. Pour les documents de grande taille, vous pouvez créer des canevas distincts pour chaque
bloc de document.
- Vous pouvez utiliser des filtres, qui sont des versions plus spécifiques de
l'identificateur URI de source de données générale, pour pointer vers des sous-ensembles
plus spécifiques de données, de sorte que Rational
Publishing Engine
ne tente pas d'extraire plus informations que nécessaire du référentiel Rational Change
lors de la génération de rapport. Ces filtres doivent être suffisamment larges pour
extraire toutes les données nécessaires référencées par le canevas. Sinon, le rapport
généré inclut l'ensemble de données complet. Voir Extraction de
données à l'aide de filtres natifs.
- Une fois que vous avez créé le canevas de rapport et que vous l'avez alimenté avec
des points de données Rational Change,
vous pouvez générer un rapport dans divers formats. Lorsque vous générez un rapport, vous
devez vous connecter à la source de données en spécifiant une URI qui pointe vers le
référentiel Rational Change
qui contient les données appropriées. Voir Connexion à une source de données.
- Si des schémas de source de données sont ajoutés à un canevas une fois que
ce dernier a été affecté à une spécification de document, la spécification de document
n'est plus synchronisée. Vous pouvez synchroniser
manuellement la spécification de document ou sélectionner une option de préférence
pour synchroniser automatiquement la spécification de document avec le canevas actuel. Pour plus d'informations sur la manière de définir la préférence Conserver la
synchronisation entre le document et le canevas en cours ?, voir Définition des préférences de conception de document.
- Avant de publier votre document, reportez-vous à la rubrique Spécification des propriétés de sortie, pour plus
d'informations sur les options de sortie disponibles que vous pouvez choisir et pour
déterminer celle qu'il convient d'utiliser pour les éléments que vous utilisez dans votre
canevas.
- Vous êtes maintenant prêt à publier votre document. Voir Génération d'un document.