La infraestructura de la API de Rational CM está diseñada para funcionar independientemente de que los subproveedores estén presentes o no. 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 asociado 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 se encuentra instalada.
El archivo JAR de la API de Rational CM y otros archivos JAR necesarios se instalan en las ubicaciones siguientes de forma predeterminada. La variable <dir-instal> representa el directorio en el que se han instalado los archivos del producto Rational. De forma predeterminada, este directorio es /opt/rational en los sistemas UNIX® y Linux® y C:\Archivos de programa\IBM Rational en los sistemas Windows®.
El archivo JAR de la API de Rational CM.
Un archivo JAR de implementación común.
Ampliación del producto ClearQuest. También se necesita <dir-instal>\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 mediante los archivos empaquetados en el archivo <dir-instal>\common\com.ibm.rational.stp.cmapi.zip y otros archivos instalados (enumerados en la sección anterior) para dar soporte al acceso a la API de Rational CM desde otros conectores de un entorno de ejecución de Eclipse. Este archivo ZIP incluye ejemplos de código, incluidos los ejemplos que las guías de aprendizaje de la API de CM describen.
Para añadir el conector de la API de Rational CM a la configuración del tiempo de ejecución, puede copiar el conector en la instancia de Eclipse o crear 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). Éste es un simple y nuevo conector de Eclipse independiente que consta de archivos JAR de la API de Rational CM y archivos JAR (ClearCase y ClearQuest) específicos de producto. Tenga en cuenta que el archivo .zip también contiene los archivos JAR del producto reales. 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.
Para utilizar la API de Rational CM desde el conector, deberá identificar com.ibm.rational.stp.cmapi como una dependencia. Para obtener información sobre cómo crear un conector, vaya a http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm.
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 la misma máquina 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 Rational ClearCase 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 a la máquina del cliente, ya sea en la ubicación de instalación del cliente o en el directorio del conector, en función del modo en que se utilice la API de Rational CM.