Tâches de l'adaptateur Rational ClearQuest dans WebSphere Application Server

Vous pouvez rendre les bibliothèques partagées de IBM® Rational ClearQuest accessibles à l'application Data Services d'IBM Rational Publishing Engine de sorte que l'API de Rational ClearQuest puisse être utilisée à partir de Rational Publishing Engine.

Avant de commencer

  • Rational ClearQuest doit être installé sur le même ordinateur que votre serveur d'applications.
  • Déployez l'application Data Services et les adaptateurs Reporting Data Services de Rational Publishing Engine.
  • Résolvez les éventuels problèmes d'avertissement du pare-feu et de licence avant de configurer les bibliothèques partagées de Rational ClearQuest.

Procédure

  1. Ajoutez les chemins d'accès aux bibliothèques partagées dans votre installation Rational ClearQuest au noeud WebSphere Application Server sur lequel l'application Data Services de Rational Publishing Engine est déployée :
    1. Dans WebSphere Application Server, cliquez sur Environnement > Bibliothèques partagées.
    2. Pour spécifier le paramètre de portée, sélectionnez l'entrée Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer. RationalPublishingEngineNode01 est le nom par défaut du noeud et RationalPublishingEngineServer, le nom par défaut du serveur.
    3. Pour créer la référence de bibliothèque partagée, cliquez sur Nouveau.
    4. Définissez les valeurs de Nom, Description et ClassPath. Vérifiez que votre chemin d'accès aux classes fait référence à l'emplacement exact des fichiers.
      Tableau 1. Zones de référence de la bibliothèque partagée
      Description Valeurs
      Nom API CM ClearQuest
      Description Bibliothèque partagée de l'adaptateur ClearQuest.
      Chemin d'accès aux classes

      fichiers_application\IBM\RationalSDLC\ClearQuest\cqjni.jar
      fichiers_application\IBM\RationalSDLC\ClearQuest\stpcq.jar
      fichiers_application\IBM\RationalSDLC\Common\stpcmmn.jar
      fichiers_application\IBM\RationalSDLC\Common\stpwvcm.jar

      Remarque : Les valeurs par défaut répertoriées concernent Rational ClearQuest 7.1. Les véritables chemins d'accès à utiliser dépendent de l'emplacement d'installation et de la version de Rational ClearQuest. Vérifiez que vous faites bien référence aux fichiers dans leurs emplacements appropriés. Pour déterminer l'emplacement de votre installation Rational ClearQuest, accédez à IBM Installation Manager en cliquant sur Démarrer > Tous les programmes > IBM Installation Manager > Afficher les packages installés.
    5. Cliquez sur OK et sur Sauvegarder.
  2. Associez les bibliothèques partagées de Rational ClearQuest aux profils de l'application Data Services :
    1. Cliquez sur Serveurs > Serveurs d'applications.
    2. Cliquez sur le serveur sur lequel vous avez déployé l'application Data Services. Le nom du serveur par défaut est RationalPublishingEngineServer.
    3. Cliquez sur Infrastructure du serveur > Gestion des processus et Java > Chargeur de classes.
    4. Pour créer un chargeur de classe pour les bibliothèques partagées, cliquez sur Nouveau > OK.
    5. Pour associer des références de bibliothèque partagée au chargeur de classe, cliquez sur le lien hypertexte du chargeur de classe créé à la sous-étape 2.d.
    6. Pour chaque bibliothèque à associer, cliquez sur Ajouter, sélectionnez la bibliothèque, puis cliquez sur OK.
    7. Cliquez sur Références de bibliothèque partagée.
    8. Pour associer chaque bibliothèque, cliquez sur Ajouter, sélectionnez la bibliothèque, puis cliquez sur OK.
    9. Cliquez sur Sauvegarder.
  3. icône Linux Si vous utilisez Linux, configurez l'argument JVM générique :
    1. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere
    2. Cliquez sur le nom du serveur.
    3. Dans la section Infrastructure du serveur, développez Gestion des processus et Java et cliquez sur Définition des processus.
    4. Cliquez sur Machine virtuelle Java.
    5. Dans la zone Arguments JVM génériques, entrez : Generic JVM arguments -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. Cliquez sur OK.
  4. icône Linux Si vous utilisez Linux, configurez la variable d'environnement LD_LIBRARY_PATH :
    1. Dans la page Définition des processus, cliquez sur Environment Entries, puis sur LD_LIBRARY_PATH.
    2. Entrez un nom et le chemin d'accès de la bibliothèque. Exemple : /opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. Redémarrez l'application Data Services.
  6. Vérifiez que l'adaptateur et les bibliothèques de IBM Rational ClearQuest sont correctement configurés. Entrez l'URL de l'adaptateur Rational ClearQuest dans un navigateur.
    • Entrez http://hôte:port/DataServices/ClearQuest. Si l'installation est correcte, vous pouvez voir une liste des connexions Rational ClearQuest telles qu'elles sont affichées dans l'outil de maintenance de Rational ClearQuest.
    • Entrez http://hôte:port/DataServices/ClearQuest/version. Si l'installation est correcte, vous pouvez voir une liste des bases de données d'utilisateurs de Rational ClearQuest.
    • Entrez http://hôte:port/DataServices/ClearQuest/version/nom_base_de_données. Si l'installation est correcte, vous pouvez voir une liste des requêtes.

Que faire ensuite

Copiez une URL de requête à ajouter à un canevas ou une spécification de document.
Remarque : L'application Data Services ne prend en charge que les requêtes possédant des ensembles de résultats statiques. Les requêtes dynamiques ne sont pas prises en charge.

Exemple

Avec l'URL de la requête All Defects, vous pouvez voir un ensemble de résultats avec le nombre d'occurrences que la requête doit renvoyer pour le client Rational ClearQuest. Chaque résultat est un ID de base de données (DBID) unique pour un type d'enregistrement particulier. Vous pouvez poursuivre ce processus jusqu'à ce que vous obteniez un retour pour les données d'un enregistrement spécifique. Conservez l'URL de la requête pour l'utiliser dans la création de rapports Rational Publishing Engine.

Supprimez les arguments à partir du point d'interrogation compris :

Avant : http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
Après : http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Commentaires