Atualizando Registros do Build do ClearQuest

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


Feedback