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

Artigo
06/09/2015

Você pode personalizar a maneira que os campos de item de trabalho que são armazenados no Team Foundation são mapeados para os campos que são definidos para Microsoft Project. Você pode alterar a forma como os campos específicos são publicados e designar o tipo de link padrão a ser usado ao criar hierárquica ou links e dependência de á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 um Microsoft Project arquivo, o mapa de campo determina quais campos no banco de dados de item de trabalho correspondem às colunas em Microsoft Project.

Você pode personalizar os mapeamentos, por exemplo, para oferecer suporte a um campo que você criou ou mapear campos para colunas predefinidas em vez de para colunas personalizadas. Para obter a documentação completa sobre o arquivo de mapeamento de campo para Microsoft Project, consulte Adicionar ou alterar como os campos Projeto são mapeados para os campos TFS.

Você pode personalizar o mapeamento modificando o arquivo FileMapping. A tabela a seguir resume os nomes do arquivo, a pasta e o plug-in dos modelos de processo do 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.xml

Nome da pasta:

Classification

Nome do plug-in:

Microsoft.ProjectCreationWizard.Classification

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

Especifique como os campos são mapeados

Especificar campos mapeados usando o Mapping elemento e a estrutura de sintaxe a seguir:

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

A tabela a seguir descreve os atributos do Mapping elemento.

Atributo	Descrição
WorkItemTrackingFieldReferenceName	Obrigatório. Especifica o nome de um campo de referência em um tipo de item de trabalho.
ProjectField	Obrigatório. Especifica o nome de uma coluna em Microsoft Project. Especifica nomes de coluna predefinidos, prefixando "pj" para o nome, como pjTaskName para a coluna Nome da tarefa. Especifique os campos personalizados como pjTaskText seguido de um número, como pjTaskText11.
ProjectName	Opcional. Especifica o nome a ser exibido como o nome da coluna para o usuário. Se esse 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. Os valores válidos são pjMinute, pjHour, pjDay, pjWeek, e pjMonthUnit.
PublishOnly	Opcional. Se definido como true, indica que o campo está publicado no banco de dados do item de trabalho, mas não atualizado. Esse valor normalmente é usado para os 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 como false. Por padrão, apenas Start Date e data de término ter este atributo definido como true.
IfSummaryRefreshOnly	Opcional. Se definido como true, indica que o campo nunca é publicado no banco de dados do item de trabalho, mas é atualizado a partir do banco de dados do item de trabalho quando as seguintes condições também forem verdadeiras: A linha para o campo é uma tarefa de resumo em Microsoft Project. A tarefa de resumo tiver os valores de publicar e atualizar definido como Yes. A tarefa de resumo contém pelo menos uma tarefa filho associado a Team Foundation Server. Todas as atualizações ou cálculos que Microsoft Project torna possível substituir o valor que é atualizado do banco de dados de item de trabalho no plano de projeto. No entanto, o valor modificado nunca é salvo no banco de dados do item de trabalho. Esse atributo normalmente é usado para campos de resumo que, se publicada no banco de dados de item de trabalho, resultar em inconsistências de dados. Se definido como false, indica que o campo pode ser publicado e atualizado. Por padrão, esse atributo é definido como false. Dica O IfSummaryRefreshOnly atributo substitui o PublishOnly atributo.Para obter mais informações, consulte Personalizar o arquivo de mapeamento de campo do Microsoft Project. Por padrão, o IfSummaryRefreshOnly atributo é definido como true para o estimativa Original, trabalho restante, e trabalho concluído campos.

Especifique os campos de sincronização, links e anexos

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

O SyncField elemento Especifica qual coluna atua como o campo de sincronização. O campo de sincronização é intitulado "Publicar e atualizar" e permite que o usuário indicar se uma linha de tarefa é publicada ou atualizada somente.

Você pode usar a seguinte sintaxe XML para especificar qual coluna mapeia para o campo de sincronização. Defina o atributo ProjectField para uma coluna válida 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 de tarefa em particular tem vínculos ou anexos.

Você pode usar a seguinte sintaxe XML para especificar qual coluna mapeia para o campo de links e anexos. Defina 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 modelo MSF for Agile Software Development processo 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

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

Adicionar ou alterar como os campos Projeto são mapeados para os campos TFS

Personalizar o arquivo de mapeamento de campo do Microsoft Project

Share via