Vous pouvez créer des identificateurs URI REST pour rechercher des enregistrements dans votre base de données utilisateur en créant directement des liens vers les enregistrements.
Pourquoi et quand exécuter cette tâche
Pour créer un identificateur URI REST afin de rechercher
un enregistrement :
Procédure
- Dans la barre d'outils Rational ClearQuest Web, cliquez sur la flèche en regard de New Change Request
et sélectionnez New REST URI. La fenêtre New REST URI template s'ouvre.
- Sélectionnez Rechercher un enregistrement dans la liste REST
URI Type.
- Facultatif : Pour ajouter des paramètres de connexion Rational ClearQuest Web
à votre identificateur URI REST, sélectionnez Se connecter automatiquement.
- Facultatif : Pour inclure la bannière, l'arborescence de l'espace de travail et la barre d'outils principale à la fenêtre qui s'ouvre lorsque l'identificateur URI REST s'exécute, sélectionnez Inclure la bannière, l'arborescence de l'espace de travail et la barre d'outils principale.
- Cliquez sur Créer. Le modèle d'identificateur URI
REST apparaît dans la zone REST URI Template.
- Copiez le modèle dans un éditeur de texte et remplacez les paramètres fictifs {{recordId}}, {{loginid}},
et {{password}} par les valeurs appropriées.
Facultatif :
Modifiez le format par défaut de votre requête de ressource de HTML en XML ou en ATOM.
- Copiez le modèle modifié dans votre application Web ou dans une
autre fenêtre de navigateur Web.
- Cliquez sur Réinitialiser pour créer un modèle d'identificateur URI REST
ou sur Fermer pour quitter.
Exemple
Exemple
Le modèle d'identificateur URI REST permettant
de rechercher un enregistrement a été créé à l'aide de l'assistant New REST URI.
http://HôteServeurCQWeb/cqweb/restapi/VotreConnexion/VotreBdDUtilisateur/RECORD/{{IDEnregistrement}}?format=HTML&loginId={{IDConnexion}}&password={{MotDePasse}}
Voici la correspondance des
variables et paramètres fictifs du modèle :
- HôteServeurCQWeb
- Adresse Web de votre système hôte de serveur Web ClearQuest. Cette valeur est définie lors de la création du
modèle d'identificateur URI REST.
- VotreConnexion
- Votre connexion ClearQuest. Cette valeur est définie lors de la création du
modèle d'identificateur URI REST.
- VotreBdDUtilisateur
- Votre base de données utilisateur ClearQuest. Cette valeur est définie lors de la création du
modèle d'identificateur URI REST.
- {{IDenregistrement}}
- Remplacez ce paramètre fictif par l'ID de l'enregistrement à rechercher.
- format
- Le format par défaut de la requête de ressources est HTML.
Vous pouvez changer ce format en XML ou en ATOM,
si vous le souhaitez.
- {{IDConnexion}}
- Remplacez ce paramètre fictif par l'ID de connexion.
- {{MotDePasse}}
- Remplacez ce paramètre fictif par votre mot de passe.