Compartilhar via

Analisando um banco de dados ClearQuest

  • 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.]

Na fase de análise, o conversor lê o esquema do banco de dados ClearQuest e gera arquivos que representam o esquema em Team Foundation formato. O conversor usa a consulta ClearQuest para determinar o tipo de entidade base ClearQuest; uma consulta no ClearQuest é baseada no tipo de uma entidade.O conversor também localiza os tipos de entidade associados ao tipo de entidade base.As entidades associadas da entidade base são as entidades ao qual se refere a entidade base.Isso significa que sistema autônomo entidades que estão presentes na entidade base digite sistema autônomo uma referência ou uma lista de referência.Esta lista de entidades que são referenciados exclui o seguinte:

  • Tipos de entidade podem ser referenciados sistema autônomo Duplicar de.

  • Entidade de usuário   Os usuários são migrados de acordo com para o usuário manipular em Team Foundation. Team Foundation não trata sistema autônomo usuários sistema autônomo uma entidade.

  • Entidade de anexo   Anexos são migrados de acordo com para a manipulação de anexo de núcleo de Team Foundation. Team Foundation não trata anexos sistema autônomo uma entidade.

  • Histórico   Histórico é migrado de acordo com o núcleo do histórico de tratamento de Team Foundation. Team Foundation não manipula histórico sistema autônomo uma entidade.

  • Grupos   Conversor não faz a migrar de grupos ClearQuest.Grupos são tratados de maneira diferente em Team Foundation.

  • Ratl_replicas   Esta entidade não tem nenhum conceito de equivalente em Team Foundation.

Fase de análise

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

CQConverter /c:analyze /m:CqConverterConfig.xml

Observação:

Para analisar sua ClearQuest banco de dados, o usuário ID especificado no CqConverterConfig.xml o arquivo deve ter Super usuário permissões.Para obter mais informações, consulte Guia do administrador do ClearQuest.Além disso, você deve ser um membro do Contas de serviço agrupar a especificadoTeam Foundation Server. Para obter mais informações, consulte Team Foundation servidor Permissões.

O Conversor ClearQuest pode levar alguns minutos para concluir a execução.Vários arquivos são gerados no participante da fase de análise.

Conversor de arquivo de configuração

Você deve especificar as entradas para o conversor em um arquivo de configuração.Para obter mais informações, consulte O arquivo de configuração item de trabalho conversor.

Arquivos de saída

A fase de análise gera vários arquivos de saída.Os arquivos são salvos na pasta especificada pelo elemento <outputdirectory>no arquivo de configurações de migração.Se nenhuma pasta for especificada, o conversor cria uma pasta que tem o mesmo nome sistema autônomo o tipo de entidade base ClearQuest.Se a pasta já existir, o Sumário dessa pasta é substituído por novos arquivos xml gerados.

Os seguintes arquivos são criados no participante da fase de análise:

  • Arquivo (s) xml de definição de tipo de item de trabalho   Esses arquivos representam os tipos de itens de trabalho no Team Foundation Formatar e são usados para criar tipos de itens de trabalho em Team Foundation. Um arquivo é gerado para a entidade primária e cada referenciado entidade.Esses arquivos são nomeados sistema autônomo <entitytype>.xml.Por exemplo, um tipo de item de trabalho de defeito gera o arquivo Defect.xml.

  • Arquivo (s) xml de mapeamento de campo   Esses arquivos, especifique como os campos estão mapeados de tipos de registro ClearQuest Team Foundation item de trabalho tipos e as transformações de dados a ser aplicado durante a migração de dados. Esses arquivos têm uma relação um-para-um com os arquivos de tipo de item de trabalho.Cada arquivo de mapeamento de campo especifica o mapeamento para o tipo de item de trabalho correspondente.Esses arquivos são nomeados sistema autônomo <entityname>FieldMap.xml.Por exemplo, o tipo de item de trabalho de defeito gera o arquivo DefectFieldMap.xml.

  • Arquivo de xml de mapeamento de usuário   Este arquivo é nomeado UserMap.xml.Especifica como os usuários ClearQuest são mapeados para Team Foundation usuários. Este arquivo pode ser necessário porque ClearQuest tem um banco de dados de usuário separada e nomes de usuário ClearQuest podem não ser igual a contas de usuário do Windows.Team Foundation requer contas de usuário do Windows.

  • Arquivo de xml do MAP de esquema   Este arquivo é nomeado SchemaMap.xml.O arquivo contém os nomes de todos os arquivos descritos anteriormente e especifica mais mapeamentos entre item de trabalho tipos e arquivos associados.

  • Arquivo de xml de relatório de análise   Este arquivo é nomeado CQAnalysisReport.xml.Uma pasta associada é gerada com este arquivo chamado _AnalysisReport_Files que contém imagens e uma folha de estilos para exibir corretamente esse arquivo em um navegador.

  • Arquivo de log nomeado sistema autônomo CQConverter.log

    Observação:

    Independentemente do número de campos de um determinado item de trabalho selecionados em uma consulta, todos os campos apresentam dentro de um item de trabalho tipo são selecionados pelo conversor para análise.Os arquivos de saída contêm referências para todos os campos.

