Criando Regras de Sincronização

É necessário criar regras de sincronização para os tipos de registro do ClearQuest que você planeja mapear para itens do Rational Team Concert.
Antes de Iniciar

Você pode usar o Assistente de Configuração do ClearQuest Connector para criar regras de sincronização ou modelos de regras de sincronização. No entanto, depois de usar o assistente para gerar regras de sincronização, ainda será necessário revisar e modificar as regras antes de estarem prontas para uso. Este tópico descreve como criar e modificar regras usando o editor de Regra de Sincronização no cliente Eclipse do Rational Team Concert.

Para criar, modificar e excluir regras de sincronização, é necessário estar designado a uma Licença de Acesso do Cliente do ClearQuest Connector ou Developer. Além disso, a área de projetos deve estar configurada para conceder permissões para sua função de usuário. Para configurar as permissões, abra a área de projetos, clique na guia Configuração do Processo, clique em Configuração do Projeto > Permissões e selecione uma função. Em seguida, selecione Conectores de Itens na lista Ações Permitidas.

Certifique-se de iniciar o ClearQuest Gateway antes de criar uma regra de sincronização. Caso contrário, as listas do editor de Regras de Sincronização não serão preenchidas com campos a partir dos tipos de registro do ClearQuest.

Por Que e Quando Desempenhar Esta Tarefa
Consulte Planejamento das Regras de Sincronização para obter detalhes sobre a criação de uma planilha de planejamento antes de criar as regras de sincronização. Além dos tópicos nesta seção, consulte https://jazz.net/wiki/bin/view/Main/WritingSyncRules para obter exemplos do mapeamento dos tipos de campos de registro do ClearQuest para as propriedades do item do Rational Team Concert.

