Vous pouvez définir IBM®
Rational ClearQuest
comme source de données dans IBM
Rational Publishing Engine.
Avant de commencer
- Familiarisez-vous avec le service REST de Rational
ClearQuest
et les diverses URL requises pour extraire les données de Rational
ClearQuest
à l'aide de Rational
Publishing Engine.
Voir About the Rational
ClearQuest 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. Rational
Publishing Engine
utilise les services de données de Rational pour reconnaître le schéma et les données de
requête. L'URL pouvant être utilisée pour reconnaître le schéma est la suivante : https://serveur:port/DataServices/ClearQuest.
Voir Ajout d'un schéma de source de données REST avec l'assistant de reconnaissance de schéma.
- 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. Exemple :
https://serveur:port/service/cq/records/defects?metadata=schema.
- Pour les dernières versions de Rational
ClearQuest,
vous pouvez également utiliser la reconnaissance de schéma REST v2 pour créer un schéma
de source de données. Voir Ajout d'un schéma de source de données REST avec l'assistant de reconnaissance de schéma.
Remarque : Avec
la reconnaissance de schéma REST v2, Rational
Publishing Engine
n'a pas besoin des services de données de Rational. Rational
Publishing Engine
peut reconnaître le schéma de Rational
ClearQuest
à l'aide d'une reconnaissance des ressources REST v2 lancée à partir d'une URL ServiceProvider.
Les utilisateurs peuvent obtenir l'URL ServiceProvider en accédant à
l'URL ServiceCatalog de Rational ClearQuest REST v2 (par exemple,
https://serveur:port/context/oslc).
Spécifiez 2.0 pour les en-têtes HTTP OSLC-Core-Version et
application/rdf+xml pour les en-têtes Accept. Dans le résultat renvoyé, vous pouvez
rechercher l'URL ServiceProvider rdf:about.
- Si vous utilisez les API REST v2 pour générer le
document, vous devez fournir une URL de schéma de source de données source au fournisseur de service
plutôt qu'à l'entrée racine. Exemple :
- Incorrect : https://server:port/cqweb/oslc
- Correct : https://server:port/cqweb/oslc/repo/repository/db/schema_repository/
- 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. 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
ClearQuest
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
ClearQuest,
vous pouvez générer un rapport dans divers formats. Lorsque vous générez un rapport, vous
devez être connecté à la source de données. Pour faire référence aux 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.