item de trabalho Tipo de arquivo de definição

Arquivos de definição (WITD) de tipo de item trabalho capturam o esquema de um tipo de item de trabalho em Team Foundation formato. Você pode usar um arquivo WITD para criar um novo tipo de item de trabalho em Team Foundation. Um arquivo WITD Especifica os campos no tipo de item de trabalho, estados e transições de estado, regras e a interface do usuário para exibir o item de trabalho.Para obter mais informações sobre arquivos de definição de tipo de item de trabalho, consulte Personalizando tipos de itens de trabalho.

As seções a seguir detalham como esses tipos de itens de trabalho são gerados.

Mapeamentos de tipo de campo

O conversor mapeia os tipos de campo ClearQuest para tipos de campo apropriado no Team Foundation. A tabela a seguir especifica como os campos estão mapeados.

Tipo de campo ClearQuest

Tipo de campo Foundation equipe

ATTACHMENT_LIST

Não aplicável.Esse tipo de campo é migrado sistema autônomo anexos em vez de um campo em Team Foundation.

DATE_TIME

DateTime

INT

Integer

MULTILINE_STRING

Texto sem formatação

REFERÊNCIA

Não aplicável.Esse tipo de campo é migrado sistema autônomo links em vez de um campo em Team Foundation.

REFERENCE_LIST

Não aplicável.Esse tipo de campo é migrado sistema autônomo links em vez de um campo em Team Foundation.

SEQÜÊNCIA DE CARACTERES CURTA

String

DBID

Não migrado.Esse tipo de campo é reservado para campos de sistema ClearQuest e não é exigido em itens de trabalho migrado.

ID

Seqüência de caracteres.Esse tipo de campo é migrado sistema autônomo um sourceid VSTS field in Team Foundation.

DIÁRIO

Não aplicável.Esse tipo de campo é reservado para campos de sistema ClearQuest e migrado sistema autônomo histórico de Team Foundation.

Estado

Seqüência de caracteres.Esse tipo de campo é reservado para campos de sistema ClearQuest e migrado sistema autônomo o sistema Estado field in Team Foundation.

Mapeamentos do campo

Cada tipo de item de trabalho ClearQuest usa campos de sistema e da mesma forma, existem campos de sistema em Team Foundation tipos de item de trabalho. O conversor mapeia campos de sistema do ClearQuest aos campos do sistema Team Foundation sistema autônomo apropriado. Além dos campos do sistema também são campos que são normalmente encontrados em ClearQuest item de trabalho tipos.O conversor de mapeá-las para Team Foundation campos sistema autônomo apropriado.

A tabela a seguir especifica como o conversor mapeia campos de sistema.

Campo sistema ClearQuest

Equipe Foundation sistema campo

ID

sourceid VSTS

Estado

Estado

A tabela a seguir especifica como o conversor mapeia campos comuns.

Campo ClearQuest

Equipe Foundation sistema campo

Título

Title

Descrição

Descrição

Emissor

Criado por

Submit_Date

Data criada

Owner

Atribuída A

Nome_do_usuário (histórico)

Alterado por

action_timestamp (histórico)

Data alterada

Tratamento de comportamento do campo

