Importando um Lote de Registros do ClearQuest

O ClearQuest Connector inclui uma ferramenta de Importação que permite criar itens correspondentes em um Repositório do Jazz para um lote de registros do ClearQuest.
Por Que e Quando Desempenhar Esta Tarefa
Por exemplo, você pode usar a ferramenta Importar para criar itens de trabalho do Rational Team Concert que correspondam a um lote de defeitos em um banco de dados do usuário do ClearQuest. Os novos itens de trabalho são sincronizados com os defeitos. As alterações que desejar fazer em um item de trabalho serão propagadas para o defeito correspondente, e as alterações que fizer em um defeito serão propagadas para o item de trabalho correspondente.

A ferramenta Importar utiliza o conjunto de parâmetros configurado no arquivo cqconnector.properties. O Assistente de Configuração do ClearQuest Connector atualiza o arquivo cqconnector.properties com base nas escolhas feitas. Você também pode editar o arquivo cqconnector.properties diretamente para configurar os parâmetros. Consulte Modificando Parâmetros de Serviço do Conector para obter as descrições dos parâmetros. Execute a ferramenta de Importação diversas vezes, uma para cada tipo de registro. Esta abordagem permite verificar se a sincronização de um tipo de registro foi bem-sucedida antes de você prosseguir para o próximo tipo de registro.

Alguns tipos de registro podem ter uma dependência de outros tipos de registro. Você deve executar a ferramenta de Importação nos tipos de registro dos quais outros tipos de registro dependem primeiro. Por exemplo, no esquema DefectTrackingInterop de amostra, a sincronização do tipo de registro Defeito depende do sucesso da sincronização dos tipos de registro Projeto e de registro dos usuários. Assim, utilize a ferramenta de Importação primeiro nos tipos de registro Projeto e de registros dos usuários. Depois de verificar se a sincronização desses tipos de registro foi bem-sucedida, execute a ferramenta de Importação no tipo de registro Defeito.

A sintaxe da ferramenta de Importação é a seguinte:

synctool recordType=nome do tipo de registro
jazzServer=url projectArea=nome da área de projeto 

Para importar registros:

  1. Navegue para o diretório diretório de instalação\gateway.
  2. Execute o comando synctool. A ferramenta de Importação procura pela pasta de consulta que o parâmetro cq.queryTreeRoot nomeia no arquivo cqconnector.properties. Se ela encontrar uma consulta na pasta da área de projetos para o tipo de registro especificado, essa consulta será utilizada para selecionar os registros a serem importados. Se não existir nenhuma consulta, a ferramenta de Importação seleciona todos os registros do tipo de registro. Se você tiver uma grande quantidade de registros do tipo de registro para serem importados, considere a execução da ferramenta de Importação diversas vezes, alterando a consulta toda vez, para que cada chamada selecione um subconjunto da quantidade total. Por exemplo, é possível ajustar a consulta para selecionar registros com base na data de criação. Certifique-se também de definir as consultas de forma a selecionar apenas registros nos quais você planeja trabalhar no Rational Team Concert. Normalmente, pode não ser necessário incluir registros em um estado fechado.

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

    Exemplo, no Windows®:

    synctool recordType="usuários" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz"
    projectArea="Relatando"

    No Linux®, utilize ./synctool para iniciar a linha de comandos.

  3. Abra o cliente do Rational Team Concert e verifique se a ferramenta de Importação criou registros do usuário para os registros do ClearQuest selecionado pela consulta. Na visualização Artefatos da Equipe, expanda a pasta Minhas Áreas de Equipe. Dê um clique duplo em uma área da equipe para abri-la. Na área Membros, clique em Incluir para incluir os novos usuários na área da equipe. Para designar funções aos usuários, selecione cada usuário na tabela Membros e clique em Funções do Processo.
  4. Execute o comando synctool especificando um tipo de registro diferente. Por exemplo, o tipo de registro Projeto.
  5. No cliente do Rational Team Concert, verifique se a ferramenta de Importação criou os itens de categoria correspondentes para os registros do projeto do ClearQuest selecionados pela consulta. Na visualização Artefatos da Equipe, clique com o botão direito do mouse na área de projetos e selecione Abrir. No editor da Área de Projetos, clique na guia Categorias de Itens de Trabalho. Selecione a categoria que corresponde ao registro do projeto do ClearQuest. Selecione a área da equipe que deseja associar à categoria. Clique em Associar. Repita esta etapa para cada categoria que a ferramenta de Importação criou para corresponder aos registros do projeto do ClearQuest. Clique em Salvar para salvar a alteração na área de projetos. Depois de associar uma categoria a uma área da equipe, os itens de trabalho com essa propriedade de categoria são associados à equipe adequada.
  6. Execute o comando synctool especificando um tipo de registro diferente. Por exemplo, o tipo de registro Defeito.
  7. No cliente do Rational Team Concert, verifique se a ferramenta de Importação criou itens de trabalho correspondentes para os defeitos do ClearQuest selecionados pela consulta.
Resultados
Se a ferramenta de Importação selecionar um registro que esteja atualmente sincronizado a uma área de projetos diferente no mesmo Jazz Team Server, ela desconecta esse registro da área de projetos para que possa sincronizar o registro com a área de projetos especificada na linha de comandos.

Feedback

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