Tâches de l'adaptateur Rational ClearQuest dans in Apache Tomcat

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. Copiez les bibliothèques partagées de Rational ClearQuest à partir des fichiers d'application de Rational ClearQuest :

    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.
  2. Collez les bibliothèques partagées de Rational ClearQuest dans le répertoire Apache Tomcat %CATALINA_HOME%\lib.
  3. icône Linux Si vous utilisez Linux, configurez l'argument JVM générique :
    1. Ouvrez le fichier utilisé pour démarrer le serveur Apache Tomcat. Exemple : %CATALINA_HOME%/bin/startup.sh
    2. Ajoutez la commande suivante à la fin du fichier :
      export JAVA_OPTS="-Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib"
  4. icône Linux Si vous utilisez Linux, configurez la variable d'environnement LD_LIBRARY_PATH :
    1. Si le fichier est utilisé pour démarrer le serveur Apache Tomcat, ajoutez la commande suivante à la fin du fichier :
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
    2. Sauvegardez les modifications apportées au fichier utilisé pour démarrer le serveur Apache Tomcat.
  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