Você pode especificar o comportamento em campos na ClearQuest.Você também pode especificar diferentes comportamentos para os campos em diferentes estados de um item de trabalho.O conversor tem limitações para migrar comportamento no ClearQuest itens de trabalho.Por exemplo, o conversor migra o comportamento do campo especificado em estado inicial, ou seja, o estado de um item de trabalho recém-criado.

O comportamento definido estados diferentes não é analisado ou gerado na fase de análise.No entanto, Team Foundation oferece suporte à especificação esses comportamentos e você pode adicionar esses comportamentos manualmente nos tipos de item de trabalho após a fase de análise. Para obter mais informações sobre como personalizar o comportamento para item de trabalho tipos em Team Foundation, consulte Definindo item de trabalho fluxo de trabalho.

Comportamento de item de trabalho é migrado conforme especificado na tabela a seguir.

Comportamento

Descrição

Obrigatório

Esse comportamento é migrado para Team Foundation. Obrigatório é especificado em Team FoundationAplicando o elemento <required>na definição de tipo de item de trabalho.

Optional

Esse comportamento é migrado para Team Foundation. Opcional é o comportamento padrão de um campo em Team Foundation Assim, sem elementos adicionais são necessários na definição de tipo de item de trabalho.

Somente leitura

Esse comportamento não é migrado.

Use_hook

Esse comportamento não é migrado.

Campos adicionados pelo conversor em item de trabalho tipos

O conversor gera os seguintes campos em cada tipo de item de trabalho e também para os campos presentes no seu ClearQuest trabalho tipos de item.

Campos necessários para a operação de conversor

Não remova esses campos.Remover esses campos de item de trabalho tipos faz com que a migração falhar.Você pode removê-los do item de trabalho da interface do usuário (formulário) se não desejar exibi-los.Recomendamos que você mantenha esses campos sistema autônomo somente leitura para impedir que usuários editá-los.sistema autônomo campos são da seguinte maneira:

  • Campo para a ID de ClearQuest de um item de trabalho migrado.

    <FIELD name="vsts sourceid" refname="Microsoft.TeamFoundation.Converters.vsts_sourceid" type="String"/>

  • Campo para o banco de dados ClearQuest de onde veio um item de trabalho migrado.

    <FIELD name="vsts sourcedb" refname="Microsoft.TeamFoundation.Converters.vsts_sourcedb" type="String"/>

  • Campo usado para controlar status de migração de um item de trabalho específico.

    <FIELD name="Migration Status" refname="Microsoft.TeamFoundation.Converters.Migration_Status" type="String"/>

  • Campos do sistema em Team Foundation. Quando o sistema campos em Team Foundation MAP de campos do sistema em ClearQuest, o xml de mapeamento é gerado. Alguns campos do sistema em Team Foundation não são mapeadas para campos de sistema no ClearQuest e gera campos adicionais em cada tipo de item de trabalho. Esses campos são identificados com um comentário semelhante ao seguinte xml:

    <!--State is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

Manipulação de campos de lista

Campos em ClearQuest deve ter um conjunto de valores válido ou sugeridos definidas para eles.Quando o conversor lê os campos e seus tipos, ele também reúne se o campo é um tipo de campo da lista.Se o campo for um tipo de campo de lista, o conversor também coleta os valores de lista válido ou sugerida.Essas informações são capturadas nos arquivos de definição de tipo de item de trabalho na seção campo correspondente.Procure a elementos <allowedvalues>, or <sugggestedvalues>.

Manipulação de estados e transições de estado

Definições de tipo de entidade baseado em estado no esquema ClearQuest suportam a:

  • Um conjunto de estados.

  • Transições entre os estados chamados de ações.

  • Comportamento do campo associado com os estados.

O conversor de captura o ClearQuest estados e ações sistema autônomo estados e transições de estado no Team Foundation definições de tipo de item de trabalho.

Tratamento de formulário item de trabalho

O conversor não migra as informações do formulário do banco de dados ClearQuest para Team Foundation. O conversor gera um formulário de item de trabalho padrão sistema autônomo parte do esquema gerado durante a fase de análise; no entanto, esse formulário padrão é responsável por nenhuma semelhança com o formulário original no ClearQuest.O formulário padrão contém formatação mínima e quase sempre requer edição a ser um layout de item de trabalho mais utilizável.Para obter informações sobre como edição formulários de itens de trabalho, consulte Definir o formulário de itens de trabalho.

