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.
Para criar uma regra de sincronização:
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.
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.
| 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.
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.
Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro