Por padrão, o arquivo JAR do Rational CM API e os outros arquivos JAR necessários são instalados nos seguintes locais, em que a variável RATIONAL_INSTALL representa o diretório no qual os arquivos do produto Rational estão instalados.
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\Common\stpcmn.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
O seguinte arquivo também é necessário: %RATIONAL_INSTALL%\ClearQuest\cqjni.jar
Para usar os arquivos JAR Rational CM API, é necessário incluir todos os seus locais em seu caminho de classe.
É possível criar um plug-in do Eclipse utilizando os arquivos listados na seção anterior e os arquivos localizados no diretório \plugins\com.ibm.rational.stp.cmapi no archive %RATIONAL_INSTALL%\common\cm\teamapi.zip.
Para incluir o plug-in do Rational CM API em sua configuração de tempo de execução, copie os arquivos na instância do Eclipse ou crie um novo site de instalação de extensão. Isso cria um novo diretório para o ClearQuest CM API, por exemplo, o C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi. O novo plug-in abrange os arquivos JAR do Rational CM API e os arquivos JAR do ClearQuest. Após criar o diretório de plug-in, você deve copiar cada arquivo JAR instalado do local da instalação para esse novo diretório de plug-in. Cada arquivo JAR de subprovedor requer o arquivo JAR do ClearQuest CM API. O plug-in estará disponível para uso na próxima vez que você iniciar o Eclipse. Observe que se você instalar uma versão de produto ou correção mais nova, será necessário verificar se os arquivos JAR no plug-in correspondem aos arquivos JAR instalados e utilizar os arquivos JAR mais novos.
Você deve identificar com.ibm.rational.stp.cmapi como uma dependência para usar o ClearQuest CM API a partir do seu plug-in. Consulte http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm para obter informações sobre como criar um plug-in.
Também é possível importar o plug-in do ClearQuest CM API no Eclipse como um projeto.
É necessário possuir uma versão licenciada e instalada de um produto Rational para usar o subprovedor Rational CM API para aquele produto. Se você instalar os arquivos JAR do subprovedor, mas não tiver o produto correspondente instalado, as chamadas para esse pacote Java falharão.
Para que um aplicativo cliente faça solicitações ao subprovedor do Rational ClearQuest, o produto Rational ClearQuest deve ser instalado no mesmo computador que o programa cliente que está chamando o Rational ClearQuest CM API.