Partilhar via


O arquivo de mapeamento de campo do Microsoft Project

Você pode personalizar como campos que são definidos para itens de trabalho no mapa de Team Foundation a campos em Microsoft Project, e você pode alterar como campos específicos são publicados.No arquivo de mapeamento de campo para Microsoft Project, você pode definir mapeamento entre campos em Team Foundation e em Microsoft Project.Microsoft Project inclui campos predefinidos, como o nome da tarefa, e campos personalizados.Quando você publica ou atualiza dados de item de trabalho em Microsoft Project, o mapa de campo determina quais campos no banco de dados de item de trabalho correspondem aos campos em Microsoft Project.

No arquivo de mapeamento, você especifica campos para cada projeto de equipe.Para recuperar o arquivo de mapeamento, você baixá-lo de um projeto de equipe.Depois que você altera o arquivo, você pode carregá-lo ao projeto de equipe, e as alterações se aplicam a todos os usuários do projeto de equipe.Consulte Alterar como campos são mapeados para o Microsoft Project.

Neste tópico

  • Elemento de mapeamento

  • Elemento de ReservedField

  • Elemento de SyncField

  • Elemento de ResourceNameSeparator

  • Tipo de link da hierarquia

  • Tipo de link de dependência

  • Atributos de mapeamento que afetam a publicação e atualizar

Elemento de mapeamento

Para especificar um mapeamento entre um campo de item de trabalho e uma coluna de projeto, você usa o elemento de Mapping .

Você usa a seguinte sintaxe XML para especificar um mapeamento entre um campo de tipo de item de trabalho e um campo de Microsoft Project .O elemento de Mapping é usado para especificar um mapeamento de campo.

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly="">
         IfSummaryRefreshOnly=""/>

ms404686.collapse_all(pt-br,VS.110).gifAtributos

A tabela a seguir descreve os atributos que podem ser usados com o elemento de Mapping .

Atributo

Descrição

WorkItemTrackingFieldReferenceName

Obrigatório.Especifica o nome da referência de um campo em um tipo de item de trabalho.

ProjectField

Obrigatório.Especifica o nome de um campo em Microsoft Project.Specify predefiniu nomes de campos prefixando o “pj” ao nome, como o pjTaskName para a coluna do nome da tarefa.Especificar campos personalizados como o pjTaskText seguido por um número, como pjTaskText11.

ProjectName

Opcional.Especifica o nome para aparecer como o nome da coluna em Microsoft Project.Se você não especificar esse atributo, o nome do campo de tipo de item de trabalho é usado.

ProjectUnits

Opcional.Especifica o tipo de unidades para utilizar quando você mapeia um tipo de campo a Microsoft Project.Você pode especificar os seguintes valores: pjMinute, pjHour, pjDay, pjWeek, e pjMonthUnit.

ObservaçãoObservação
Você pode especificar ProjectUnits somente para os campos que especificam a duração de tempo ou outras unidades de tempo.

PublishOnly

Opcional.Se definida como true, indica que o campo é publicado para o banco de dados de 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 definida como false, indica que o campo é publicado e atualizado.O valor padrão é false.

No arquivo de mapeamento padrão, os dois campos cujo atributo de PublishOnly é definido como true são Data de início e Data de Conclusão.

IfSummaryRefreshOnly

Opcional.Se definida como true, indica que o campo é publicado nunca ao banco de dados de item de trabalho mas é atualizado de banco de dados de item de trabalho quando os seguintes são também verdadeiros:

  • A linha para o campo é uma tarefa de resumo em Office Project.

  • A tarefa de resumo tem publicar e a atualização avalia definido como Yes.

  • A tarefa de resumo contém pelo menos uma tarefa filho que está associada a Team Foundation Server.

Todas as atualizações ou cálculos que Microsoft Project faça podem substituir o valor que é atualizada 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 os campos resumo que, se publicado para o banco de dados de item de trabalho, resultam em inconsistências de dados.

Se definida como false, indica que o campo pode ser publicado e atualizado.O valor padrão quando não é especificado false.

ObservaçãoObservação
O valor que é atribuído ao atributo de IfSummaryRefreshOnly substitui o valor que é atribuído a PublishOnly.Para obter mais informações, consulte Campos que afetam a publicação e atualizar posteriormente neste tópico.

No arquivo de mapeamento padrão, o atributo de IfSummaryRefreshOnly é definido como true para Avaliação original, Trabalho Restante, e campos de Trabalho concluído .

O exemplo a seguir mostra como mapear o campo de tipo de item de trabalho que contém o título para o campo de Microsoft Project do nome da tarefa:

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

A seguinte sintaxe XML mostra um exemplo mais complexo de como mapear o campo de tipo de item de trabalho que tem a data de início para o campo de Microsoft Project data de início.Porque o campo é calculado, é especificado para publicar e não atualizar para evitar que erros sejam introduzidos por atualizações de Team Explorer .

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>
ObservaçãoObservação

Como prática recomendada, você deve mapear campos calculados em Microsoft Project a campos somente leitura em Team Foundation.Isso ajuda a evitar confusão de modo que os membros da equipe não tente alterar campos calculados.

De volta ao topo

Elemento de ReservedField

O elemento de ReservedField funciona para oferecer suporte aos links definidos hierárquicas entre tarefas e é um elemento opcional.

Se este elemento não é especificado no mapeamento, então Microsoft Project usa o campo padrão de pjNumber20 .

De volta ao topo

Elemento de SyncField

O campo de sincronização permitem que você publicar e para atualizar o comportamento de cada tarefa.O campo como uma coluna com o título Publicar e Atualizar quando você usar modo de Folhas de tarefas do sistema de equipe .

Você deve especificar um campo de sincronização no arquivo de mapeamento de campo de Microsoft Project .Use a seguinte sintaxe XML para especificar que o campo é o campo de sincronização.Para especificar um campo de sincronização, use o elemento de SyncField .O atributo de ProjectField deve ser definido como um campo válido de Office Project .

<SyncField ProjectField="" />

O exemplo a seguir mostra como especificar pjTaskText25 como o campo de sincronização:

<SyncField ProjectField="pjTaskText25" />

Para obter mais informações sobre como usar o campo de sincronização em Office Project, consulte Publicar ou atualizar itens de trabalho no Office Project.

De volta ao topo

Elemento de ResourceNameSeparator

Você pode usar ResourceNameSeparator para definir o caractere que distinguirá os nomes de recursos que estão em uma cadeia de caracteres.os usuários e recursos deTeam Foundation são sincronizados com os usuários de serviços de diretório do Active Directory.Os nomes de usuários e recursos podem incluir um delimitador, como uma vírgula, para separar o sobrenome, nome, e a inicial do meio de um recurso.

Este é um elemento opcional.Se este elemento não é especificado no mapeamento, então Microsoft Project separar nomes de recurso usando os mapeamentos padrão que são definidos na tabela a seguir:

Se o Active Directory e separador da lista de projeto de equipe são

Em Project substitua com o Office

,

;

;

:

.

:

Se você desejar especificar um caractere diferente de aqueles listados na tabela anterior, então você pode definir ResourceNameSeparator usando a seguinte sintaxe:

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

O exemplo a seguir mostra como especificar o caractere “*” como o separador para usar em Office Project quando o caractere de Team Foundation é “-”:

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

De volta ao topo

Quando você cria tarefas resumidas em Microsoft Project, um link de árvore é criado entre a tarefa de resumo, o pai, e as tarefas subordinadas ou filhos.Office Project usa a opção System.LinkTypes.Hierarchy para criar esses links.

De volta ao topo

Quando você cria links entre tarefas em Microsoft Project, você cria um link dependentes entre as tarefas.A tarefa predecessores é atribuída um link predecessores e a tarefa de sucessor é atribuída um link do sucessor.Essas são as designações padrões que são definidas para o tipo de link System.LinkTypes.Dependency.

De volta ao topo

Atributos de mapeamento que afetam a publicação e atualizar

Os seguintes campos de mapeamento e valores de campo de Microsoft Project determinar se um valor para um item de trabalho é publicado ou atualizado:

  • O valor do valor de Publicar e Atualizar para cada item de trabalho.

  • O valor do atributo de PublishOnly para um campo específico de mapeamento.

  • O valor de IfSummaryRefreshOnly para um campo específico de mapeamento.

  • A classificação da tarefa como um resumo ou uma tarefa pai.

    Uma tarefa pai é uma tarefa que tenha pelo menos uma tarefa filho que é publicado a Team Foundation Server.

Para itens de trabalho que não são tarefas resumidas

A tabela a seguir indica se um item de trabalho que não está um resumo ou uma tarefa pai é publicado ou atualizado com base nos atributos de campo de mapeamento e na atribuição que é feita ao valor de Publicar e Atualizar de item.

Publicar e atualizar

(nível de tarefa)

Atributo de PublishOnly

O campo é publicado?

O campo é atualizado?

Não

True ou false

Não

Não

Atualização apenas

True ou false

Não

Sim

Sim

True

Sim

Não

Sim

False

Sim

Sim

Para itens de trabalho que são tarefas resumidas

Se os critérios de tarefa de resumo estão localizados e IfSummaryRefreshOnly é true, seu valor substitui o valor de PublishOnly .A tabela a seguir indica se um resumo ou uma tarefa pai são publicados ou atualizados com base na atribuição que é feita ao valor de Publicar e Atualizar e aos atributos de campo de mapeamento.

Publicar e atualizar

(nível de tarefa)

Atributo de PublishOnly

IfSummaryRefreshOnly

Atributo

O campo é publicado?

O campo é atualizado?

Não

True ou false

True ou false

Não

Não

Atualização apenas

True

True

Não

Sim

Atualização apenas

True

False

Não

Sim

Atualização apenas

False

True ou false

Não

Sim

Sim

True ou false

True

Não

Sim

Sim

True

False

Sim

Não

Sim

False

False

Sim

Sim

De volta ao topo

Consulte também

Conceitos

Referência de elementos de tipo de link

Personalizar os mapeamentos de campo do Microsoft Project