Compartilhar via

Demonstra Passo a passo: Migrando ClearQuest Work Items para o Team Foundation

  • Artigo

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

Esta explicação passo a passo fornece o processo para mover itens de trabalho ClearQuest para Acompanhamento de item de trabalho do Team Foundation. Team Foundation inclui um utilitário de conversão CQConverter.exe que você pode usar para realizar essa migração.

Nesta explicação passo a passo, você irá realizar as seguintes tarefas:

  • Configurar o processo de migração edição os arquivos de configuração para orientar o processo de migração.

  • Analisar o banco de dados ClearQuest   Execute o Conversor ClearQuest para analisar o banco de dados ClearQuest corrente.A análise produz um relatório e um conjunto de arquivos que descreve o item de trabalho tipos apresentam em ClearQuest.

  • Definir o mapeamento de migração   Edite os arquivos XML gerados durante a análise de banco de dados ClearQuest para personalizar o processo de migração.

  • Migrar seu banco de dados para ClearQuest Acompanhamento de item de trabalho do Team Foundation   Use a configuração e arquivos gerados durante a análise do banco de dados de mapeamento para migrar seus dados.

  • Analise o relatório de migração   Descobrir a causa de quaisquer erros e avisos durante a migração e examine o status de migração.

Pré-requisitos

Para concluir esta explicação passo a passo, é necessário o seguinte software instalado no computador onde você pretende executar CQConverter.exe:

  • Team Explorer

  • Cliente autônomo ClearQuest versão 2003.06.00

    Observação:

    Versões 2002.05.20 e 2003.05.00 também podem funcionar, mas não foram testadas.

Você também deve fazer uma lista de como você deseja que os nomes de usuário ClearQuest mapeados para nomes de domínio do Windows usados por Acompanhamento de item de trabalho do Team Foundation. Certifique-se de que inclui nomes de usuário que não estão sendo usados.

As seguintes informações e conhecimento é útil:

  • Um entendimento básico de XML.

  • Uma lista de como você deseja o MAP de campos de item trabalho em ClearQuest Acompanhamento de item de trabalho do Team Foundation. Inclua informações sobre as transformações são necessários.Por exemplo, você pode mapear um campo de seqüência de caracteres ClearQuest a um campo de número inteiro em Acompanhamento de item de trabalho do Team Foundation.

Permissões necessárias

Para executar esta explicação passo a passo, você deve ser um membro do Contas de serviço agrupar de segurança.Além disso, você deve ser um membro do Leitores segurança do agrupar ou ter o Exibir itens de trabalho nesse nó permissão definido como Permitir.Para obter mais informações, consulte Team Foundation servidor Permissões.Além disso, você deve ter o Super usuário permissão para o banco de dados de ClearQuest.Para obter mais informações, consulte Guia do administrador do ClearQuest.

Tarefas de pré-migração

Antes de iniciar a migração, você deve fazer as seguintes tarefas:

  • Agendar time para bloquear o banco de dados ClearQuest   Uma prática recomendada é bloquear o banco de dados impede que os usuários criem novos itens de trabalho durante o processo de migração.O Conversor ClearQuest não detecta alterações de item de trabalho durante a conversão.Para obter informações sobre bloqueio do banco de dados ClearQuest, consulte a documentação ClearQuest.

  • Create Visual Studio Issue Trackingteam projects   Create team projects and decide which work items go into what team project.Para obter mais informações sobre como criar Acompanhamento de item de trabalho do Team Foundation projetos de equipe, consulte Demonstra Passo a passo: Criando um novo projeto de equipe.

  • Adicione a conta de usuário que você está usando para executar o conversor para o agrupar de contas de serviço   O CQConverter requer permissões de conta de serviço para executar.Adicione a conta de usuário que executará o conversor de Contas de serviço agrupar seuTeam Foundation Server usando o utilitário TFSSecurity. Para obter mais informações, consulte TFSSecurity comandos do utilitário de linha de comando.

Limitações de conversor

Antes de iniciar a migração, você deve examinar as limitações de Conversor ClearQuest e como essas limitações podem afetar os usuários de sua organização.Para obter mais informações, consulte Utilitário de linha de comando para migração de banco de dados ClearQuest CQConverter.

Definições

