Para poder utilizar la API CM, debe añadir archivos a la vía de acceso de clases y tener una versión con licencia del producto Rational instalado.
La API CM es un componente común para realizar operaciones con productos de Rational.
Para utilizar esta API con un producto Rational, debe tener dicho producto instalado en el sistema. También debe copiar los archivos API CM que están instalados en el sistema cuando instale el producto Rational a la vía de acceso de clases.
Los archivos de la API CM necesarios para trabajar con los recursos de Rational ClearQuest incluyen los archivos que son necesarios para todos los tipos de recursos y archivos de la API que son necesarios para los recursos de Rational ClearQuest.
Estos paquetes de Java son necesarios para realizar operaciones de Rational ClearQuest utilizando la API de Rational.
- javax.wvcm: La creación de versiones y paquete de gestión de configuración (WVCM).
- com.ibm.rational.wvcm.stp: El paquete del equipo de software de Rational es una extensión del paquete WVCM. Este paquete contiene las interfaces de la API CM de Rational y ofrece el modelo de objeto común para los recursos del producto Rational.
Este paquete es independiente del repositorio específico del producto o de los límites de implementación.
- com.ibm.rational.wvcm.stp.cq: Una extensión específica del producto que ofrece acceso a las bases de datos de Rational ClearQuest. Este paquete contiene funciones que proporcionan un acceso más completo (específico del producto) a las funciones de una base de datos de ClearQuest y los recursos subyacentes.
Si bien es posible cortar y pegar el código de este documento en Java compilable, no se ha compilado y puede que contenga errores tipográficos que impidan que se compile. En el proyecto de Eclipse denominado samples hay versiones completas y compilables de estos ejemplos en el archivo de archivado suplementario que se distribuye con la documentación para la API CM de Rational.
El archivo JAR de la API CM de Rational y otros archivos JAR necesarios están instalados de forma predeterminada en las siguientes ubicaciones:
dir-instalación representa el directorio en el que se han instalados los archivos del producto Rational.
De forma predeterminada, este directorio es
/opt/rational en el sistema UNIX y Linux,
y
C:\Program Files\IBM Rational en los sistemas Windows.
- En los sistemas Windows:
- <dir-instalación>/Common/stpwvcm.jar: El archivo JAR de la interfaz API CM de Rational.
- <dir-instalación>/Common/stpcmmn.jar: Una implementación común del archivo JAR.
- <dir-instalación>/ClearQuest/stpcq.jar: Extensión del producto ClearQuest.
- <dir-instalación>/ClearQuest/cqjni.jar: Un archivo JAR de Rational ClearQuest.
- En los sistemas UNIX y Linux:
- <dir-instalación>/common/stpwvcm.jar
- <dir-instalación>/common/stpcmmn.jar
- <dir-instalación>/clearquest/cqweb/lib/stpcq.jar
- <dir-instalación>/clearquest/cqweb/lib/cqjni.jar
Para utilizar los archivos JAR de la API CM de Rational, debe añadir todas las ubicaciones a la vía de acceso de clases.
Para acceder a la API CM de Rational desde un plug-in de Eclipse, puede importar el archivo com.ibm.rational.stp.teamapi.zip y los proyectos de ejemplo en Eclipse, o bien puede seguir estos pasos:
Ahora ya está preparado para escribir programas Java con la API CM de Rational.
Debe disponer de una versión instalada y con licencia de Rational ClearQuest con el fin de utilizar la API CM de Rational con los recursos de ClearQuest. Si instala y configura los archivos JAR, pero no tiene instalado el producto correspondiente, las llamadas a dicho paquete Java no se realizarán correctamente.