Extraction des ressources d'une autre application vers Rational Focal Point

Si une application prend en charge des interfaces API RESTful, vous pouvez vous connecter à celle-ci pour extraire des artefacts et créer des éléments à partir de ces derniers.

Avant de commencer

Pourquoi et quand exécuter cette tâche

Si l'un des ID d'attribut d'application existe dans Rational Focal Point, la méthode GET met à jour les artefacts associés à ces ID d'attribut. Si par exemple vous mappez les ID et utilisez la méthode GET pour la première fois, cette dernière extrait les artefacts de l'application. Si les artefacts sont mis à jour dans cette application et que vous mappez ensuite les mêmes ID et utilisez la méthode GET, cette dernière met à jour les artefacts existants dans Rational Focal Point.

Procédure

  1. Dans Rational Focal Point, ouvrez l'espace de travail 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. Sélectionnez une vue dans laquelle vous souhaitez ajouter la commande d'affichage.
  4. Dans la zone REST Client Connector Name, entrez un nom identifiant la connexion.
  5. Dans Méthode de requête REST, sélectionnez la méthode GET. Pour des informations sur l'utilisation de chaque méthode, voir la rubrique Méthodes prises en charge pour gérer les ressources.
  6. Dans la zone Liste des amis, sélectionnez l'application que vous avez ajoutée en tant qu'ami à Rational Focal Point.
  7. Dans la zone URL de la requête d'application REST, entrez l'URL contenant les artefacts de l'application.
    Conseil : Ouvrez un navigateur Web et entrez l'adresse URL que vous avez utilisée lors de l'ajout de l'application REST 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.
  8. Cliquez sur Connexion.
  9. Si la connexion est établie, cliquez sur Sélectionner pour sélectionner le XPath racine de l'artefact. Vous pouvez restreindre la recherche à un artefact en sélectionnant un XPath approprié. Si la connexion n'est pas établie, vous ne pourrez pas sélectionner le XPath racine.
  10. Pour vous assurer que les artefacts ne sont pas dupliqués, dans la section Mappage d'identification, cliquez sur Ajouter et mappez l'ID d'attribut de Rational Focal Point et d'une autre application. Vous ne pouvez mapper qu'un seul attribut.
  11. Dans la section Mappage d'attributs, cliquez sur Ajouter pour mapper les attributs d'application vers les attributs de 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 Mappage d'identification n'apparaît pas dans la section Mappage d'attribut car cet attribut est mappé en interne et disponible pour les éléments extraits.
    • S'il existe des attributs personnalisés dans l'application à partir de laquelle vous extrayez des artefacts et que vous avez besoin d'un élément spécifique, vous pouvez modifier XPath pour qu'il l'inclue. Par exemple, s'il existe plusieurs attributs personnalisés comme Statut, Priorité et Coût, vous pouvez ajouter [@attribute:name='Status'] après l'entrée de l'attribut personnalisé pour extraire l'attribut Statut. rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute[@attribute:name='Status']/@attribute:literalName
  12. Dans la zone Format de date pris en charge par l'application REST, entrez le format de date utilisé par l'application externe.
  13. Dans la zone Séparateur Focal Point, entrez une valeur de séparateur comme , ou ;. Les éléments MultiChoice et LinkedList sont séparés par le séparateur spécifié.
  14. Dans la section Mappage d'en-tête de requête, cliquez sur Ajouter et entrez le nom et la valeur de l'en-tête. Pour les applications Rational for CLM, les en-têtes sont les suivants :
    Nom d'en-tête Valeur d'en-tête
    Accept application/rdf+xml
    Content-Type application/rdf+xml
    OSLC-Core-Version 2.0
  15. Cliquez sur Enregistrer.

Résultats

Pour vérifier si les artefacts sont extraits de l'application, accédez au menu Afficher et cliquez sur la vue. Sélectionnez le nom du connecteur dans la liste déroulante. Les éléments sont extraits et chargés dans la vue.

Retour d'informations