Os seguintes termos são usados nesta explicação passo a passo:

  • Tipo de item de trabalho   Tipos de itens de trabalho são os blocos de construção básicos de um sistema de acompanhamento do item de trabalho.Exemplos de item de trabalho são tipos de bugs, requisitos e tarefas.

  • Entidade   A unidade básica de dados em ClearQuest.Por exemplo, um defeito pôde ser vinculada a um cliente e pertencer a determinado projeto.O defeito, o cliente e projeto são todas as entidades.

  • Campo   Itens de trabalho contêm campos que contêm informações sobre o item de trabalho.Por exemplo, um item de trabalho defeito pode ter campos sistema autônomo abertas por status, resolução, histórico, links e anexos.

  • Estados   A posição no processo de um item de trabalho pode estar em.Por exemplo, um bug pode ser em aberto, atribuído, Resolved ou Postponed.

  • Comportamento do campo (campo regras)   Especificar como os campos se comportam em diferentes estados.Por exemplo, a Corrigido em campo poderia ser não-editável quando você cria um novo bug, mas quando o bug ao passar o estado de resolvido, a Corrigido em campo pode exigir um valor.

Configurando o processo de migração

Durante esta etapa, você pode alterar os arquivos de configuração do Conversor ClearQuest para orientar o processo de migração.

O arquivo de configuração

O arquivo de configuração é um arquivo XML que fornece configurações para o Conversor ClearQuest.As definições são especificadas nas seções a seguir do arquivo XML:

<clearquest>

A seção ClearQuest contém informações sobre o banco de dados ClearQuest que você deseja migrar.

  • NomeDaConexão   Nome da conexão ClearQuest.

  • UserDatabase   Nome do banco de dados de usuário ClearQuest.

  • QueryName   Nome de uma consulta salva em ClearQuest.

  • UserID   ID de usuário ClearQuest.A ID de usuário especificada deve ter a permissão de superusuário para o banco de dados ClearQuest.

<vsts>

A seção VSTS contém informações sobre o Acompanhamento de item de trabalho do Team Foundation servidor e a equipe de projeto ao qual você está migrando.

  • URI   Team Foundation Server nome amigável ou o URI completo. Por exemplo, "MyAtServer" ou "http://MyAtServer:8080."

  • ProjectName   Acompanhamento de item de trabalho do Team Foundation nome do projeto da equipe.

Outros Configuração configurações

Outras seções no arquivo XML permitem que você especifique as seguintes configurações:

  • ExitOnError   Esta seção aceita um valor true ou false.Especifique True se você deseja interromper o Conversor ClearQuest se ocorrerem erros na migração de alguns itens de trabalho.

    Observação:

    Essa configuração se aplica somente a erros não fatais.Erros fatais, sistema autônomo o ClearQuest conversor não pode se conectar a ClearQuest , o conversor sempre será fechado, mesmo se essa configuração for False.

  • OutputDirectory   Especifique o diretório onde você deseja que os arquivos gerados para ir.Se você não especificar um diretório de saída, o conversor cria um diretório com nome de entidade base para gerar arquivos de saída.Se o diretório já existir, o conversor sobrescreve os arquivos nesse diretório.

Criando o arquivo de configuração

Criar o arquivo de configuração pode ser realizada em qualquer editor de texto, sistema autônomo o bloco de notas.

Para criar o arquivo de configuração

  1. Colete as seguintes informações:

    • Nome da conexão ClearQuest.

    • Nome do banco de dados ClearQuest.

    • ID de usuário administrador ClearQuest e senha.Certifique-se de que este usuário administrador tenha permissões para enviar questões em ClearQuest.

    • Acompanhamento de item de trabalho do Team Foundation nome do servidor.

    • Acompanhamento de item de trabalho do Team Foundation o nome de projeto da equipe (o projeto da equipe ao qual você deseja migrar os itens de trabalho).

  2. Criar uma consulta no Clearquest para selecionar os itens de trabalho que você deseja migrar para Acompanhamento de item de trabalho do Team Foundation e salvar a consulta. salvar a consulta por qualquer nome, por exemplo TransitionQuery.

  3. Escolha um diretório para armazenar os arquivos produzidos durante a fase de análise.

  4. Copie o arquivo de configuração XML a seguir em um editor de texto.

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>AdventureWorksServer</URI>
    <ProjectName>AdventureWorksProject</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. Altere o arquivo para especificar suas configurações com as informações coletadas nas etapas anteriores.Por exemplo, em <queryname>, especifique o nome da consulta sistema autônomo TransitionQuery e incluir o caminho da consulta.Consulte a seção "O arquivo de configuração" anteriormente para obter informações sobre o que cada seção deve conter.

    Observação:

    A senha não for inserida no arquivo, o ClearQuest ferramenta pergunta posteriormente no processo de migração.

  6. Salve o arquivo.

    Por exemplo, pode salvá-lo sistema autônomo CqConverterConfig.xml.

