Si une application prend en charge des interfaces API RESTful, vous pouvez créer des artefacts dans cette application à partir des besoins métier dans IBM® Rational Focal Point.
Par exemple, vous pouvez créer des exigences dans l'application Requirements Management d'solution Rational for
Collaborative Lifecycle Management à partir des besoins métier dans Rational Focal Point.
Avant de commencer
- Vérifiez que vous disposez d'un droit d'accès approprié à l'application dans laquelle vous créez des artefacts à partir de Rational Focal Point.
- Ajoutez l'application en tant qu'ami sortant dans Rational Focal Point.
Pour plus d'informations, voir Connexion à la solution Rational pour le serveur d'applications Collaborative Lifecycle Management.
- Vérifiez que le contenu de l'application qui prend en charge les interfaces API REST est au format XML.
- Prenez en compte la structure XML des artefacts de l'application et vérifiez que vous êtes autorisé à y accéder.
Procédure
- Dans Rational Focal Point,
ouvrez l'espace de travail.
- Cliquez sur et cliquez sur Ajouter une commande d'affichage.
- Sélectionnez une vue dans laquelle vous souhaitez ajouter la commande d'affichage.
- Dans la section Configuration de la commande du client REST, exécutez les opérations suivantes :
- Dans la zone REST Client Connector Name, entrez un nom identifiant la connexion.
- Dans la zone Méthode de requête REST, sélectionnez la méthode POST. Pour obtenir des informations sur l'utilisation de chaque méthode, voir la rubrique "Méthodes prises en charge pour gérer les ressources".
- Dans la zone Liste des amis, sélectionnez l'application que vous avez ajoutée en tant qu'ami à Rational Focal Point.
- Dans la zone Choisir l'attribut unique vers POST, cliquez sur Sélectionner et sélectionnez un attribut. Cet attribut est vide. Après la première opération POST, il stocke l'adresse URL de la réponse à partir de l'application. Ainsi, pour les opérations POST ultérieures, si l'adresse URL est la même, l'opération POST ne se produit pas pour cette URL.
- Dans la zone URL de la requête d'application REST, entrez l'URL de niveau supérieur de la zone dans l'application dans laquelle vous créez des artefacts. Par exemple, pour l'application Requirements Management, utilisez l'URL de la fabrique de création des exigences. Pour obtenir cette URL, vous utilisez généralement l'URL des services racine pour obtenir l'URL RMCatalog. Vous utilisez l'URL RMCatalog pour obtenir l'URL de la zone de projet. Vous utilisez ensuite l'URL de la zone de projet pour obtenir l'URL de la fabrique des exigences.
- Dans la section Configuration XML du canevas du client REST, exécutez les opérations suivantes :
- Dans la zone URL de l'application REST sur le XML du canevas, entrez l'URL qui pointe vers un artefact dans l'application et cliquez sur Extraction du code XML du canevas. Le chargement du XML s'effectue dans la zone de texte XML du canevas de l'application REST. Si vous ne souhaitez pas que le XML se charge dynamiquement, vous pouvez le copier dans la zone de texte XML du canevas de l'application REST.
Remarque : Pour l'opération POST, vous devez connaître la structure XML de l'application dans laquelle vous soumettez des artefacts. Vous obtenez ainsi le XML de manière dynamique ou manuelle. Une fois le code obtenu, cet XML doit prendre en charge la soumission de nouvelles données à l'application. Dans certaines applications, si le XML n'assure pas cette prise en charge, vous devez le créer ou le modifier manuellement.
- Dans la zone XPath racine sur l'artefact d'application REST, cliquez sur Sélectionner et sélectionnez le XPath racine des attributs. Le bouton Sélectionner est activé uniquement si le XML dans la zone XML du canevas de l'application REST est correct.
- Dans la section Mappage d'attribut, cliquez sur Ajouter et mappez les attributs Rational Focal Point vers les attributs de l'application. Par exemple, si vous mappez l'attribut Titre de Rational Focal Point vers l'attribut Nom de l'application, après l'opération POST, l'attribut Nom dans l'application est remplacé par Titre.
- Dans la section Réponses, exécutez les procédures suivantes :
- Dans la zone XML du canevas de l'application REST, spécifiez le XML qui est reçu en réponse à la méthode GET ou tout autre XML de l'application. Dans la zone XPath racine sur l'artefact d'application REST, spécifiez le XPath racine des attributs, puis dans la zone Mappage d'attribut de réponse, cliquez sur Ajouter pour mapper les attributs.
- Dans la section Mappage d'en-tête de réponse, cliquez sur Ajouter pour mapper l'en-tête d'application vers l'attribut Rational Focal Point. L'en-tête de l'application stocke le XML de cette application. Généralement, l'en-tête des applications Rational for CLM est Emplacement.
- Dans la section Configuration, exécutez les opérations suivantes :
- Dans la zone Format de date pris en charge par l'application REST, entrez le format de date utilisé par l'application externe.
- Dans la zone Séparateur Focal Point, entrez une valeur de séparateur comme une virgule (,) ou un point-virgule (;). Les éléments MultiChoice et LinkedList sont séparés par le séparateur spécifié.
- Pour mapper les ID des attributs entre Rational Focal Point et l'application, dans la section Demande de la table de paramètres, cliquez sur Ajouter et sélectionnez un attribut Rational Focal Point.
Entrez l'ID de l'application dans la colonne Clé. Par exemple, si vous sélectionnez ID de projet pour Rational Focal Point,
dans la colonne Clé, entrez l'ID utilisé pour l'ID de projet dans l'application.
- 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 de l'en-tête |
Valeur de l'en-tête |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- Cliquez sur Enregistrer.
- Dans le menu Afficher, sélectionnez la vue contenant les éléments que vous voulez créer dans l'autre application.
- Pour créer tous les artefacts disponibles dans la vue, à partir de la barre d'outils, cliquez sur la liste déroulante et sélectionnez la commande d'affichage POST et cliquez ensuite sur l'icône Lancer
.
- Pour créer un artefact, à partir de la barre d'outils d'artefacts, sélectionnez la commande d'affichage POST et cliquez ensuite sur l'icône Lancer
.