< Anterior | Próximo >

Configurando e instalando o CM API

Antes de poder usar o CM API, é necessário incluir arquivos em seu caminho de classe e possuir uma versão licenciada do produto Rational instalado.
A CM API é um componente comum para executar operações em produtos Rational. Para usar esta API com um produto Rational, você deve ter esse produto instalado em seu sistema. Você também deve copiar os arquivos CM API que estão instalados em seu sistema quando você instalar o produto Rational em seu caminho de classe.
Os arquivos CM API necessários para trabalhar com os recursos do Rational ClearQuest incluem arquivos que são necessários para todos os tipos e arquivos de recursos do CM API que são necessários para os recursos Rational ClearQuest. Estes pacotes Java™ são necessários para executar as operações do Rational ClearQuest usando o Rational CM API.
  • javax.wvcm: O pacote Workspace Versioning and Configuration Management (WVCM).
  • com.ibm.rational.wvcm.stp: O Rational Software Team Package é uma extensão do pacote WVCM. Este pacote contém as interfaces do Rational CM API e fornece o modelo de objeto comum para os recursos do produto Rational. Este pacote é independente do repositório específico do produto ou dos limites de implementação.
  • com.ibm.rational.wvcm.stp.cq: Uma extensão específica do produto que fornece acesso aos bancos de dados Rational ClearQuest. Este pacote contém funções que fornecem acesso mais completo (específico do produto) da funcionalidade de um banco de dados ClearQuest e seus recursos subjacentes.

Embora você deva ser capaz de cortar e colar o código neste documento em Java compilável, ele não foi compilado e pode conter erros tipográficos que o impeçam de ser compilado. Versões completas, compiláveis, destes exemplos podem ser localizadas no projeto Eclipse, denominadas amostras, localizadas no arquivo de archive suplementar distribuído com a documentação do Rational CM API.

O arquivo Rational CM API JAR e outros arquivos JAR necessários estão instalados, por padrão, nos seguintes locais. install-dir representa o diretório no qual os arquivos do produto Rational foram instalados. Por padrão, este diretório é /opt/rational no sistema UNIX® e Linux®, e C:\Program Files\IBM Rational em sistemas Windows®.
  • Em sistemas Windows:
    • <install-dir>/Common/stpwvcm.jar: O arquivo JAR da interface do Rational CM API.
    • <install-dir>/Common/stpcmmn.jar: Um arquivo JAR de implementação comum.
    • <install-dir>/ClearQuest/stpcq.jar: Extensão para o produto ClearQuest.
    • <install-dir>/ClearQuest/cqjni.jar: Um arquivo Rational ClearQuest JAR.
  • Em sistemas UNIX e Linux:
    • <install-dir>/common/stpwvcm.jar
    • <install-dir>/common/stpcmmn.jar
    • <install-dir>/clearquest/cqweb/lib/stpcq.jar
    • <install-dir>/clearquest/cqweb/lib/cqjni.jar

Para utilizar os arquivos JAR do Rational CM API, você deve incluir seus locais no caminho da classe.

Para acessar o Rational CM API a partir de um plug-in do Eclipse, execute as seguintes etapas:

  1. Crie um plug-in do Eclipse utilizando os arquivos localizados no diretório \plugins\com.ibm.rational.stp.cmapi no archive %RATIONAL_INSTALL%\common\cm\teamapi.zip.
  2. Para incluir o plug-in do Rational CM API na configuração de tempo de execução, copie o plug-in na instância do Eclipse ou crie um novo site de instalação de extensão. Isso cria um novo diretório para o Rational CM API (por exemplo, C:\eclipse\plugins\com.ibm.rational.stp.cmapi). O novo plug-in inclui os arquivos JAR do Rational CM API e os arquivos JAR do Rational ClearQuest.
  3. Após criar o diretório de plug-in, você deverá copiar cada arquivo JAR instalado a partir do local da instalação no diretório. Os arquivos JAR do ClearQuest requerem o arquivo JAR do Rational CM API. O plug-in estará disponível para uso da próxima vez que você iniciar o Eclipse.
  4. Para utilizar o Rational CM API a partir do seu plug-in, identifique com.ibm.rational.stp.cmapi como uma dependência.
Agora você está pronto para começar a gravar os programas Java com o Rational CM API.
É necessário ter uma versão licenciada e instalada do Rational ClearQuest para usar oRational CM API com os recursos ClearQuest. Se você instalar e configurar os arquivos JAR, mas não tiver o produto correspondente instalado, as chamadas para esse pacote Java irão falhar.

Ponto de verificação da lição

Agora que você configurou seu sistema para programação com o CM API, você está pronto para começar a aprender o modelo do objeto CM API e o modelo de programação.
Nesta lição, você aprendeu o seguinte:
  • O relacionamento entre CM API e Rational ClearQuest
  • Como configurar seu sistema para programação com o CM API
  • Quais arquivos no CM API são necessários para seu sistema
< Anterior | Próximo >

Feedback