Analisando o banco de dados ClearQuest

Durante a análise do seu banco de dados de ClearQuest ClearQuest para Team Foundation Conversor de seu banco de dados ClearQuest analisa e cria os seguintes arquivos XML:

  • A Acompanhamento de item de trabalho do Team Foundation arquivo de definição (WITD) de tipo de item para cada tipo de entidade ClearQuest que contém sistema autônomo estados, transições de estado, campos, tipos de campo e comportamento do campo sistema autônomo obrigatórios ou opcionais de trabalho.

  • Um arquivo de mapeamento de campo padrão que mapeia ClearQuest campos e valores para Acompanhamento de item de trabalho do Team Foundation campos e valores.

  • Um arquivo de MAP de usuário que mapeia usuários ClearQuest para usuários do Windows.Esse arquivo se aplica a todo o sistema.

  • Um arquivo de MAP de esquema que contém referências para outros arquivos fieldMap e arquivos XML, sistema autônomo, por exemplo, o arquivo SchemaMap que contém sistema autônomo nomes de entidade e o arquivo de mapeamento de campo que tem o caminho dos nomes de arquivo gerados WorkItem.

  • Um relatório e um aviso de arquivo (CQAnalysisReport.xml).

Para analisar o banco de dados ClearQuest

  1. No Visual Studio 2008 Command aviso, execute o seguinte comando:

    /C CQConverter.exe: analisar /m:CqConverterConfig.xml

    O Conversor ClearQuest pode levar alguns minutos para concluir a execução.

    Observação:   Para obter mais informações sobre os comandos do Conversor ClearQuest, consulte Utilitário de linha de comando para migração de banco de dados ClearQuest CQConverter.

  2. No diretório de saída que você especificou no arquivo de configuração, procure os seguintes arquivos XML.Esses arquivos são usados posteriormente no processo de migração:

    • Um arquivo WITD para cada tipo de entidade ClearQuest nomeado sistema autônomo EntityName.xml.Por exemplo, um arquivo para a entidade ClearQuest defeito seria nomeado Defect.xml.

    • Um arquivo de mapeamento de campo para cada tipo de entidade ClearQuest.Esses arquivos, especifique como os campos e valores de campo em cada entidade ClearQuest serão mapeadas para os campos correspondentes na Acompanhamento de item de trabalho do Team Foundation tipo de item de trabalho. Por exemplo, um arquivo para a entidade ClearQuest defeito seria nomeado DefectFieldMap.xml.

    • Um arquivo usermap.Um arquivo especificando como os usuários ClearQuest devem ser mapeado para Acompanhamento de item de trabalho do Team Foundation usuários.

    • Um arquivo schemamap.xml.Um arquivo que descreve os mapeamentos de esquema e de campo.

  3. No diretório onde você executou o conversor, procure o arquivo CQAnalysisReport.xml ver os avisos e erros antes da migração.

Definir o mapeamento de migração

Análise gera um conjunto de arquivos que captura as informações do banco de dados ClearQuest.Talvez seja necessário alterar alguns desses arquivos para migrar o banco de dados da maneira desejada.Na pior das hipóteses, você precisa alterar o arquivo de mapeamento de usuário e o arquivo de definição de tipo de item de trabalho.

Para obter mais informações sobre como modificar o arquivo de definição de um tipo de item de trabalho, consulte Demonstra Passo a passo: Fazer personalizações Basic um tipo de item de trabalho.

Editando o arquivo de mapeamento de esquema

Para alterar o arquivo schemamap.xml

  1. Abra o arquivo Schemamap.xml.

    Segue um exemplo deste arquivo:

    <Mappings>
  <SchemaMaps>
    <SchemaMap SourceEntity="Defect" TargetWIT="Defect"
      WITDFile="Defect.xml" FieldMapFile="DefectFieldMap.xml"/> 
    <SchemaMap SourceEntity="Customer" TargetWIT="Customer"
      WITDFile="Customer.xml" FieldMapFile="CustomerFieldMap.xml"/> 
  </SchemaMaps>
  <UserMap File="UserMap.xml" /> 