Controles do formulário

Você pode colocar vários controles em um formulário de item de trabalho no ClearQuest e também para Team Foundation. Team Foundation oferece suporte a um conjunto predefinido de controles que podem ser usados. Alguns controles disponível no ClearQuest não estão disponível em Team Foundation. Embora a quantidade máxima de dados é preservada durante a migração, a diferença de controles disponível afeta a exibição de dados no formulário em Team Foundation. Não há suporte para os seguintes controles no Team Foundation.

  • Controles ActiveX

  • Controle de Calendário

  • Controle caixa de seleção

  • Controle de caixa de combinação

  • Controle base duplicada

  • Duplicar controle dependentes

  • Controle pai/filho

  • Controle de imagem

  • Controle de botão de ação

  • Controle caixa de listagem

  • Controle de exibição de lista

  • controle de botão de opção

  • Controle de caixa de texto estático

sistema autônomo parte do planejamento de migração, você deve avaliar o efeito que a ausência desses controles pode ter sobre sistema autônomo usuários.

Arquivos de mapeamento de campo

Arquivo de mapeamentos de campo especificar como os campos são mapeados e como os valores são mapeados.

Mapeamento de campo

Especificam os arquivos de mapeamento do campo como campos em ClearQuest são mapeados para Team Foundation campos. A maioria dos campos ClearQuest, exceto para o sistema e campos comuns, são mapeados um-para-um para Team Foundation. Você deve manter esses arquivos de mapeamento de campo em sincronia com as alterações feitas aos campos os arquivos de definição de tipo de item de trabalho.Por exemplo, se você renomear um campo no arquivo de definição de tipo de item de trabalho, você deve alterar o arquivo de mapeamento para especificar o mesmo mapeamento.Da mesma forma, se você excluir alguns campos do arquivo de definição de tipo de item de trabalho, você deve excluir esses campos do arquivo de mapeamento de campo correspondente.

mapeamento de valores

Os arquivos de mapeamento do campo também especificam como os dados do campo para ser transformada durante a migração.Por padrão, nenhum mapeamento de valor é gerado.Você pode especificar os mapeamentos de valores para transformar dados durante a migração.Especificar essas transformações usando mapeamentos de valores de dizer que um valor sistema autônomo "Pri1" deve ser mapeado para "1".

O campo MAP é um arquivo XML.O exemplo a seguir mostra como MAP campos e valores:

<?xml version="1.0"?>

<FieldMaps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <!-- Title is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Headline" to="Title" />

  <FieldMap from="Submitter" to="Submitter">

    <ValueMaps refer="UserMap" />

  </FieldMap>

  <!-- Created Date is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Submit_Date" to="Created Date" />

  <!-- Assigned To is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Owner" to="Assigned To">

    <ValueMaps refer="UserMap" />

  </FieldMap>

</FieldMaps>

Para obter mais informações sobre mapas de campo, consulte Esquema de arquivo de MAP de campo.

O mapeamento para área Path e campos de caminho de iteração

Team Foundation acompanhamento de itens de trabalho organiza os itens de trabalho em uma hierarquia de estruturais áreas e iterações. Para obter mais informações, consulte Como: Modificar as áreas de projeto da equipe e Como: Modificar as Team Projeto iterações.

Caminhos são usados para ajudar a itens do agrupar de trabalho estruturalmente para representar vários componentes, projetos ou sua equipe trabalha em aplicativos.Iterações são usadas para ajudar a agrupar de itens de trabalho de acordo com principais eventos sistema autônomo etapas do projeto e fases de projeto.Os campos de sistema do caminho de iteração e área caminho definem essa informações em Team Foundation. Porque há tal conceito ClearQuest o conversor fornece um valor padrão para esses campos; o padrão é que todos os itens de trabalho passam para a raiz do caminho área caminho iteração.

