Exemple : Extraction d'artefacts à partir d'applications prenant en charge l'interface API RESTful

Cet exemple indique comment extraire des artefacts de l'application Requirements Management d'solution Rational for Collaborative Lifecycle Management et créer des éléments dans IBM® Rational Focal Point.

Fonction

S'il existe des exigences dans l'application Requirements Management que vous souhaitez les hiérarchiser dans Rational Focal Point, vous pouvez utiliser la Commande d'affichage du client REST pour les extraire.
Prérequis :
  • Définissez l'adresse IP et le nom d'hôte du serveur Rational for CLM dans le fichier hôte de l'ordinateur à partir duquel vous configurez l'intégration. Pour Windows, le fichier hôte se trouve généralement dans C:\Windows\System32\drivers\etc et pour Linux dans /etc/hosts.
  • Ajoutez l'application Requirements Management en tant qu'Amis (sortants) dans Rational Focal Point. Pour plus d'informations, voir Connexion à la solution Rational pour le serveur d'applications Collaborative Lifecycle Management.
  • Prenez en compte la structure XML des artefacts de l'application Requirements Management et vérifiez que vous êtes autorisé à y accéder.

Exemple

Cet exemple suppose que Rational Focal Point comporte un espace de travail FP-RRC et une vue View RRC Requirements. Le tableau présente certains des attributs disponibles dans Rational Focal Point et l'application Requirements Management.
Tableau 1. Attributs de Rational Focal Point et de l'application Requirements Management
Attributs Rational Focal Point Attributs de l'application Requirements Management
Fuel choice rrm:description
Fuel efficiency rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Integration Link rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Title ds:location/ds:project/rrm:title
  1. Dans Rational Focal Point, ouvrez l'espace de travail FP-RRC dans lequel vous voulez extraire les artefacts.
  2. Cliquez sur Configurer > Commande d'affichage du client REST et cliquez sur Ajouter une commande d'affichage.
  3. Dans REST Client Connector Name, entrez un RRC connector afin d'identifier la connexion.
  4. Dans Méthode de requête REST, sélectionnez la méthode GET.
  5. Dans Liste des amis, sélectionnez RRC.
  6. Dans URL de la requête d'application REST, entrez l'adresse URL de l'application qui contient les artefacts que vous voulez récupérer. Par exemple, pour obtenir les artefacts à partir de l'application Requirements Management, entrez https://<hostName>:<portNumber>/rm/<projectName>/<collectionName>
    Conseil : Ouvrez un navigateur Web et entrez l'adresse URL que vous avez utilisée lors de l'ajout de l'application Requirements Management en tant qu'ami. Une liste d'artefacts de haut niveau s'affiche. Recherchez l'artefact que vous voulez récupérer et copiez son adresse URL dans URL de la requête d'application REST.
  7. Cliquez sur Connexion.
  8. Cliquez sur Sélectionner XPath racine pour restreindre la recherche d'artefacts à une collection. Sélectionnez /ds:dataSource/ds:artifact. XPath est utilisé pour restreindre la recherche d'artefacts. Les XPath constituent la structure XML hiérarchique d'une application.
  9. Pour vous assurer que les artefacts ne sont pas dupliqués, dans la section ID Mapping, cliquez sur Add et mappez l'attribut Fuel choice de Rational Focal Point et l'attribut rrm:description de l'application Requirements Management. Vous ne pouvez mapper qu'un seul attribut.
  10. Dans la section Mappage d'attribut, cliquez sur Ajouter pour mapper les attributs suivants entre l'application Requirements Management et Rational Focal Point. Les attributs mappés s'affichent par rapport à l'élément extrait de l'application. Vérifiez que les attributs sont modifiables.
    Remarque : L'attribut que vous avez sélectionné dans la section ID Mapping n'apparaît pas dans la section Mappage d'attribut car cet attribut est mappé en interne et disponible pour les éléments extraits.
    Tableau 2. Mappez les attributs entre Rational Focal Point et l'application Requirements Management
    Attributs Rational Focal Point Attributs de l'application Requirements Management
    Fuel efficiency rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Integration Link rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Title ds:location/ds:project/rrm:title
  11. Dans la zone Format de date pris en charge par l'application REST, entrez 2012-08-18.
  12. Dans la zone Séparateur Focal Point, conservez , tel quel.
  13. Cliquez sur Sauvegarder.
  14. Ouvrez la vue View RRC Requirements et sélectionnez RRC Connector dans la liste déroulante. Une liste des exigences et des attributs sont extraits et créés en tant qu'éléments de la vue.

Retour d'informations