L'infrastructure de l'API CM Rational est conçue pour fonctionner, que les sous-fournisseurs soient présents ou pas. L'interface du fournisseur permet aux fichiers JAR du sous-fournisseur de se trouver à différents niveaux d'édition.
Le composant d'API CM Rational est associé à un numéro de version à plusieurs parties. L'installation d'un sous-fournisseur écrase le composant d'infrastructure installé par une version antérieure du sous-fournisseur, mais uniquement si le composant d'infrastructure est d'une version plus celui déjà installé.
Par default, le fichier JAR de l'API CM Rational et les autres fichiers JAR requis sont installés aux emplacements suivants, où la variable RATIONAL_INSTALL représente le répertoire où les fichiers produit Rational sont installés.
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
Le fichier suivant est également requis : %RATIONAL_INSTALL%\ClearQuest\cqjni.jar
Pour utiliser les fichiers JAR de l'API Rational CM, vous devez ajouter tous leurs emplacements à votre chemin de classe.
Vous pouvez créer un plug-in Eclipse en utilisant les fichiers répertoriés dans la section précédente et les fichiers situés dans le répertoire \plugins\com.ibm.rational.stp.cmapi du fichier archive %RATIONAL_INSTALL%\common\cm\teamapi.zip.
Pour ajouter le plug-in d'API CM Rational à votre configuration d'exécution, copiez les fichiers dans votre instance Eclipse ou créez un site d'installation d'extension. Cela crée un nouveau répertoire pour l'API Rational CM, par exemple C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi. Le nouveau plug-in contient les fichiers JAR de l'API CM Rational et les fichiers JAR (ClearCase et ClearQuest) spécifiques au produit. 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 nouveau répertoire de plug-in. Chaque fichier JAR du sous-fournisseur nécessite le fichier JAR de l'API Rational CM. Le plug-in est prêt à être utilisé la prochaine fois que vous démarrez Eclipse. Notez que si vous installez une version plus récente du produit ou un groupe de correctifs, vous devez vérifier que les fichiers JAR du plug-in correspondent aux fichiers JAR installés et utilisent les fichiers JAR les plus récents.
Vous devez identifier com.ibm.rational.stp.cmapi en tant que dépendance pour utiliser l'API CM Rational à partir de votre plug-in . Voir http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm pour obtenir des informations sur la création d'un plug-in.
Vous pouvez également importer le plug-in de l'API CM dans Eclipse en tant que projet.
Vous devez disposer d'une version sous licence et installée d'un produit Rational afin d'utiliser le sous-fournisseur d'API Rational CM pour ce produit. Si vous installez les fichiers JAR du sous-fournisseur mais que vous n'avez pas le produit correspondant installé, les appels à ce module Java™ échoueront.
Pour qu'une application client fasse des requêtes au sous-fournisseur Rational ClearQuest, le produit Rational ClearQuest doit être installé sur le même ordinateur que le programme client qui appelle l'API CM Rational.
Le sous-fournisseur ClearCase prend en charge les vues Web et l'accès distant via Change Management Server (CM Server). La version en cours de l'API CM Rational ne prend pas en charge les vues dynamiques ou de capture d'écran. Les fichiers JAR appropriés doivent être copiés depuis CM Server sur l'ordinateur client (à l'emplacement d'installation du client ou dans le répertoire plug-in), en fonction de la manière dont est utilisée l'API CM Rational.