< Précédent | Suivant >

Configuration et installation de l'API CM

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 :

  1. Créez un plug-in Eclipse en utilisant les fichiers situés dans le répertoire \plugins\com.ibm.rational.stp.cmapi du fichier archive %RATIONAL_INSTALL%\common\cm\teamapi.zip.
  2. Pour ajouter le plug-in de l'API CM Rational à votre configuration d'exécution, copiez le plug-in dans votre instance Eclipse ou créez un site d'installation d'extension. Un nouveau répertoire est créé pour l'API CM Rational (par exemple, C:\eclipse\plugins\com.ibm.rational.stp.cmapi). Le nouveau plug-in inclut les fichiers JAR de l'API CM Rational et les fichiers JAR de Rational ClearQuest.
  3. Après avoir créé le répertoire du plug-in, vous devez copier chaque fichier JAR installé depuis l'emplacement dans lequel il est installé dans ce répertoire. Les fichiers JAR ClearQuest nécessitent le fichier JAR de l'API CM Rational. Le plug-in est prêt à être utilisé la prochaine fois que vous démarrez Eclipse.
  4. Pour utiliser l'API CM Rational depuis votre plug-in, identifiez com.ibm.rational.stp.cmapi en tant que dépendance.
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.

Résumé de la leçon

Maintenant que vous avez configuré votre système pour une programmation avec l'API CM, vous êtes prêt à en savoir plus sur le modèle d'objet et le modèle de programmation de l'API CM.
Dans cette leçon, vous avez appris les notions suivantes :
  • La relation entre l'API CM et Rational ClearQuest
  • Comment configurer votre système pour une programmation avec l'API CM
  • Les fichiers de l'API CM requis pour votre système
< Précédent | Suivant >

Commentaires