Mapear os campos do Microsoft Project para os campos do Team Foundation

Você pode personalizar a maneira em que o trabalho item campos que são armazenados em 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 utilizar quando você criar hierárquica ou links de árvore e links de dependência.

Ao contrário do Microsoft Excel, Microsoft Project usa um conjunto limitado de colunas, que incluem colunas predefinidas, como, por exemplo, nome da tarefa e campos personalizados.Quando um usuário publica ou dados de item de trabalho de atualizações um Microsoft Project o arquivo, omapa do campodetermina quais campos o itemde trabalhobanco de dados correspondem a colunas na Microsoft Project.

Você pode personalizar os mapeamentos, por exemplo, para dar suporte a um campo que você criou ou mapa campos para predefinidos colunas em vez de colunas personalizadas.Para obter a documentação completa sobre o arquivo demapeamento de campopara Microsoft Project, consulte Personalizar os mapeamentos de campo do Microsoft Project.

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

Nome do arquivo:

FileMapping

Nome da pasta:

Classificação

Nome do plug-in:

Microsoft.ProjectCreationWizard.Classification

Para mais informações, consulte Definir as áreas iniciais e as iterações no plug-in de classificação.

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ê especifica campos mapeados usando o Mapping elemento e a seguinte estruturade 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

Necessário.Especifica o nome de referência de um campo em um tipo de itemde trabalho.

ProjectField

Necessário.Especifica o nome de uma coluna em Microsoft Project.Especifica nomes de coluna predefinidos por meio da prefixação "pj" do nome, como, por exemplo, pjTaskName para a coluna Nome da tarefa.Especifique campos personalizados como pjTaskText, seguido de 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ê mapa 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 para o itemde trabalhobanco de dados , mas não atualizado. Esse valor é normalmente usado para campos calculados que não devem ser atualizados em Team Explorer.Se definido como false, indica que o campo é publicada e atualizada.Por padrão, esse atributo é definido como 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 é publicado para o itemde trabalhobanco de dados , mas são atualizados do itemtrabalhobanco de dados de quando as condições a seguir também são verdadeiras:

  • A linha para o campo é umatarefa de resumoem Microsoft Project.

  • Atarefa de resumopossui os valores de publicação e atualização é definido como Yes.

  • Atarefa de resumocontém pelo menos um filhotarefa que é limite ao Team Foundation Server.

Quaisquer atualizações ou cálculos que Microsoft Project torna pode substituir o valor que é atualizado do itemtrabalhobanco de dados de no plano de projeto . No entanto, o valor modificado nunca é salvo para o itemde trabalhobanco de dados. Esse atributo é normalmente usado para campos de resumo que, se publicada para o itemde trabalho dobanco de dados, gerar inconsistências de dados.

Se definido como false, indica que o campo pode ser tanto publicadas e atualizadas.Por padrão, esse atributo é definido como false.

ObservaçãoObservação
O IfSummaryRefreshOnly atributo substitui o PublishOnly atributo. Para 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.

Além de Mapping outros dois elementos de elemento, determinam como campos irá sincronizar e qual campo oferecerá suporte a links e anexos.

O SyncField elemento especifica qual coluna serve como o campode 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 campode de sincronização.Você definir o atributo do ProjectField para uma coluna válido na Microsoft Project.

<SyncField ProjectField="" />

O LinksField elemento Especifica a coluna de 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 mapeia para o campode anexos e links.Você definir o atributo do ProjectField para uma coluna válido na Microsoft Project.

<LinksField ProjectField="" />

Mapeamentos de campo padrão

O exemplo a seguir mostra como o MSF for Agile Software Development processomodelo mapeia 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

Definir as áreas iniciais e as iterações no plug-in de classificação

Personalizar os mapeamentos de campo do Microsoft Project

O arquivo de mapeamento de campo do Microsoft Project

Personalizar as áreas funcionais em um modelo de processo