< Anterior | Siguiente >

Configuración e instalación de la API CM

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.cmapi.zip y los proyectos de ejemplo en Eclipse, o bien puede seguir estos pasos:

  1. Cree un plug-in de Eclipse utilizando los archivos empaquetados en el archivo com.ibm.rational.stp.cmapi.zip.
  2. Para añadir el plug-in de la API CM de Rational 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 CM de Rational (por ejemplo, C:\eclipse\plugins\com.ibm.rational.stp.cmapi). Este nuevo plug-in es un plug-in de Eclipse autónomo que consta de los archivos JAR de la API CM de Rational más los archivos JAR propios del producto. Recuerde que el archivo .zip no contiene los archivos JAR reales del producto.
  3. Después de crear el directorio de plug-ins, cada archivo JAR instalado debe copiarse de la ubicación instalada en el directorio de plug-ins nuevo. Cada archivo JAR precisa del archivo JAR de la API CM de Rational. El plug-in se puede utilizar la próxima vez que inicie Eclipse.
  4. Para utilizar la API CM de Rational desde el plug-in, identifique com.ibm.rational.stp.cmapi como una dependencia.
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.

Punto de comprobación de la lección

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

Comentarios