Configurando o Adaptador do Rational ClearQuest no WebSphere Application Server

Você pode tornar as bibliotecas compartilhadas do IBM® Rational ClearQuest disponíveis para o aplicativo IBM Rational Publishing Engine Data Services, para que a API do Rational ClearQuest possa ser usada a partir do Rational Publishing Engine.

Antes de Iniciar

  • Você deve ter o Rational ClearQuest instalado no mesmo computador que seu servidor de aplicativos.
  • Implemente o Rational Publishing Engine aplicativo de serviços de dados de relatório e os Adaptadores de Serviços de Dados de Relatório.
  • Corrija qualquer aviso de firewall ou problemas de licença antes de configurar as bibliotecas compartilhadas do Rational ClearQuest.

Procedimento

  1. Inclua os caminhos para as bibliotecas compartilhadas em sua instalação do Rational ClearQuest no nó do WebSphere Application Server no qual o aplicativo Rational Publishing Engine Data Services é implementado:
    1. No WebSphere Application Server, clique em Ambiente > Bibliotecas Compartilhadas.
    2. Para especificar a configuração do escopo, selecione a entrada Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer. RationalPublishingEngineNode01 é o nome padrão do nó e RationalPublishingEngineServer é o nome padrão do servidor.
    3. Para criar a referência da biblioteca compartilhada, clique em Nova.
    4. Configure os valores para Name, Descriptione ClassPath. Assegure-se de que o caminho da classe faça referência aos arquivos em seus locais corretos.
      Tabela 1. Campos de Referência de Biblioteca Compartilhada
      Descrição Valores
      Nome ClearQuest CM API
      Descrição A biblioteca compartilhada para o adaptador do ClearQuest.
      Caminho da Classe

      application_files\IBM\RationalSDLC\ClearQuest\cqjni.jar
      application_files\IBM\RationalSDLC\ClearQuest\stpcq.jar
      application_files\IBM\RationalSDLC\Common\stpcmmn.jar
      application_files\IBM\RationalSDLC\Common\stpwvcm.jar

      Nota: Os valores padrão listados são para o Rational ClearQuest 7.1. Os caminhos reais para uso dependem de onde e em qual versão do Rational ClearQuest está instalado. Certifique-se de estar fazendo referência aos arquivos em seus locais corretos. Para visualizar o local da instalação do Rational ClearQuest, verifique no IBM Installation Manager clicando em Iniciar > Todos os Programas > IBM Installation Manager > Visualizar Pacotes Instalados.
    5. Clique em OK e em Salvar.
  2. Associe as bibliotecas compartilhadas do Rational ClearQuest com o perfil do aplicativo de serviços de dados de relatório:
    1. Clique em Servidores > Servidores de Aplicativos.
    2. Clique no servidor no qual você implementou o aplicativo Data Services. O nome do servidor padrão é RationalPublishingEngineServer.
    3. Clique em Infraestrutura do Servidor > Java e Gerenciamento de Processo > Carregador de Classes.
    4. Para criar um carregador de classes para as bibliotecas compartilhadas, clique em Novo > OK.
    5. Para associar as referências da biblioteca compartilhada ao carregador de classes, clique no hyperlink do novo carregador de classes criado na subetapa 2.d.
    6. Para cada biblioteca que deve ser associada, clique em Incluir, selecione a biblioteca e, em seguida, clique em OK.
    7. Clique em Referências da Biblioteca Compartilhada.
    8. Para associar cada biblioteca, clique em Incluir, selecione a biblioteca e clique em OK.
    9. Clique em Salvar.
  3. Ícone do Linux Se você estiver usando o Linux, configure o argumento genérico da JVM:
    1. Clique em Servidores > Tipos de Servidor > WebSphere Application Servers.
    2. Clique no nome do servidor.
    3. Na seção Infraestrutura do Servidor, expanda Java e Gerenciamento de Processo e clique em Definição de Processo.
    4. Clique em Java Virtual Machine.
    5. No campo Argumentos da JVM Genérica, insira: Argumentos da JVM Genérica -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. Clique em OK.
  4. Ícone do Linux Se você estiver usando o Linux, configure a variável de ambiente LD_LIBRARY_PATH:
    1. Na página Definição de Processo, clique em Entradas de Ambiente e clique em LD_LIBRARY_PATH.
    2. Insira um nome e insira o caminho da biblioteca. Exemplo: /opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. Reinicie o aplicativo dos serviços de dados de relatório.
  6. Verifique se o adaptador do IBM Rational ClearQuest e as bibliotecas estão configurados corretamente. Insira uma URL para o adaptador do Rational ClearQuest em um navegador.
    • Insira http://host:port/DataServices/ClearQuest. Se a instalação estiver correta, você verá uma lista de conexões do Rational ClearQuest, conforme exibido na Rational ClearQuest Maintenance Tool.
    • Insira http://host:port/DataServices/ClearQuest/version. Se a instalação estiver correta, você verá uma lista de bancos de dados do usuário do Rational ClearQuest.
    • Insira http://host:port/DataServices/ClearQuest/version/database_name. Se a instalação estiver correta, você verá uma lista de consultas.

O que Fazer Depois

Copie uma URL de consulta a ser incluída em um modelo ou ou uma especificação de documento.
Nota: O aplicativo de serviços de dados de relatório suporta apenas consultas com conjuntos de resultados estáticos. Consultas dinâmicas não são suportadas.

Exemplo

Com a URL para a consulta Todos Defeitos, você verá um conjunto de resultados com o número de ocorrências que a consulta retornará para o cliente do Rational ClearQuest. Cada resultado é um DBID exclusivo para um tipo de registro específico. Você pode continuar com esse processo até receber um retorno para os dados de um registro específico. Retenha a consulta URL para uso em autoria de relatório do Rational Publishing Engine.

Remova argumentos incluindo e após o ponto de interrogação:

Antes: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
Depois: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Feedback