A infraestrutura CM API Rational foi projetada para funcionar com todos os subprovedores presentes ou não. A interface do provedor permite que os arquivos JAR do subprovedor estejam em diferentes níveis de release.
O componente CM API Rational tem um número da versão de multipartes associado a ele. A instalação de um subprovedor sobrescreve o componente de infra-estrutura instalado por uma versão anterior do subprovedor, mas apenas se o componente de infra-estrutura for uma versão mais recente que aquela já instalada.
O arquivo JAR CM API Rational e outros arquivos JAR necessários são instalados por padrão nos seguintes locais. A variável <install-dir> representa o diretório no qual os arquivos do produto Rational foram instalados. Por padrão, esse diretório é /opt/rational nos sistemas UNIX® e Linux® e C:\Arquivos de programas\IBM Rational nos sistemas Windows®.
O arquivo JAR da interface Rational CM API.
Um arquivo JAR de implementação comum.
Extensão para o produto ClearQuest. Também é necessário <install-dir>\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 usando os arquivos contidos no arquivo <install-dir>\common\com.ibm.rational.stp.cmapi.zip e outros arquivos instalados (listados na seção anterior) para suportar acesso Rational CM API de outros plug-ins em um ambiente de tempo de execução Eclipse. Esse arquivo zip inclui amostras de código, incluindo os exemplos descritos pelos tutoriais do CM API.
Para incluir o plug-in Rational CM API em sua configuração de tempo de execução, é possível copiar o plug-in na sua instância do Eclipse ou criar um novo site de instalação da extensão. Isso cria um novo diretório para o Rational CM API (por exemplo, C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi). Esse novo plug-in é um plug-in autocontido simples do Eclipse que consiste nos arquivos JAR Rational CM API mais os arquivos JAR específicos do produto (ClearCase e ClearQuest). Note que o arquivo .zip também contém os arquivos JAR do produto real. Depois de criar o diretório do plug-in, você deve copiar cada arquivo JAR instalado de seu local de instalação para esse novo diretório do plug-in. Cada arquivo JAR do subprovedor requer o arquivo JAR Rational CM API. O plug-in estará disponível para ser utilizado na próxima vez em que você iniciar o Eclipse. Note que se você instalar uma versão mais recente do produto ou uma correção, será necessário verificar se os arquivos JAR no plug-in correspondem aos arquivos JAR instalados e utilizar os arquivos JAR mais recentes.
Para usar o Rational CM API do seu plug-in, é necessário identificar com.ibm.rational.stp.cmapi como uma dependência. Para obter informações sobre a criação de um plug-in, vá para http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm.
Você também pode importar o plug-in do CM API para o 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 possa fazer pedidos para o subprovedor Rational ClearQuest, o produto Rational ClearQuest deve estar instalado na mesma máquina que o programa cliente que estiver invocando o Rational CM API.
O subprovedor ClearCase suporta visualizações na Web e acesso remoto através do Rational ClearCase CM Server. A versão atual do Rational CM API não suporta visualizações dinâmicas ou de captura instantânea. Os arquivos JAR apropriados devem ser copiados do CM Server para o computador cliente, para o local de instalação do cliente ou para o diretório plug-in, dependendo de como o Rational CM API estiver sendo usado.