Embora o ClearQuest não forneça área caminho e o caminho de iteração, talvez você esteja usando os conceitos de alguma Outros maneira.Por exemplo, você pode ter um campo em seus tipos de itens de trabalho que denota o projeto particular que pertence um item de trabalho.Isso corresponde aproximadamente ao conceito de área caminho.Da mesma forma, você pode ter outro campo chamado ‘ fix por ’ que denota etapa da qual você deseja que um item de trabalho determinado para ser corrigido.Considere a possibilidade de mapear esses campos para caminho de rede e caminho de iteração para que os itens de trabalho apareçam nesses nós diferentes em vez de em um nó raiz.sistema autônomo mapeamentos são especificados nos item de trabalho campo mapeamento de arquivos do tipo sistema autônomo explicado anteriormente.

XML mostra o exemplo a seguir como MAP um campo ClearQuest denominado árvore de caminho com valores possíveis de área1 e área2.

<FieldMap from="Tree Path" to="Area Path" exclude="false">

<ValueMaps>

  <ValueMap from="Area1" to="Area1" />

  <ValueMap from="Area2" to="Area2" />

</ValueMaps>

</FieldMap>

O exemplo de XML a seguir mostra como mapear um campo de ClearQuest nomeado fix por possíveis valores de alfa e beta.

<FieldMap from="Fix By" to="Iteration Path" exclude="false">

<ValueMaps>

  <ValueMap from= "Alpha" to="Alpha"/>

  <ValueMap from= "Beta" to="Beta"/>

</ValueMaps>

</FieldMap>

Arquivo de mapeamento de usuário

O arquivo de MAP de usuário Especifica como os usuários são mapeados entre ClearQuest e Team Foundation. Para obter mais informações, consulte Esquema de arquivo de MAP de usuário.

Arquivo de MAP de esquema

O arquivo de MAP de esquema especifica o tipo de item de trabalho de fonte, tipo de item de trabalho de destino, o arquivo de definição de item de trabalho e arquivo de mapeamento de campos.Para obter mais informações, consulte Como: edição o arquivo de MAP de esquema.

Arquivo de relatório de análise

Um arquivo de relatório de análise é gerado no participante da migração.O relatório de migração é denominado CQAnalysisReport.xml e é gerado na pasta a partir de onde CQConverter foi executado.Uma pasta associada chamada _MigrationReport_Files contém os arquivos de imagem e uma folha de estilos para exibir o relatório em um navegador.No participante da análise, você deve em em aberto esse arquivo para exibir os erros ou avisos encontrados durante a fase de análise.O relatório de análise exibe o seguinte:

  • **Resumo   **Informações resumidas sobre a análise de execução.

  • **Erros   **Quaisquer erros encontrados durante a análise de execução.Você deve fazer algo correto de erros listados.

  • **Avisos   **Quaisquer avisos encontrados durante a análise de execução.Avisos requerem sua atenção, mas não são necessariamente algo que deve ser corrigido.

  • Saída   Esta seção lista os arquivos de saída que foram gerados.

Arquivo de log

O conversor gera um arquivo de log chamado CQConverter.log.Este arquivo é usado para depuração e normalmente não é necessário que examinar esse arquivo.O arquivo de log é criado na pasta a partir de onde CQConverter foi executado.Ele contém mensagens de rastreamento e pode ser útil para depuração problemas encontrados durante a execução do conversor.

O nível de rastreamento é controlado configurando o valor de MinLevelForAllSource atributo na CQConverter.exe.arquivo de configuração.O arquivo CQConverter.exe.config está na mesma pasta sistema autônomo CQConverter.exe.Você pode conjunto um valor de 1, que é o mínimo de rastreamento para 4 mais quantidade de rastreamento.

Observação:

Lembre-se de que o conversor de desempenho é mais lento em maiores níveis de rastreamento e o arquivo de log pode GA omo muito grandes.

Arquivo de erros

O conversor também gera um arquivo que contém todos os erros encontrados durante a execução do conversor.O arquivo chamado ConverterErrors.txt e é gerado na mesma pasta de onde CQConverter foi executado.

Consulte também

Tarefas

Como: edição o arquivo de MAP de esquema

Conceitos

O arquivo de configuração item de trabalho conversor

Referência

Esquema de arquivo de MAP de usuário

Outros recursos

Personalizando tipos de itens de trabalho

Definindo item de trabalho fluxo de trabalho

Definir o formulário de itens de trabalho