Procedimento para Aplicar o Pacote OSLCLinks

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

  1. No ClearQuest Designer, clique com o botão direito no esquema ao qual deseja aplicar o pacote e selecione Pacotes > Aplicar Pacotes. O Assistente do Pacote é aberto.
  2. Expanda o nó OSLCLinks na lista de pacotes e selecione a versão 1.0 ou 1.1. Clique em Avançar (Next).
  3. Selecione os tipos de registros nos quais deseja aplicar o pacote.
  4. 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:
    1. Navegue para Scripts Globais > Nó de Perl associado ao esquema, clique com o botão direito do mouse e selecione Incluir.
    2. Insira o seguinte texto no campo Nome do Ganho e clique em OK: OSLC_CQ_State_Mapping
    3. Inclua o código do ganho no script OSLC_CQ_State_Mapping.
  5. 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.

  1. No ClearQuest Designer, clique com o botão direito no esquema ao qual deseja aplicar o pacote e selecione Pacotes > Aplicar Pacotes. O Assistente do Pacote é aberto.
  2. Expanda o nó OSLCLinks na lista de pacotes, selecione a versão 1.1 e clique em OK.
  3. Ative o pacote OSLCLinks para o tipo de registro Defeito.
  4. Inclua o script Perl global denominado OSLC_CQ_State_Mapping e forneça uma implementação:
    1. Navegue para Scripts Globais > Nó de Perl associado ao esquema, clique com o botão direito do mouse e selecione Incluir.
    2. Insira o seguinte texto no campo Nome do Ganho e clique em OK: OSLC_CQ_State_Mapping
    3. 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.

  5. Clique em Concluir. A revisão do esquema é registrada.
  6. Atualize o banco de dados do usuário.
  7. Verifique as mudanças de esquema:
    1. Use seu cliente ClearQuest para efetuar login no banco de dados do usuário.
    2. Edite a consulta Todos os Defeitos e inclua os seguintes campos de exibição: oslc_cm-inprogress e oslc_cm-closed.
    3. Execute a consulta Todos os Defeitos.
    4. Selecione um defeito nos resultados da consulta que estiverem no estado Enviado.
    5. 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.
    6. 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.

Feedback