Durante a sincronização de entrada, a propriedade Categoria de um item de trabalho deve ser
configurada porque o item de trabalho está associado a uma área de equipe baseada na sua categoria. A
propriedade Categoria aparece como Alteração Arquivada para no editor de Itens de Trabalho e
editor de Regras de Sincronização.
Por Que e Quando Desempenhar Esta Tarefa
É 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
Para conectar um registro sem estado com uma categoria:
Mostrar para
Mim
- Crie um ou mais registros de um tipo de registro sem estado do
ClearQuest, como
Projeto, que corresponde razoavelmente ao significado da categoria. Certifique-se de que o tipo de registro
que desejar sincronizar tenha um campo onde os usuários indicam o tipo de Projeto (ou outro tipo de registro
sem estado) ao qual o registro pertence. Por exemplo, o tipo de registro Defeito contém um campo Projeto.
- Crie uma regra de sincronização para o tipo de registro sem estado, como Projeto. Configure o Tipo de Item para Categoria -
com.ibm.team.workitem. Na seção Mapeamentos de Propriedades, mapeie no mínimo a propriedade externa Nome para a propriedade do item
Nome.
Clique em
Salvar para salvar a regra de sincronização.
- Abra a regra de sincronização para o tipo de registro, como Defeito, que deseja sincronizar com os itens
de trabalho. Na seção Mapeamentos de Propriedade, clique em Incluir. Selecione Alteração Arquivada para para a propriedade Item. Para a propriedade Externa,
selecione o nome do campo que é uma referência para o tipo de registro sem estado que você criou (por
exemplo, Projeto). No campo Sincronização, selecione
Entrada/Saída para ativar a sincronização bidirecional.
No campo Regra de
sincronização de referência, selecione a regra de sincronização que você criou para o tipo de
registro sem estado.
- Clique em OK. Clique em
Salvar para salvar suas alterações.
Para mapear um ou mais campos com valor de cadeia do registro do
ClearQuest para uma
categoria:
- Na seção Mapeamentos de Propriedades da regra de sincronização para o tipo de registro, selecione
Alteração Arquivada para para a propriedade Item. Selecione o campo do
ClearQuest para a
propriedade Externa. É possível utilizar múltiplos campos do
ClearQuest para compor
um valor multinível que corresponda à propriedade categoria. Por exemplo, você pode ter um campo chamado
Projeto e outro campo chamado Subprojeto.
Especifique esta hierarquia na propriedade Externa separando os
nomes de campo por uma barra. Por exemplo, Projeto/Subprojeto.
- Cancele
a seleção de Nenhuma Transformação. Na lista de Transformadores de valor,
selecione Transformador de Categoria do Item de Trabalho.
É possível especificar mapeamentos de valores para o mapeamento de propriedade que utiliza o transformador de valor Transformador
de Categoria do Item de Trabalho. Na direção de
entrada, o ClearQuest Connector aplica
o mapeamento de valor antes da transformação. O Valor Externo deve ser
uma simples referência de campo; o nome do campo não pode conter um ponto (.)
ou uma barra (/). É possível mapear um valor de campo que deva ser interpretado
como o nome ou o caminho de uma categoria de item de trabalho para algum outro nome
ou caminho de categoria. Na direção de saída, o ClearQuest Connector aplica
o mapeamento de valor após a transformação para que o caminho da categoria do item de
trabalho possa ser mapeado para alguma outra cadeia.
- Clique em Salvar para salvar suas alterações.
Para mapear um valor externo para um valor de categoria fixo:
- Na seção Mapeamentos de Propriedades da regra de sincronização para o tipo de registro, selecione
Alteração Arquivada para para a propriedade Item. Insira um nome de campo não existente, como Simulado, para a propriedade Externa. Na seção Detalhes do Mapeamento, configure Sincronização para Entrada.
- Cancele
a seleção de Nenhuma Transformação. Na lista de Transformadores de valor,
selecione Transformador de Categoria do Item de Trabalho.
Inclua um mapeamento na seção Mapeamentos de Valores. Deixe o Valor Externo em branco. Para o Valor do Item, insira o nome da categoria que deseja configurar em cada operação de sincronização recebida que cria um item de trabalho.
- Clique em Salvar para salvar suas alterações.
Par mapear um ou
mais registros do
ClearQuest com uma
categoria:
- Crie uma regra de sincronização para cada tipo de registro que contribua com um valor de campo para a
propriedade do item que o tipo de registro-pai utiliza para mapear para uma categoria. Por exemplo, você pode
compor a propriedade do item combinando os valores do campo Nome nos tipos de registro Projeto e Subprojeto. O tipo de registro-pai, como Defeito, contém dois campos que são referências para os registros Projeto e
Subprojeto. Neste exemplo, você cria as regras de sincronização para os tipos de registro Projeto e Subprojeto. No editor
de Regras de Sincronização, deixe o campo Tipo de item em branco. Como esse tipo de registro contribui apenas com um nome para o tipo de registro-pai, ele não é conectado a nenhum item do Rational Team Concert.
No campo Tipo
externo, selecione o tipo de registro para o qual você está criando a regra de sincronização. Na seção Mapeamentos de Propriedades, digite o nome do campo no campo Propriedade
externa. Por exemplo, Nome. Selecione Identificador externo.
- Clique em Salvar para salvar suas alterações.
- Na regra de sincronização para o tipo de registro-pai (neste exemplo, Defeito), clique em
Incluir para incluir um mapeamento de propriedades. Selecione Alteração Arquivada para no campo Propriedade do item. No campo Propriedade externa, digite um valor que identifica os campos de referência
no tipo de registro-pai e os campos nos tipos de registro referenciados. Utilize um ponto para separar o
campo de referência no tipo de registro-pai do campo no tipo de registro referenciado. Utilize uma barra para
separar os campos de referência no tipo de registro-pai. Por exemplo, Projeto.Nome/Subprojeto.Nome onde
Projeto e Subprojeto são campos de referência no tipo de registro Defeito que aponta para os registro Projeto
e Subprojeto, respectivamente. Cada tipo de registro Projeto e Subprojeto contém um campo Nome. No campo
Sincronização, selecione Entrada/Saída.
Na seção Transformação de valor, cancele a seleção de Nenhuma
transformação. Selecione o Transformador de Categoria de Item de Trabalho.
Conforme descrito no cenário anterior,
é possível especificar mapeamentos de valores para o mapeamento de propriedade que utiliza
o transformador de valor Transformador de Categoria do Item de Trabalho.
Você também precisa incluir mapeamentos de propriedades para os campos de referência (neste exemplo, Projeto
e Subprojeto). Clique em Incluir na seção Mapeamentos de
Propriedades. Deixe a Propriedade do Item em branco. Selecione um dos
campos de referência (por exemplo, Projeto) na Propriedade Externa.
No campo
Sincronização, selecione nenhuma.
No campo Regra de
sincronização de referência, selecione a regra de sincronização que você criou para o qual o tipo
de registro está apontado pelo campo de referência. Neste exemplo, o campo Projeto é uma referência a um registro Projeto. O tipo de registro Projeto possui uma
regra de sincronização. Inclua um mapeamento para o segundo campo de referência (neste exemplo, Subprojeto).
- Clique em Salvar para salvar suas alterações.
É possível uma
variação do cenário anterior. O campo no tipo ou tipos de registro-filho podem ser uma referência, em vez de
um campo com valor de cadeia, para outro registro. É possível ter uma cadeia de referências antes de atingir
o registro que contém o campo com valor de cadeia. Crie uma regra de sincronização para cada tipo de registro
na cadeia de referências. Na regra de sincronização para o tipo de registro-pai, selecione
Alteração Arquivada para no campo Propriedade do item. No campo
Propriedade externa, digite um valor que identifica a cadeia de referências e o campo
com valor de cadeia no final do caminho. Especifique o valor como uma seqüência de nomes de campos separados
por pontos (.). Esta variação é suportada somente pela sincronização de entrada.