< Anterior | Siguiente >

Configuración e instalación de ClearQuest CM API

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:

  1. Cree un plug-in Eclipse utilizando los archivos que se encuentran en el directorio \plugins\com.ibm.rational.stp.cmapi en el archivo de archivado %RATIONAL_INSTALL%\common\cm\teamapi.zip.
  2. Para añadir el plug-in de ClearQuest CM API a la configuración en ejecución, copie el plug-in en la instancia de Eclipse o bien cree un nuevo sitio de instalación de la extensión. Se creará un directorio nuevo para la API (por ejemplo, C:\eclipse\plugins\com.ibm.rational.stp.cmapi). El nuevo plug-in consta de los archivos JAR de ClearQuest CM API y de los archivos JAR de Rational ClearQuest.
  3. Una vez que haya creado el directorio del plug-in, deberá copiar cada archivo JAR instalado desde su ubicación de instalación a este directorio. Los archivos JAR de ClearQuest precisan del archivo JAR de ClearQuest CM API. El plug-in está disponible para utilizarlo la próxima vez que inicie Eclipse.
  4. Para utilizar ClearQuest CM API desde el plugin, identifique com.ibm.rational.stp.cmapi como una dependencia.
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.

Punto de comprobación de la lección

Ahora que ha configurado el sistema para programarlo con ClearQuest CM API, ya está listo para empezar a conocer el modelo de objetos y el modelo de programación de la API.
En esta lección, ha aprendido lo siguiente:
  • La relación entre ClearQuest CM API y Rational ClearQuest
  • Cómo configurar el sistema para programarlo con ClearQuest CM API
  • Qué archivos de ClearQuest CM API son necesarios en el sistema
< Anterior | Siguiente >

Comentarios