Para criar uma regra de sincronização:

  1. Efetue login no cliente Rational Team Concert.
  2. Na visualização Artefatos da Equipe, clique com o botão direito do mouse na conexão do repositório e selecione Administrar > Regras de Sincronização. Na visualização Regras de Sincronização, clique com o botão direito do mouse na área do projeto e selecione Nova > Regra de Sincronização. Para editar uma regra de sincronização existente, expanda o nó da área do projeto para ver as regras de sincronização. Clique duas vezes em uma regra para abri-la no editor de Regra de Sincronização.
  3. No editor Regra de Sincronização, digite um nome exclusivo para a regra na propriedade Nome. A utilização de uma convenção de nomenclatura semelhante àquela para nomenclatura de pacotes Java™ é uma forma de ajudar a garantir uma nomenclatura exclusiva. Por exemplo: com.sapphire.clearquest.SchemaName.RecordType onde SchemaName é o nome do esquema do ClearQuest e RecordType é o nome do tipo de registro nesse esquema que você deseja sincronizar.
  4. Na seção Mapeamento de Tipo, selecione o tipo de item que deseja sincronizar com o tipo de registro do ClearQuest. A propriedade do gerenciador de Item é configurada para o gerenciador que cria e sincroniza o tipo de item que você selecionou. No campo Repositório externo, selecione a conexão do repositório externo a ser utilizada quando processar esta regra de sincronização. Selecione ClearQuest Manager (registros que não são do usuário) como o Gerenciador externo para todos os tipos de registro, exceto os dos usuários. Para o tipo de registro dos usuários, selecione ClearQuest Manager (registro do usuário). Nota: Como os itens do usuário do Rational Team Concert não pertencem a uma área do projeto, só é possível ter uma regra de sincronização para o tipo de registro de usuários por Jazz Team Server. No campo Tipo Externo, selecione o tipo de registro do ClearQuest que deseja sincronizar com o item do Rational Team Concert.

    Quando um novo item de trabalho é criado, seu campo Tipo é obrigatório. As regras de sincronização que você cria para mapear os tipos de registro para itens de trabalho devem indicar como configurar o valor do campo Tipo do item de trabalho. Consulte Mapeando Tipos de Registro para Tipos de Itens de Trabalho para obter detalhes.

  5. Na seção Áreas de Equipe Ativadas, selecione e cancele a seleção de áreas da equipe para limitar o escopo da regra de sincronização. Por padrão, todos os itens do Rational Team Concert associados a uma área do projeto que possui regras de sincronização são candidatos para sincronização de saída. Você pode desejar criar os registros do ClearQuest somente para itens associados a certas áreas da equipe. Se uma área-pai da equipe for selecionada, todas as áreas-filhas da equipe também serão selecionadas. É possível selecionar uma área-filha da equipe sem selecionar sua área-pai da equipe.
  6. Utilize o campo Contagem de ciclo máxima para especificar a quantidade de ciclos de sincronização que o ClearQuest Connector deve tentar antes da operação de sincronização falhar. Ao gravar uma regra de sincronização para um tipo de registro com estado, selecione Sincronizar todos os estados de itens. Para tipos de registro sem estado, não selecione Sincronizar todos os estados dos itens.
  7. Na seção Mapeamentos de Propriedades especifique quais propriedades do item de trabalho mapear a quais campos de tipo de registro do ClearQuest. Clique em Incluir para criar um mapeamento. Selecione uma propriedade do item e uma propriedade externa correspondente (campo de tipo de registro do ClearQuest). Para mapear um relacionamento de item de trabalho, selecione uma das seguintes propriedades do item: Relacionada, Bloqueios, DependsOn, Pai ou Filha. Em seguida, selecione a propriedade externa que referencia o registro do ClearQuest relacionado. Em vez de incluir um mapeamento por vez, é possível clicar em Inicializar para criar um conjunto inicial de mapeamentos baseado na correspondência, ou correspondência parcial, de nomes de propriedade. Você pode então passar através da lista e remover ou editar mapeamentos conforme a necessidade.

    A seção Detalhes do Mapeamento mostra os detalhes para o mapeamento selecionado na tabela Mapeamentos de Propriedade. Para apagar uma entrada no campo Propriedade do item ou Propriedade externa, selecione Nenhum em Propriedade do Item ou Propriedade Externa. Utilize o campo Sincronização para especificar a direção da sincronização. Entrada/Saída permite a sincronização bidirecional. Entrada ativa a sincronização apenas a partir do banco de dados do usuário do ClearQuest para itens do Rational Team Concert. Saída ativa a sincronização apenas a partir de itens do Rational Team Concert para o banco de dados do usuário do ClearQuest. O Identificador de item é selecionado quando a propriedade é utilizada como a chave de bloqueio para o mapeamento de um item para um registro do ClearQuest. O Identificador Externo é selecionado quando o campo do ClearQuest é usado como chave de consulta para o mapeamento de um registro do ClearQuest para um item do Rational Team Concert. Geralmente, você não deve configurar os campos Identificador de Item e Identificador Externo. Assumindo que o ClearQuest Gateway esteja em execução, o editor de Regras de Sincronização configura esses dois campos quando necessário.

    Por padrão, quando alterações nos registros do ClearQuest são sincronizadas com itens do Rational Team Concert, a operação de atualização é executada usando a conta de usuário do Jazz que o ClearQuest Gateway usa para efetuar login no Repositório do Jazz. O campo Modificador externo permite configurar a regra de sincronização para que as alterações sejam registradas no contexto do usuário que as fez. Consulte Configurando Regras de Sincronização para Usuários Externos para obter detalhes.

    Se o valor da propriedade for uma referência a outro objeto que tenha uma regra de sincronização definida, selecione essa regra de sincronização na lista Regra de sincronização de referência. Por exemplo, se o tipo de registro Defeito do ClearQuest contiver um campo com um a referência para o tipo de registro dos usuários, selecione a regra de sincronização para o tipo de registro dos usuários. Durante a sincronização, a regra de sincronização é processada e uma referência do item do Rational Team Concert para o usuário do Jazz é estabelecida. Se uma propriedade for uma referência para outro item de trabalho, não importa qual regra de sincronização de item de trabalho você especifica como a regra de sincronização de referência. A operação de sincronização utiliza a regra de sincronização correta quando ela determina o tipo do objeto referenciado. Por exemplo, assuma que os tipos de item de trabalho Defeito e Aprimoramento contêm cada um a propriedade DuplicateOf, que é uma referência a outro item de trabalho. O mapeamento de propriedades para DuplicateOf na regra de sincronização Defeito especifica a regra de sincronização Defeito como a regra de sincronização de referência. Da mesma forma, o mapeamento de propriedades para DuplicateOf na regra de sincronização Aprimoramento especifica a regra de sincronização Aprimoramento como a regra de sincronização de referência. Se a operação de sincronização determina que um Defeito é marcado como uma duplicata de um Aprimoramento, ela utiliza a regra de sincronização Aprimoramento.

    Use a seção Transformador de Valor para especificar qualquer manipulação especial que precise ser executada para transformar os dados que estão sendo propagados entre o item do Rational Team Concert e o campo de registro do ClearQuest. Deixe Nenhuma transformação selecionado se não precisar transformar dados. Caso contrário, cancela sua seleção para ativar outros campos. O ClearQuest Connector fornece os seguintes transformadores de valor. É possível incluir transformadores criando extensões de plug-in.

    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.
    Transformador de Tags do Item de Trabalho Transforma tags em um item de trabalho para palavras-chaves em um registro do ClearQuest.

    Alguns transformadores de valor podem necessitar de propriedades adicionais antes deles poderem transformar os dados. Se necessário, clique em Configurar outras propriedades de entrada necessárias pelo transformador, e selecione as propriedades na caixa de diálogo Propriedades Necessárias.

    Utilize a seção Mapeamentos de valores para especificar valores a serem mapeados de itens para registros. Clique em Incluir. Digite um valor de item e o valor correspondente do campo de registro do ClearQuest. Se não houver um mapeamento de um para um de todos os valores, designe um como o valor padrão. Por exemplo, o campo Prioridade do ClearQuest pode ter quatro valores (1, 2, 3 e 4) e a propriedade Prioridade do Team Concert pode ter três valores (Alta, Média e Baixa). Se você mapear Alta tanto para 1 quanto 2, selecione 1 ou 2 como o Valor externo padrão. Para especificar um valor vazio para um campo de registro do ClearQuest, deixe o valor em branco. Em vez de incluir um mapeamento de valor por vez, é possível clicar em Inicializar para criar um conjunto inicial de mapeamentos com base na correspondência, ou correspondência parcial, de nomes do valor. Você pode então passar através da lista e remover ou editar o mapeamento de valores conforme a necessidade.

    O Rational ClearQuest e o Rational Team Concert permitem a identificação de dados e itens duplicados, respectivamente. Para sincronizar duplicatas, mapeie a propriedade do item DuplicateOf para a propriedade Externa original. No campo de regra de sincronização Referência, selecione a regra de sincronização utilizada para itens de trabalho.

  8. Clique em Salvar para salvar seu trabalho.
O que Fazer Depois

A qualquer momento em que você incluir uma regra de sincronização, ou incluir ou remover uma consulta, pare e reinicie o ClearQuest Gateway para que o ClearQuest Connector utilize os novos critérios de sincronização.


Feedback

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