Para poder utilizar ClearQuest CM
API, debe añadir archivos a la vía de acceso de clases y tener una versión con licencia del producto Rational ClearQuest instalado.
La API 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 de la API que están instalados en el sistema cuando instale el producto Rational a la vía de acceso de clases.
Se necesitan los siguientes paquetes de Java para realizar las operaciones de Rational ClearQuest mediante la API.
- 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 y proporciona un modelo de objetos 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 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 los ejemplos de código de este documento en Java compilable, no se ha compilado y puede que contenga errores tipográficos que impidan que su compilación.
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 de la API.
El archivo JAR de ClearQuest CM API y otros archivos JAR necesarios están instalados de forma predeterminada en las siguientes ubicaciones, donde
dir-instalación representa el directorio en el que se ha instalado el producto Rational.
De forma predeterminada, este directorio es /opt/rational
en un sistema UNIX y Linux y C:\Archivos de programa\IBM Rational en sistemas Windows.
- En los sistemas Windows:
- <dir-instalación>/Common/stpwvcm.jar: El archivo JAR de la interfaz ClearQuest CM API.
- <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
Debe añadir las ubicaciones de archivos JAR de la API a su vía de acceso de clases antes de poder utilizar la API.
Siga los siguientes pasos para acceder a ClearQuest CM
API desde un plugin de Eclipse:
Ahora ya está preparado para escribir programas Java utilizando ClearQuest CM API.
Debe disponer de una versión instalada y con licencia de Rational ClearQuest antes de poder utilizar la API 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.