Création d'identificateurs URI REST pour afficher des enregistrements

Vous pouvez créer des identificateurs URI REST pour afficher des enregistrements dans votre base de données utilisateur en créant directement des liens vers les enregistrements. L'identificateur URI REST que vous avez créé pour afficher un enregistrement ouvre l'enregistrement plus rapidement que l'identificateur URI REST que vous avez créé pour rechercher un enregistrement. Cela est dû au fait que lorsque vous créez un modèle d'identificateur URI REST pour afficher un enregistrement, vous devez indiquer le type d'enregistrement qui restreint la portée de la recherche.

Pourquoi et quand exécuter cette tâche

Pour créer un identificateur URI REST afin d'afficher un enregistrement, procédez comme suit :

Procédure

  1. 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. L'assistant New REST URI s'ouvre.
  2. Sélectionnez Afficher un enregistrement dans la liste REST URI Type.
  3. Sélectionnez un type d'enregistrement dans la liste Type d'enregistrement.
  4. Facultatif : Pour ajouter des paramètres de connexion Rational ClearQuest Web à l'identificateur URI REST, cochez la case Se connecter automatiquement.
  5. 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, cochez la case Inclure la bannière, l'arbre d'espace de travail et la barre d'outils principale.
  6. Cliquez sur Créer. Le modèle d'identificateur URI REST apparaît dans la zone REST URI Template.
  7. Copiez le modèle dans un éditeur de texte et remplacez par les valeurs appropriées les paramètres fictifs qui sont entourés par deux accolades {{ }}.

    Facultatif : Changez le format par défaut de la requête de ressources de HTML en XML ou ATOM.

  8. Copiez le modèle modifié dans votre application Web ou dans une autre fenêtre de navigateur Web.
  9. 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 d'afficher un enregistrement a été créé à l'aide de l'assistant New REST URI. Dans cet exemple, ALMActivity a été sélectionné comme valeur pour Type d'enregistrement lors de la création de l'identificateur URI REST.

http://HôteServeurCQWeb/cqweb/restapi/VotreConnexion/VotreBdDUtilisateur/RECORD/{{IDenregistrement}}?format=HTML&recordType=ALMActivity&loginId={{IDConnexion}}&password={{MotDePasse}}
Voici la correspondance des variables et paramètres fictifs du modèle :
HôteServeurCQWeb
Adresse Web de votre hôte de serveur ClearQuest Web. 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}}
Paramètre fictif de l'ID d'enregistrement vers lequel vous souhaitez créer un lien.
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 votre ID de connexion.
{{MotDePasse}}
Remplacez ce paramètre fictif par votre mot de passe.

Retour d'informations