La infraestructura de la API de Rational CM está diseñada para funcionar independientemente de si los subproveedores están presentes. La interfaz de proveedor permite utilizar los archivos JAR de subproveedor en diferentes niveles de release.
El componente de la API de Rational CM tiene un número de versión de varios componentes. La instalación de un subproveedor sobrescribe el componente de infraestructura instalado por una versión anterior del subproveedor, pero sólo en el caso de que la versión del componente de la infraestructura sea más actual que la que ya se encuentra instalada.
De forma predeterminada, el archivo JAR de la API de Rational CM y los demás archivos JAR necesarios se instalan en las ubicaciones siguientes, donde la variable RATIONAL_INSTALL representa el directorio en el que están instalados los archivos de producto de Rational.
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
El archivo siguiente también es necesario: %RATIONAL_INSTALL%\ClearQuest\cqjni.jar
Para utilizar los archivos JAR de la API de Rational CM, deberá añadir todas sus ubicaciones a la vía de acceso de clase.
Puede crear un conector Eclipse con los archivos de la lista anterior y los ubicados en el directorio \plugins\com.ibm.rational.stp.cmapi del archivo de archivado %RATIONAL_INSTALL%\common\cm\teamapi.zip.
Para añadir el conector de la API de Rational CM a la configuración del tiempo de ejecución, copie los archivos en la instancia de Eclipse o cree un sitio de instalación de ampliación nuevo. De este modo, se crea un directorio nuevo para la API de Rational CM, por ejemplo, C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi. El nuevo conector incluye los archivos JAR de la API de Rational CM y los archivos JAR específicos de producto (ClearCase y ClearQuest) JAR. Una vez que haya creado el directorio del conector, deberá copiar cada archivo JAR instalado desde su ubicación de instalación al nuevo directorio de conector. Cada archivo JAR del subproveedor requiere el archivo JAR de la API de Rational CM. El conector se puede usar la próxima vez que se inicie Eclipse. Tenga en cuenta que si instala una versión de producto o parche más nueva, deberá verificar que los archivos JAR del conector coinciden con los archivos JAR instalados y utilizan los archivos JAR más actuales.
Deberá identificar com.ibm.rational.stp.cmapi como una dependencia para utilizar la API de Rational CM desde el conector. Consulte http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm para obtener más información sobre la creación de un conector.
También puede importar el conector de la API de CM a Eclipse en forma de proyecto.
Deberá tener instalada una versión con licencia de un producto de Rational para utilizar el subproveedor de la API de Rational CM para dicho producto. Si instala los archivos JAR del subproveedor sin tener el producto correspondiente instalado, las llamadas al paquete Java™ no se realizarán correctamente.
Para que una aplicación cliente realice solicitudes al subproveedor de Rational ClearQuest, el producto Rational ClearQuest deberá estar instalado en el mismo sistema que el programa de cliente que está invocando la API de Rational CM.
El subproveedor ClearCase da soporte a vistas web y al acceso remoto a través del servidor de cambios (servidor CM). La versión actual de la API de Rational CM no da soporte a vistas dinámicas ni de instantánea. Los archivos JAR adecuados deben copiarse desde el servidor CM al sistema del cliente (ya sea en la ubicación de instalación del cliente o en el directorio plug-in), en función del modo en que se utilice la API de Rational CM.