É possível integrar o sistema com o Rational ClearQuest para criar e atualizar automaticamente
registros do build dentro de um banco de dados do ClearQuest.
O sistema pode criar automaticamente registros do build no banco de dados do seu IBM Rational® ClearQuest®, com links para os dados do log. Além disso, quando uma tarefa for transmitida, o sistema poderá atualizar o banco de dados do ClearQuest, observando se a tarefa foi concluída, registrando o horário de
encerramento e um resumo das etapas que foram realizadas.
Esse recurso exige o
Rational ClearQuest versão 7.0 ou posterior.
Nota: Para criar com êxito o registro de construção e preenchê-lo com
informações sobre a construção, é necessário primeiro abrir a Ferramenta de Manutenção
do ClearQuest e configurar uma conexão com o banco de dados.
Ao configurar um projeto para atualizar um banco de dados do ClearQuest, o sistema desempenha o seguinte:
- Início da Tarefa
- Quando o sistema ativa uma tarefa, ele cria um registro do build do ClearQuest. O registro de construção
está no estado Submetido e inclui a URL do log da tarefa, o horário de início, o nome da liberação e o ID, bem como uma entrada de log que indica "Construção
XYZ iniciada". Se um adaptador de controle de origem cancelar a tarefa (por exemplo, porque nenhuma mudança de origem foi localizada), nenhum registro de construção do ClearQuest é criado.
Nota: Se um projeto encadear outro projeto, o novo
projeto obterá seu próprio ID do build exclusivo do ClearQuest.
- Transmissão/Falha da Tarefa
- Quando uma tarefa é aprovada ou falha, o sistema alterará o estado de construção dentro do ClearQuest para Concluído ou Com Falha, configura o horário de encerramento da construção e armazena um resumo das etapas da tarefa no log de construção do ClearQuest. O resumo contém o nome, o status do resultado e o
servidor de cada etapa.
- Reinício da Tarefa
- Quando uma tarefa for reiniciada, o sistema alterará o estado do build dentro do ClearQuest para Enviado e criará uma entrada do log do build do ClearQuest indicando “Build do XYZ
reiniciado”.
Você configura a integração do ClearQuest por meio de variáveis de ambiente especiais. Para vincular um projeto a um banco de dados do ClearQuest, certifique-se de que as
variáveis na tabela a seguir estejam incluídas no ambiente do
projeto.
Nota: Essas variáveis devem estar presentes no ambiente do projeto.
Incluí-las em uma etapa não é suficiente. Entretanto, é possível usar uma variável
que esteja configurada para o tipo Include, que inclui essas variáveis por meio
de outro ambiente. Além disso, como o valor CQ_RELEASE_NAME é o único que provavelmente varia por projeto,
talvez você queira criar um ambiente que contenha as outras variáveis e utilizar uma variável do tipo Include para incluir esse ambiente no ambiente do projeto, em que
também é possível especificar CQ_RELEASE_NAME como uma variável de ambiente específica do projeto.
Tabela 1. Variáveis de Ambiente Necessárias para a Integração do Rational ClearQuest Variável
|
Descrição
|
CQ_DBNAME
|
Nome do banco de dados do ClearQuest que você deseja atualizar.
|
CQ_INTERACTION
|
Se o seu ambiente de projeto tiver as variáveis
de ambiente corretas definidas para ativar a criação de um registro de construção
do ClearQuest, mas você não desejar criar o registro de construção, configure essa
variável como OFF para desativar a criação do registro de construção.
Para ativar a criação do registro do build, defina essa variável de ambiente como ATIVADA.
Nota: Se você estiver utilizando um dos adaptadores do ClearQuest, defina essa variável de ambiente como DESATIVADA.
|
CQ_USER
|
O nome do usuário a ser utilizado ao efetuar logon no banco de dados do ClearQuest.
|
CQ_RELEASE_NAME
|
O nome da liberação dentro do banco de dados do ClearQuest que você deseja atualizar.
|
CQ_PASSWORD
|
Senha a ser utilizada ao efetuar logon no banco de dados do ClearQuest. Não necessário;
o padrão é em branco.
|
CQ_DBSET
|
O valor definido para o banco de dados do ClearQuest. Não necessário;
o padrão é em branco.
|