O mapeamento de campos do Microsoft Project para campos do Team Foundation

Artigo
08/01/2011

Você pode personalizar a maneira como os campos de item de trabalho que estão armazenadas no Team Foundation são mapeados para campos que são definidos para Microsoft Project. Você pode alterar a maneira como os campos específicos são publicados e designar o tipo de link padrão para usar ao criar hierárquica ou links e links de dependência da árvore.

Ao contrário de Microsoft Excel, Microsoft Project usa um conjunto limitado de colunas, que incluem colunas predefinidas, como o nome da tarefa e campos personalizados. Quando um usuário publica ou atualizações de item de trabalho dados de um Microsoft Project arquivo de mapa de campos determina quais campos no banco de dados de item de trabalho correspondem a colunas na Microsoft Project.

Você pode personalizar os mapeamentos, por exemplo, para dar suporte a um campo que você criou ou mapear campos para colunas predefinidas, em vez de colunas personalizadas. Para a documentação completa sobre o arquivo de mapeamento de campo para Microsoft Project, consulte Personalizando os mapeamentos de campo do Microsoft Project.

Você pode personalizar o mapeamento modificando o arquivo FileMapping. A tabela a seguir resume os nomes de arquivo, pasta e o plug-in para os modelos de processo para o Microsoft Solutions Framework (MSF). O plug-in contém a definição da tarefa que carrega o arquivo para a coleção de projeção de equipe.

Nome do arquivo:

FileMapping

Nome da pasta:

Classificação

Nome do plug-in:

Microsoft.ProjectCreationWizard.Classification

Para obter mais informações, consulte Definindo as áreas de iniciais e iterações usando o arquivo de plug-in do Classification.xml.

Neste tópico

Especificando como os campos são mapeados
Especificando os campos usados para sincronização, Links e anexos
Mapeamentos de campo padrão

Especificando como os campos são mapeados

Você especificar campos mapeados usando o Mapping elemento e a seguinte estrutura de sintaxe:

<Mappings>
   <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
            ProjectField=""
            ProjectName=""
         ProjectUnits=""
         PublishOnly=""
         IfSummaryRefreshOnly=""/>
</Mappings>

A tabela a seguir descreve os atributos da Mapping elemento.

Atributo	Descrição
WorkItemTrackingFieldReferenceName	Obrigatório. Especifica o nome de referência de um campo em um tipo de item de trabalho.
ProjectField	Obrigatório. Especifica o nome de uma coluna em Microsoft Project. Especificar nomes de coluna predefinidos por meio da prefixação "pj" para o nome, como, por exemplo, pjTaskName para a coluna Nome da tarefa. Especifique campos personalizados como pjTaskText, seguido por um número, como, por exemplo, pjTaskText11.
ProjectName	Opcional. Especifica o nome para exibir como o nome da coluna para o usuário. Se este atributo não for especificado, o nome do campo no tipo de item de trabalho é usado.
ProjectUnits	Opcional. Especifica o tipo de unidades a serem usadas quando você mapeia um tipo de campo para Microsoft Project. Valid values are pjMinute, pjHour, pjDay, pjWeek, and pjMonthUnit.
PublishOnly	Opcional. Se definido como true, indica que o campo é publicado no banco de dados de item de trabalho, mas não atualizado. Esse valor geralmente é usado para campos calculados que não devem ser atualizados em Team Explorer. Se definido como false, indica que o campo é publicado e atualizado. Por padrão, esse atributo é definido false. Por padrão, apenas Data de início e Data de término do ter este atributo definido como true.
IfSummaryRefreshOnly	Opcional. Se definido como true, indica que o campo nunca será publicado no banco de dados de item de trabalho, mas são atualizados do banco de dados de item de trabalho, quando as condições a seguir também são verdadeiras: A linha para o campo é uma tarefa de resumo em Microsoft Project. A tarefa de resumo possui os valores de publicar e atualizar definido como Yes. A tarefa de resumo contém pelo menos uma tarefa filho que está vinculada a Team Foundation Server. Quaisquer atualizações ou cálculos que Microsoft Project torna possível substituir o valor que é atualizado a partir do banco de dados de item de trabalho no plano de projeto. No entanto, o valor modificado nunca é salvo no banco de dados de item de trabalho. Esse atributo é normalmente usado para campos de resumo que, se publicada no banco de dados de item de trabalho, levam a inconsistências de dados. Se definido como false, indica que o campo pode ser publicado e atualizado. Por padrão, esse atributo é definido false. Observação O IfSummaryRefreshOnly atributo substitui o PublishOnly atributo.Para obter mais informações, consulte O arquivo de mapeamento de campo do Microsoft Project. Por padrão, o IfSummaryRefreshOnly atributo está definido como true para o Estimativa Original, Trabalho restante, e Trabalho concluído campos.

Especificando os campos para sincronização, Links e anexos

Além de Mapping outros dois elementos de elemento, determinam como os campos serão sincronizados e qual campo oferecerá suporte a links e anexos.

O SyncField elemento especifica qual coluna serve como o campo de sincronização. O campo de sincronização é intitulado "Publicar e atualizar" e permite ao usuário indicar se uma linha de tarefa é publicada ou atualizada apenas.

Você pode usar a seguinte sintaxe XML para especificar qual coluna mapeado para o campo de sincronização. Você definir o atributo ProjectField para uma coluna válida na Microsoft Project.

<SyncField ProjectField="" />

O LinksField elemento Especifica a coluna links e anexos. Usando a coluna de links e anexos, os usuários podem indicar se uma linha determinada tarefa tem links ou anexos.

Você pode usar a seguinte sintaxe XML para especificar qual coluna mapeado para o campo de anexos e links. Você definir o atributo ProjectField para uma coluna válida na Microsoft Project.

<LinksField ProjectField="" />

Mapeamentos de campo padrão

O exemplo a seguir mostra como o MSF para o modelo de processo de desenvolvimento de Software ágil mapeia os campos em itens de trabalho para colunas em Microsoft Project.

<?xml version="1.0" encoding="utf-8"?>
<MSProject>
  <Mappings>
    <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" />
    <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="Work Item ID" />
    <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" />
    <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="State" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" />
    <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="Work Item Priority" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
    <LinksField ProjectField="pjTaskText26" />
    <SyncField ProjectField="pjTaskText25" />
  </Mappings>
</MSProject>

Consulte também

Conceitos

Definindo as áreas de iniciais e iterações usando o arquivo de plug-in do Classification.xml

O arquivo de mapeamento de campo do Microsoft Project

Personalizando as áreas funcionais dentro de um modelo de processo

Outros recursos

Personalizando os mapeamentos de campo do Microsoft Project

Partilhar via