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:
- 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.
- 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.
- É 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.
- 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.
- 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 . 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.