Esse tópico descreve como aplicar o pacote Rational ClearQuest OSLCLinks versão 1.0
ou 1.1 no seu esquema usando o Rational ClearQuest Designer que se baseia
na tecnologia Eclipse.
Sobre Esta Tarefa
Aplique o pacote OSLCLinks v1.0 se estiver executando o ClearQuest v7.1.2. Aplique o pacote OSLCLinks v1.1 se estiver executando o ClearQuest v7.1.2.1.
Procedimento
- No ClearQuest Designer,
clique com o botão direito no esquema ao qual deseja aplicar o pacote e
selecione . O Assistente do Pacote é aberto.
- Expanda o nó OSLCLinks na lista de pacotes e selecione a versão
1.0 ou 1.1.
Clique em Avançar (Next).
- Selecione os tipos de registros nos quais deseja aplicar o
pacote.
- Opcional: Se o pacote OSLCLinks v1.1 for aplicado e desejar usar o suporte
de predicado de estado para mapear os estados ou status do ClearQuest para os estados OSLC, você deverá incluir o script Perl global denominado OSLC_CQ_State_Mapping e fornecer
uma implementação:
- Navegue para associado ao esquema, clique com o botão
direito do mouse e selecione Incluir.
- Insira o seguinte texto no campo Nome do Ganho e clique em
OK: OSLC_CQ_State_Mapping
- Inclua o código do ganho no script OSLC_CQ_State_Mapping.
- Clique em Finish.
O pacote
OSLCLinks é aplicado ao esquema selecionado. Verifique a instalação
do pacote ao procurar por um novo tipo de registro stateless OSLCLink no esquema.
Consulte a ajuda Aplicando Pacotes para obter mais informações sobre a aplicação dos pacotes.
Exemplo
Essa seção fornece um exemplo da aplicação do pacote OSLCLinks
v1.1 no esquema DefectTracking e da ativação do pacote para o tipo de registro
Defeito.
- No ClearQuest Designer,
clique com o botão direito no esquema ao qual deseja aplicar o pacote e
selecione . O Assistente do Pacote é aberto.
- Expanda o nó OSLCLinks na lista de pacotes, selecione a versão
1.1 e clique em OK.
- Ative o pacote OSLCLinks para o tipo de registro Defeito.
- Inclua o script Perl global denominado OSLC_CQ_State_Mapping e forneça
uma implementação:
- Navegue para associado ao esquema, clique com o botão
direito do mouse e selecione Incluir.
- Insira o seguinte texto no campo Nome do Ganho e clique em
OK: OSLC_CQ_State_Mapping
- Inclua o código do ganho no script OSLC_CQ_State_Mapping.
Exemplo:
sub OSLC_CQ_State_Mapping {
my ($myentity, $hook_type) = @_;
my $state = $myentity->GetFieldStringValue("State");
if ($hook_type eq "Validation") {
if (($state eq "Assigned") || ($state eq "Opened")) {
$myentity->SetFieldValue("oslc_cm-inprogress", "1");
} else {
$myentity->SetFieldValue("oslc_cm-inprogress", "0");
}
if ($state eq "Closed") {
$myentity->SetFieldValue("oslc_cm-closed", "1");
} else {
$myentity->SetFieldValue("oslc_cm-closed", "0");
}
}
}
Esse script é chamado pelo ganho de inicialização e validação da
ação OSLC_State_Predicates de um registro Defeito. O script possui dois parâmetros: entidade atual e o tipo de ganho. Dependendo dos seus requisitos, é possível incluir códigos diferentes de
acordo com o valor do parâmetro de tipo de gancho. O script de exemplo
mostra um gancho de validação.
- Clique em Concluir. A revisão do esquema é registrada.
- Atualize o banco de dados do usuário.
- Verifique as mudanças de esquema:
- Use seu cliente ClearQuest para efetuar
login no banco de dados do usuário.
- Edite a consulta Todos os Defeitos e inclua os seguintes campos de exibição: oslc_cm-inprogress e oslc_cm-closed.
- Execute a consulta Todos os Defeitos.
- Selecione um defeito nos resultados da consulta que estiverem no estado
Enviado.
- Feche o defeito e verifique se oslc_cm-closed
é igual a 1 enquanto os outros campos com nomes prefixados com oslc_cm é igual a 0.
- Reabra o defeito e verifique se oslc_cm-inprogress
é igual a 1 enquanto os outros campos com nomes prefixados com oslc_cm é igual a 0.