Planejamento das Regras de Sincronização

Antes de poder criar regras de sincronização, você precisa analisar o tipo ou tipos de registro do ClearQuest que deseja sincronizar com os itens de trabalho do Rational Team Concert e criar um plano para mapear campos nos tipos de registro para propriedades nos itens de trabalho.
Por Que e Quando Desempenhar Esta Tarefa
Idealmente, a pessoal que planeja e cria regras de sincronização deve ser a pessoa que criou ou mantém o esquema do ClearQuest. Você também deve ter um entendimento básico do Jazz e estar familiarizado com áreas de projetos e itens de trabalho.

Não é prático mapear cada tipo de registro para um tipo de item de trabalho. Os dois tipos deve ser semelhantes em suas finalidades, campos necessários e modelo de transição de estado. Reveja todos os tipos de registro definidos no esquema para o banco de dados do usuário que deseja conectar a uma área de projetos do Jazz e identifique quais tipos de registro são bons candidatos para sincronização.

Você pode utilizar o Assistente de Configuração do ClearQuest Connector para criar as versões iniciais das regras de sincronização, mas é preciso editar as regras para especificar detalhes de mapeamento adicionais. No mínimo, você deverá editar as regras de sincronização para especificar como configurar a propriedade Categoria de itens de trabalho.

Conforme você trabalha através das seguintes etapas de planejamento, registre as informações sobre seu tipo de registro na planilha que o acompanha. Crie uma planilha para cada tipo de registro que planejar sincronizar. Utilize a planilha quando começar a criar ou editar regras de sincronização. Se você utilizar o Assistente de Configuração do ClearQuest Connector para criar as versões iniciais das regras de sincronização, abra-as no editor de Regras de Sincronização; compare os detalhes de mapeamento aos requisitos em sua planilha de planejamento; e identifique quaisquer falhas.

