< 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 usar os arquivos JAR do Rational CM API, você deve incluir todos os seus locais a seu caminho de classe.

Para acessar o Rational CM API de um plugin Eclipse, é possível importar o arquivo com.ibm.rational.stp.cmapi.zip e projetos de amostra para o Eclipse ou você pode seguir estas etapas:

  1. Criar um plugin Eclipse usando os arquivos compactados no arquivo com.ibm.rational.stp.cmapi.zip.
  2. Para incluir o plugin do Rational CM API em sua configuração de tempo de execução, copie o plugin em sua instância do Eclipse ou crie um novo site de instalação da extensão. Isto cria um novo diretório para o Rational CM API (por exemplo, C:\eclipse\plugins\com.ibm.rational.stp.cmapi). Este novo plugin é um plugin autocontido simples do Eclipse que consiste em arquivos Rational CM API mais os arquivos JAR JAR específicos do produto. Observe que o arquivo .zip não contém os arquivos reais do JAR do produto.
  3. Depois de criar o diretório do plugin, cada arquivo JAR instalado deve ser copiado de seu local instalado para o novo diretório do plugin. Cada arquivo JAR exige o arquivo do Rational CM API JAR. O plugin estará disponível para uso da próxima vez que você iniciar o Eclipse.
  4. Para usar o Rational CM API a partir de seu plugin, 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