</Mappings>

  2. Altere sistema autônomo seções a esse arquivo conforme apropriado.

    • SourceEntity   Verifique esta seção contém a entidade ClearQuest correta.

    • TargetWIT   Verifique essa seção aponta para o tipo de item de trabalho correto que deve ser criado em Acompanhamento de item de trabalho do Team Foundation.

    • WITDFile   Esta seção especifica a definição de tipo de item de trabalho arquivo XML (WITD).

    • FieldMapFile   Esta seção especifica o arquivo XML de mapeamento de campo.

    • UserMap   Esta seção especifica o arquivo XML de mapeamento de usuário.

Editando o arquivo de mapeamento de usuário

O Conversor ClearQuest usa o arquivo de mapeamento de usuário para mapear identificações de usuário no banco de dados ClearQuest um equivalente Acompanhamento de item de trabalho do Team Foundation ID de usuário. Isso ajuda a preservar o histórico do item de trabalho, convertendo os valores do campo ID usuário sejam os valores válido em Acompanhamento de item de trabalho do Team Foundation. Acompanhamento de item de trabalho do Team Foundation usa IDs de usuário de domínio do Windows.

Uma versão padrão desse arquivo é gerada pelo Conversor ClearQuest durante a fase de análise.Certifique-se de que esse arquivo esteja preciso antes de prosseguir com a conversão porque o conversor verifica esse arquivo e falha se houver problemas.

Para alterar o arquivo de mapeamento de usuário

  1. Abra o arquivo usermap.xml.Uma amostra a seguir:

    <UserMappings">
  <UserMap From="admin" To="admin" />
  <UserMap From="user" To="user" />
  <UserMap From="QE" To="QE" />
  <UserMap From="lead" To="lead" /> 
  <UserMap From="engineer" To="engineer" />
</UserMappings>

  2. Examine sistema autônomo mapeamentos de usuário e corrigir, adicionar e excluir conforme necessário.O lado "para" o mapeamento de usuário deve ser um existenteTeam Foundation Server usuário.

  3. In Acompanhamento de item de trabalho do Team Foundation, adicione todos os usuários especificados no arquivo de mapeamento de usuário. Para obter mais informações sobre como adicionar usuários, consulte Como: Adicione usuários a um projeto da equipe agrupar.

    Observação:

    Se desejar que qualquer um do ClearQuest usuários sejam mapeados sistema autônomo está em Team Foundation Server durante a migração, você pode excluir as linhas no arquivo de mapeamento de usuário para os usuários. Se você não quiser que qualquer mapeamento do usuário realizado, você pode excluir todas as linhas especificando mapas de usuário na seção <usermap>.Você deve excluir apenas o indivíduo entradas na seção <usermap>- não exclua a seção ou quaisquer outras partes do arquivo.
    Cuidado:

    Se os usuários são mapeados para válido Team Foundation Server os usuários durante a migração, talvez seja necessário corrigir os campos de usuário em seus itens de trabalho ao começar a trabalhar com eles. O conversor é executado sem validar sistema autônomo valores de campo, mas assim que começar a edição de itens de trabalho, você será solicitado para fornecer usuários válido para sistema autônomo campos do usuário.

Editando o arquivo de mapeamento de campo

O Conversor ClearQuest usa os arquivos de mapeamento de campo para mapear campos em cada entidade ClearQuest para um equivalente Acompanhamento de item de trabalho do Team Foundation campo de item de trabalho.

Para alterar o arquivo de mapeamento de campo

  1. em aberto um dos arquivos de mapeamento de campo.Por exemplo, abra DefectFieldMap.xml.Uma amostra a seguir:

    <FieldMap from="Criticality" to="Severity">
  <ValueMaps>
        <ValueMap from="1-Critical" to = "1"/>
        <ValueMap from="2-Major" to = "2"/>
  </ValueMaps>
</FieldMap>

  2. Revise as linhas de mapeamento de campo (a partir de ValueMap) e certifique-se de que o campo indicado após "de"é mapeado para o campo correto após"para." Você pode adicionar mais mapeamentos de campo adicionando mais ValueMap linhas.Os valores devem ser na lista de valores permitidos se tiver sido especificado no arquivo de esquema, nesse caso, defect.xml.

    Observação:

    Se você alterar os mapeamentos de campo, certificar-se de que os campos obrigatórios do formulário de item de trabalho estão mapeados

  3. em em aberto outros arquivos de mapeamento de campo e editá-los conforme apropriado.

Definindo uma definição de tipo de item de trabalho

