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:
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.