Avant de pouvoir utiliser l'API CM, vous devez ajouter des fichiers à votre chemin d'accès aux classes et disposer d'une version sous licence du produit Rational installé.
L'API CM 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 CM qui sont
installés sur votre système lorsque vous installez le produit Rational
dans votre chemin d'accès aux classes.
Les fichiers de l'API CM requis pour utiliser les ressources Rational ClearQuest incluent les fichiers qui sont
requis pour tous les types de ressource de l'API CM ainsi que les fichiers qui sont requis
pour les ressources Rational ClearQuest.
Ces packages Java™ sont requis pour effectuer des opérations Rational ClearQuest à l'aide de l'API CM Rational.
- 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 CM Rational 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 Rational 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 le code dans ce document au format Java compilable, il n'a pas été compilé et peut contenir des erreurs typographiques qui l'empêchent d'être compilé. 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 CM Rational.
Le fichier JAR de l'API CM Rational
et les autres fichiers JAR requis sont installés par défaut
aux emplacements ci-après.
rép-install représente le répertoire
où les fichiers produit Rational ont été installés.
Par défaut, ce répertoire est
/opt/rational sur
le système UNIX® et sous 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'interface API CM Rational.
- <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
Pour utiliser les fichiers JAR de l'API CM Rational, vous devez ajouter leurs emplacements à votre chemin d'accès aux classes.
Pour accéder à l'API CM Rational
à partir d'un plug-in Eclipse, procédez comme suit :
Vous êtes désormais prêt à commencer à écrire des programmes Java
avec l'API CM Rational.
Vous devez disposer d'une version sous licence et installée de Rational ClearQuest afin d'utiliser l'API CM Rational
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.