Após a fase de análise, o conversor gera definições de tipo de item de trabalho (WITDs) para cada tipo de registro ClearQuest.Por exemplo, um arquivo para o tipo de registro ClearQuest defeito é chamado Defect.xml.O conversor gera um formulário de item de trabalho padrão sistema autônomo parte de geração de esquema durante a fase de análise.No entanto, esse formulário padrão contém formatação mínima e quase sempre será necessário editar para que o layout de item de trabalho que você deseja.Para obter informações sobre como alterar o arquivo de definição de um tipo de item de trabalho, consulte Demonstra Passo a passo: Fazer personalizações Basic um tipo de item de trabalhoe Demonstra Passo a passo: Fazer personalizações Avançados em um tipo de item de trabalho.

Migrando os ClearQuest Work Items

Para migrar os itens de trabalho

  1. No Visual Studio 2008 Command aviso, execute o seguinte comando:

    /C CQConverter.exe: migrar /m:CqConverterConfig.xml/s: caminho \Schemamap.xml

    Em que caminho é o caminho para o arquivo de MAP de esquema.O arquivo de MAP de esquema é gerado durante a fase de análise no diretório de saída especificado.

    Observação:

    O ClearQuest conversor pode levar horas para concluir a execução para grandes bancos de dados.
    Observação:

    Para obter mais informações sobre ClearQuest Conversor de comandos, consulte Migrando do ClearQuest.

  2. Quando a migração estiver concluída, analise o relatório de migração para o status da migração e outras questões sistema autônomo defeitos não migrar devido a inconsistências de mapeamento de campo.

    O relatório de migração é denominado CQMigrationReport.xml e criado na pasta do qual executou o Conversor ClearQuest.

    Observação:

    Desde que o conversor converte todos os itens de trabalho incluídos na consulta que você especificar, além de todos os itens de trabalho vinculadas a partir dos itens de trabalho, o número real de trabalho itens migrados pode ser diferente do número de itens de trabalho na consulta.

  3. Se todos os itens de trabalho não tenham sido migrados, você pode executar a conversão novamente após solucionar os problemas descritos no relatório de migração.

A migrar de mais itens de trabalho de ClearQuest para Acompanhamento de item de trabalho do Team Foundation, você pode executar novamente o processo de migrar.

Para executar a migração novamente no mesmo banco de dados ClearQuest

  1. Corrija os problemas descritos no relatório de migração para a migração anterior.

  2. Faça uma consulta em ClearQuest retorna os itens de trabalho desejado ou executar a mesma consulta, se você quiser migrar itens de trabalho que não migração pela primeira vez.

  3. Alterar o <queryname> seção no arquivo de configuração para especificar o nome da nova consulta.

  4. Abra o aviso de comando do Visual Studio 2008 e digite o comando para migração:

    /C CQConverter.exe: migrar /m:CqConverterConfig.xml/s: caminho \Schemamap.xml

    O Conversor ClearQuest pode levar horas para concluir a execução para grandes bancos de dados.

    Observação:

    Para obter mais informações sobre ClearQuest Conversor de comandos, consulte Migrando do ClearQuest.

  5. Quando a migração estiver concluída, analise o relatório de migração para o status da migração.O relatório de migração é denominado CQMigrationReport.xml e criado na pasta do qual executou o Conversor ClearQuest.

Verificando a migração de item de trabalho

Após a migração, você pode examinar alguns dos itens de trabalho migrados para verificar as informações foi migradas com êxito.

Para verificar os itens de trabalho migrados

  1. Abra um item de trabalho migrado em Acompanhamento de item de trabalho do Team Foundation.

  2. Use o número no campo ClearQuest ID para comparar o Acompanhamento de item de trabalho do Team Foundation item de trabalho com o bug ClearQuest com a mesma ID.

Para localizar o item de trabalho do Team Foundation correspondente a um item de trabalho específico ClearQuest

  1. Crie uma consulta de item de trabalho com a seguinte clásula de consulta:

    E/ou

    Campo

    Operador

    Valor

     

    SourceID VSTS

    =

    ID do item de trabalho ClearQuest

    The SourceID VSTS campo corresponde ao rótulo do campo ClearQuest ID que você vê no seu formulário de item de trabalho.

    Para obter mais informações sobre como criar consultas de itens de trabalho, consulte Como: Adicionar Novo consultas de item de trabalho.

  2. Execute a consulta.

Consulte também

Tarefas

Demonstra Passo a passo: Controle de itens de trabalho

Outros recursos

Explicações passo a passo de migração