Para planejar suas regras de sincronização:

  1. Usando o tipo de item de trabalho História do Rational Team Concert, desenvolva o caso de uso que descreve como sua equipe planeja trabalhar no Rational Team Concert. História deve indicar o processo (como Scrum), tipos de itens de trabalho e fluxos de trabalho que sua equipe pretende usar.
  2. Com base na História, identifique qual tipo (ou tipos) de registro do ClearQuest para sincronizar com quais tipos de itens de trabalho. Se nenhum tipo de item pronto para utilização do cliente do Rational Team Concert for uma correspondência próxima a um tipo de registro do ClearQuest que deseja sincronizar, é possível criar um tipo de item de trabalho para corresponder ao tipo de registro.
  3. É possível mapear um tipo de registro do ClearQuest a múltiplos tipos de item de trabalho. Por exemplo, seu tipo de registro pode ser geral, como Pedido de Alteração, e contém um campo que o qualifica como um Requisito de Erro ou Release. Se tiver esta situação, indique o nome do campo do ClearQuest que você utilizar para qualificar o tipo de registro, e liste os valores dos campos e seus tipos de item de trabalho correspondentes.
  4. Defina a direção da sincronização entre o tipo de registro e o tipo de item de trabalho. Se você planeja importar um conjunto de registros de um banco de dados do usuário do ClearQuest para um Repositório do Jazz, e fazer sua equipe trabalhar exclusivamente no Rational Team Concert, a direção da sincronização é Apenas Entrada. Se você pretende trabalhar em Rational Team Concert e em Rational ClearQuest, a sincronização é Entrada e Saída.
  5. Identifique o conjunto de campos necessários no tipo de registro do ClearQuest e no tipo de item de trabalho correspondente. Se você utilizar o processo Scrum, os tipos de itens de trabalho Defeito e Tarefas exigem entradas somente nos campos Sumários e Arquivado Contra (Categoria). Na página Visão Geral do editor de Itens de Trabalho, os campos necessários são identificados com um asterisco.

    Para consultar os campos necessários do tipo de registro do ClearQuest, abra o esquema no Designer do ClearQuest. Clique em Iniciar > Todos os Programas > IBM Rational > IBM Rational ClearQuest > Designer do ClearQuest. No assistente Abrir Esquema, selecione o esquema para o tipo de registro que deseja sincronizar. Na área de janela de Navegação, expanda a pasta Tipos de Registro, a pasta de tipo de registro específico e, em seguida, a pasta Estados e Ações. Dê um clique duplo em Comportamentos. A matriz de Comportamentos identifica os campos necessários como Obrigatório.

  6. Para cada um dos campos ClearQuest necessários, identifique um campo no tipo de item de trabalho para o qual é possível mapear o campo do ClearQuest. De forma semelhante, cada campo de tipo de item de trabalho necessário, identifique um campo correspondente do ClearQuest. Na escolha do campo de mapeamento adequado, considere o significado do campo e o tipo de campo. Para ver os tipos de campo dos tipos de registro do ClearQuest, abra o esquema para tipo de registro no Designer do ClearQuest. Na área de janela de Navegação, expanda a pasta Tipos de Registro, a pasta de tipo de registro específica e, em seguida, dê um clique duplo em Campos para abrir a matriz de Campos.

    Consulte os tipos de campos no login do Rational Team Concert, para o cliente do Rational Team Concert. Na visualização Artefatos da Equipe, dê um clique duplo na área de projetos para abri-la no editor da Área de Projetos. Clique na guia Configuração do Processo. Expanda a Configuração do Projeto, em seguida os Dados da Configuração e, depois, os Itens de Trabalho. Clique em Apresentações do Editor. Selecione a apresentação do editor para o tipo de item de trabalho que você está sincronizando. Na área Apresentação do Editor, expanda as guias e seções para ver a lista de apresentações (campos). O tipo aparece entre parênteses depois de cada nome de campo.

  7. Se o tipo de item de trabalho não tiver os campos adequados para mapeamento de alguns dos campos de tipo de registro necessários do ClearQuest, crie novos campos no tipo de item de trabalho. Na página Configuração de Projeto, expanda Configuração do Projeto e, em seguida, Dados de Configuração, e então em Itens de Trabalho. Clique em Tipos. Selecione a categoria do tipo do item de trabalho. Na área Atributos Customizados, clique em Incluir. Digite um nome para o campo e selecione um tipo que seja compatível com o tipo de campo correspondente do ClearQuest. Clique em OK. Clique em Salvar para salvar suas alterações no tipo do item de trabalho.
  8. Se o tipo de registro não tiver campos adequados para mapeamento para alguns dos campos de tipo de item de trabalho necessários, crie novos campos no tipo de registro incluindo linhas na matriz Campos.
  9. Durante a sincronização de entrada, a propriedade de categoria de um item de trabalho deve ser configurada porque o item de trabalho está associado a uma área da equipe baseada em sua categoria. É possível fornecer ao Rational Team Concert informações sobre categoria das seguintes formas:
    • Conecte um registro sem estado do ClearQuest com uma categoria
    • Mapeie um ou mais campos com valor de cadeia do registro do ClearQuest para uma categoria
    • Mapeie um valor externo para um valor de categoria fixo
    • Mapeie, mas não conecte, um ou mais registros do ClearQuest com uma categoria

    Consulte Editando Regras de Sincronização para Especificar Categorias para obter detalhes sobres esses métodos e, em seguida, escolha um dos métodos a ser utilizado.

  10. Identifique qualquer campo adicional, não necessário, do registro do ClearQuest que deseja sincronizar com campos de item de trabalho. Identifique os campos de item de trabalho correspondentes. Se necessário, crie campos no tipo de item de trabalho incluindo atributos customizados.
  11. Identifique todos os campos de registro do ClearQuest que deseja exibir no item de trabalho mas não sincronize um campo do item de trabalho.
  12. Qualquer um dos campos que deseja sincronizar tem listas de opções de valores, como um campo Prioridade ou Gravidade? Para cada campo, identifique o mapeamento de valores a partir do campo de registro do ClearQuest para o campo do item de trabalho. Se não houver um mapeamento de um para um de todos os valores, designe um como o valor padrão.
  13. Alguns dos campos que deseja sincronizar necessitam de uma manipulação especial para transformar seus valores antes deles poderem ser enviados a seus campos correspondentes de item de trabalho ou campos de registro do ClearQuest?

    O ClearQuest Connector fornece os seguintes transformadores de valor.

    Tabela 1. Transformadores do ClearQuest Connector
    Nome do transformador Descrição
    Conectar Campo ao Transformador de Atributo Customizado Mapeia o valor de um atributo customizado de um item de trabalho para um campo em um registro do ClearQuest que esteja referenciado por um campo em outro registro.
    Transformador de Detalhes do Contribuidor Não utilizado atualmente com o ClearQuest Connector.
    Exibir Campos de Registro Referenciados no Transformador de Atributos Customizado Mapeia o conteúdo de um registro referenciado do ClearQuest para um atributo customizado do item de trabalho para que o conteúdo possa ser exibido no editor de item de trabalho.
    Transformador da Área de Projetos Não utilizado atualmente com o ClearQuest Connector.
    Transformador de Registro de Data e Hora/Dias Converte uma cadeia que identifica a quantidade de dias em um registro do ClearQuest para a quantidade de milissegundos, que é o que o registro de data e hora utiliza para determinar o tempo.
    Transformador de Ação do Item de Trabalho Computa a ação a ser tomada ao fazer a transição de um estado para outro durante a sincronização de entrada. Isto é necessário se a definição de fluxo de trabalho do item do Rational Team Concert contiver transições de estado ambíguo em que mais de uma ação é possível para a transição entre dois estados.

    Diferente dos tipos de registro do Rational ClearQuest, os tipos de item de trabalho do Rational Team Concert permitem mais de uma ação para transição de um estado para o outro. Se você não utilizar o Transformador de Ação do Item de Trabalho para sincronizar itens que contenham múltiplas ações para transições de estado, uma operação de sincronização depois da transição de estado gera um erro informando que o registro do ClearQuest não pode ser transicionado para outro estado.

    Transformador de Anexos do Item de Trabalho Converte um anexo do Rational Team Concert em um anexo de registro do ClearQuest.
    Transformador de Categoria do Item de Trabalho Mantém a estrutura hierárquica das categorias do Rational Team Concert mapeadas para os registros do ClearQuest quando o valor é um caminho.
    Transformador de Comentários do Item de Trabalho Converte um Comentário do Rational Team Concert em uma Nota de registro do ClearQuest. É necessário utilizar o pacote de Notas padrão fornecido com o Rational ClearQuest.
    Transformador de Tags do Item de Trabalho Transforma tags em um item de trabalho para palavras-chaves em um registro do ClearQuest.

    Identifique todos os campos que necessitam de transformação e liste os transformadores necessários.

  14. Se o tipo de registro incluir anexos, é possível criar uma regra de sincronização para que quando um registro do ClearQuest for sincronizado com um item de trabalho, todos os anexos para o registro e o item de trabalho também sejam sincronizados. Indica se você planeja sincronizar anexos.
  15. Identifique todos os campos de registro do ClearQuest que planeja sincronizar que sejam campos de tipo de referência. Crie as regras de sincronização para os tipos de registro referenciados por esses campos.
  16. Algum dos campos de registro do ClearQuest que você planeja sincronizar possui ganchos que estabelecem dependências com outros campos? Por exemplo, um gancho associado a um campo pode utilizar o valor que um usuário entra nesse campo para determinar como configurar o valor de outro campo. Neste cenário, identifique a ordem na qual os ganchos devem ser executados para garantir que os campos de registro do ClearQuest estejam configurados para os valores corretos.

    O arquivo cqconnector.properties inclui um parâmetro, cq.orderedProperties.tipo de registro, que pode ser utilizado para especificar a ordem na qual o valor do campo de registro do ClearQuest deve ser configurado. Todos os campos que não desejar especificar com cq.orderedProperties.tipo de registro são processados depois dos campos especificados.

    Outra maneira de especificar a ordem é usar a propriedade Campos Dependentes da Web em campos na definição de formulário no ClearQuest Designer. Se você especificar tanto a propriedade Campos Dependentes da Web e o parâmetro cq.orderedProperties, o ClearQuest Connector utiliza a ordem especificada com o parâmetro cq.orderedProperties.


Feedback

Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro