Création de documents de traçabilité à partir des applications CLM à l'aide du profil POX

Il est maintenant plus facile que jamais de créer des documents de traçabilité à partir des applications CLM. Vous pouvez configurer des adresses URL OSLC pour renvoyer des données de représentation REST pouvant faire l'objet d'un rapport si un en-tête spécial est inclus dans la demande à l'aide de POX (Plain Old XML).

Avant de commencer

Vous devez avoir installé Rational Publishing Engine 2.1.0 ou version ultérieure et Rational solution for CLM 6.0.2 ou version ultérieure.

Pourquoi et quand exécuter cette tâche

Auparavant, il était difficile de créer des documents de traçabilité car certaines applications, par exemple Rational Quality Manager et Rational Team Concert utilisent des URL OSLC et Rational Publishing Engine requiert des URL REST pouvant faire l'objet d'un rapport. Il s'agissait d'une conception de modèle compliquée car les URL devaient être converties d'OSLC en REST pouvant faire l'objet d'un rapport. Il est possible que la représentation OSLC d'un artefact ne contienne pas suffisamment d'informations requises pour la génération de document, par exemple du texte enrichi.

Le profil POX vous permet d'utiliser des URL OSLC comme si elles étaient des API REST pouvant faire l'objet d'un rapport. Vous pouvez utiliser le profil POX dans Rational Publishing Engine pour demander et recevoir directement des données REST pouvant faire l'objet d'un rapport en fournissant un en-tête supplémentaire. Vous n'avez plus besoin de convertir les URL ou d'effectuer des demandes en double. Le service de génération de document va retourner le fichier XML supplémentaire en présence de l'en-tête.

Exemple: Création d'un document de traçabilité de Rational DOORS Next Generation dans Design Management

Procédure

  1. Dans Document Studio, ajoutez un schéma Rational DOORS Next Generation.
  2. Créez des éléments de canevas pour imprimer les informations issues d'un artefact.
    Elément DNG
  3. Itérez les informations de lien dans l'exigence.
    Lien DNG
  4. Dans Design Management, copiez l'URL de l'artefact en cliquant sur l'icône Afficher le lien permanent dans l'élément de navigation.
  5. Dans Document Studio, ouvrez l'assistant Ajouter un schéma de source de données.
  6. (Nouveau) Collez l'URL dans la zone Schéma et ajoutez &metadata=schema à la fin de l'URL.
  7. (Nouveau) Dans la zone En-têtes supplémentaires, sélectionnez l'en-tête de profil POX.
    Ajout d'un schéma DM avec le profil POX
  8. Cliquez sur Suivant, puis sur Terminer.
  9. Dans votre canevas, créez des éléments de canevas qui suivent le lien vers Rational DOORS Next Generation. Ouvrez la configuration de source de données dans la vue Propriétés et cliquez sur l'onglet Configuration dynamique :
    1. (Nouveau) Dans la zone URI, entrez l'élément href à partir de Rational DOORS Next Generation.
    2. (Nouveau) Dans la zone En-tête Accept, entrez application/xml.
    3. (Nouveau) Dans la zone En-têtes supplémentaires, sélectionnez le lien de profil POX. La zone En-têtes supplémentaires indique à l'application qu'elle doit répondre avec des informations REST pour lesquelles un rapport est possible, même si une URL OSLC est utilisée.
      Configuration de la source de données pour le profil POX
  10. Créez des éléments de canevas pour imprimer les informations Design Management.
    Elément DM
  11. Basculez sur RPE Launcher pour générer le document.
  12. Dans la vue Spécification de document, cliquez avec le bouton droit de la souris sur la source de données Rational DOORS Next Generation et sélectionnez Configurer la source de données.
    1. URL : Entrez l'adresse URL du lien permanent à partir de Rational DOORS Next Generation.
    2. Si nécessaire, entrez un nom d'utilisateur et un mot de passe.
    3. Authentification : Sélectionnez OAuth.
    4. En-tête Accept : Entrez application/xml.
    5. (Nouveau) En-têtes supplémentaires : Sélectionnez le lien de profil POX pour demander des données REST pouvant faire l'objet d'un rapport à partir de Rational DOORS Next Generation.
  13. Dans la barre d'outils principale, cliquez sur Générer le document. Dans la vue Console, vous pouvez voir que Rational Publishing Engine demande des données à Design Management et à Rational DOORS Next Generation à l'aide des URL OSLC. Design Management et Rational DOORS Next Generation se redirigent vers les URL REST pouvant faire l'objet d'un rapport. Le document de sortie contient les conditions requises de Rational DOORS Next Generation et les données de modèle associées de Design Management.
    Résultat affichant les données DNG et les données DM