Avant de pouvoir utiliser l'API CM ClearQuest,
vous devez ajouter des fichiers à votre chemin d'accès aux classes et disposer d'une version sous licence installée de Rational ClearQuest.
L'API est un composant commun destiné à exécuter des opérations
sur les produits Rational. Pour utiliser cette API avec un produit
Rational, ce produit doit être installé
sur votre système. Vous devez également copier les fichiers de l'API qui sont
installés sur votre système lorsque vous installez le produit Rational
dans votre chemin d'accès aux classes.
Les packages Java ci-après
sont requis pour effectuer des opérations Rational ClearQuest à l'aide
de l'API.
- javax.wvcm : le package Workspace versioning and
configuration management (WVCM).
- com.ibm.rational.wvcm.stp : le package Rational software
team est une extension du package WVCM. Ce module contient les interfaces de l'API et fournit le modèle d'objet commun pour les ressources des produits Rational. Ce package est indépendant des limites de référentiel ou d'implémentation spécifiques au produit.
- com.ibm.rational.wvcm.stp.cq : extension spécifique au produit
qui fournit un accès aux bases de données ClearQuest. Ce package contient des fonctions qui fournissent un accès (spécifique au produit) plus complet à la fonctionnalité d'une base de données ClearQuest et à ses ressources sous-jacentes.
Bien que vous devriez pouvoir couper et coller les exemples de code dans ce document au format Java compilable, il n'ont pas été compilés et pourraient contenir des erreurs typographiques qui les empêchent d'être compilés. Les versions complètes et compilables de ces exemples sont disponibles dans le projet Eclipse nommé samples, qui se trouve dans le fichier archive supplémentaire fourni avec la documentation de l'API.
Le fichier JAR de l'API CM ClearQuest
et d'autres fichiers JAR requis sont installés par défaut aux emplacements
suivants, où
rép-install représente le répertoire
dans lequel les fichiers du produit Rational
ont été installés. Par défaut, ce répertoire est /opt/rational
sur le système UNIX® et sur Linux® et C:\Program Files\IBM Rational sur les systèmes Windows®.
- Sur les systèmes Windows :
- <rép-install>/Common/stpwvcm.jar :
Le fichier JAR de l'API CM ClearQuest.
- <rép-install>/Common/stpcmmn.jar : un fichier JAR
d'implémentation commun.
- <rép-install>/ClearQuest/stpcq.jar : extension
du produit ClearQuest.
- <rép-install>/ClearQuest/cqjni.jar : un fichier JAR Rational ClearQuest.
- Sur les systèmes UNIX et Linux :
- <rép-install>/common/stpwvcm.jar
- <rép-install>/common/stpcmmn.jar
- <rép-install>/clearquest/cqweb/lib/stpcq.jar
- <rép-install>/clearquest/cqweb/lib/cqjni.jar
Vous devez ajouter les emplacement su fichier JAR de l'API à votre chemin d'accès aux classes avant de pouvoir utiliser l'API.
Procédez comme suit pour accéder à l'API CM ClearQuest
à partir d'un plug-in Eclipse :
Vous êtes désormais prêt à commencer à écrire des programmes Java avec l'API CM ClearQuest.
Vous devez disposer d'une version sous licence et installée de Rational ClearQuest avant de pouvoir utiliser l'API avec les ressources ClearQuest.
Si vous installez et configurez les fichiers JAR mais que vous n'avez pas le produit correspondant installé, les appels à ce module Java échoueront.