Partilhar via

O arquivo de mapeamento de campo do Microsoft Project

  • Artigo

Você pode personalizar como os campos que são definidos para itens de trabalho Team Foundation o mapa de campos em Microsoft Project, e você pode alterar os campos específicos como são publicados. No arquivo de mapeamento de campo para Microsoft Project, você pode definir os mapeamentos entre campos em Team Foundation e Microsoft Project. Microsoft Projectinclui campos predefinidos, como, por exemplo, nome da tarefa e campos personalizados. Quando você publicar ou atualizar 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 Microsoft Project.

No arquivo de mapeamento, você pode especificar campos para cada projeto de equipe. Para recuperar o arquivo de mapeamento, baixe-o de um projeto de equipe. Depois de modificar o arquivo, você pode carregá-lo para o projeto de equipe e as alterações se aplicam a todos os usuários desse projeto de equipe. Para obter mais informações sobre como fazer download ou upload de arquivo de mapeamento de campo de Microsoft Project, consulte Fazer download ou Upload de um arquivo de mapeamento de campo do Microsoft Project.

Neste tópico

  • Elemento Mapping

  • Elemento de ReservedField

  • Elemento de SyncField

  • Elemento de ResourceNameSeparator

  • Tipo de Link de hierarquia

  • Tipo de Link de dependência

  • Mapeamento de atributos que afetam a publicação e atualização

Elemento Mapping

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

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

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

Atributos

A tabela a seguir descreve os atributos que podem ser usados com o 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 um campo em Microsoft Project. Especificar nomes de campos 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 apareça como o nome da coluna no Microsoft Project. Se você não especificar esse atributo, o nome do campo do 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. Você pode especificar os seguintes valores: pjMinute, pjHour, , pjDay, pjWeek, e pjMonthUnit.

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

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. O valor padrão é false.

No arquivo de mapeamento padrão, os dois campos cuja PublishOnly atributo está definido como true são o Data de início e Data de término do.

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 a seguir também é verdadeira:

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

  • A tarefa de resumo possui a publicar e atualizar valores definidos 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 para o 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. O valor padrão quando não especificado é false.

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

No arquivo de mapeamento padrão, o IfSummaryRefreshOnly atributo está definido como true para o Estimativa Original, Trabalho restante, e Trabalho concluído campos.

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

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

A sintaxe XML a seguir mostra um exemplo mais complexo de como mapear o campo de tipo de item de trabalho que possui a data de início para a data de início Microsoft Project campo. Porque o campo é calculado, ele é especificado para publicar e não atualizar para impedir que os erros que estão sendo introduzidas pela Team Explorer atualizações.

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

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

Voltar ao topo

Elemento de ReservedField

O ReservedField elemento funciona para oferecer suporte hierárquico links definido entre as tarefas e é um elemento opcional.

Se este elemento não será especificado no mapeamento, em seguida, Microsoft Project usa o padrão pjNumber20 campo.

Voltar ao topo

Elemento de SyncField

O campo de sincronização permite que você controle a publicar e atualizar o comportamento de cada tarefa. O campo é exibido como uma coluna com o título publicar e atualizar ao usar o Planilha de tarefas do sistema de equipe modo de exibição.

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

<SyncField ProjectField="" />

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

<SyncField ProjectField="pjTaskText25" />

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

Voltar ao topo

Elemento de ResourceNameSeparator

Você pode usar o ResourceNameSeparator para definir o caractere que fará distinção de nomes de recursos que estão em uma seqüência de caracteres. Team Foundationusuários e recursos são sincronizados com os usuários do serviço de diretório do Active Directory. Os nomes de usuários e recursos podem incluir um delimitador, como, por exemplo, uma vírgula, para separar o sobrenome, nome e iniciais de um recurso.

Este é um elemento opcional. Se este elemento não for especificado no mapeamento, em seguida, Microsoft Project separa os nomes de recursos usando os mapeamentos padrão que são definidos na tabela a seguir:

Se o separador de lista do Active Directory e a equipe de projeto

No Office Project substitua por

,

;

;

:

.

:

Se você desejar especificar um caractere diferente daqueles listados na tabela acima, você pode definir a 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 Team Foundation caractere é "-":

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

Voltar ao topo

Quando você criar tarefas de resumo no Microsoft Project, um link de árvore é criado entre a tarefa de resumo, pai e tarefas subordinado ou filho. Office Projectusa o padrão de System.LinkTypes.Hierarchy para criar esses links.

Voltar ao topo

Quando você cria links entre as tarefas de Microsoft Project, você poderá criar um link dependente entre tarefas. A tarefa predecessora é atribuída a um vínculo de predecessora e sucessora é atribuída a um link do sucessor. Essas são as designações de padrão são definidas para o tipo de link de System.LinkTypes.Dependency.

Voltar ao topo

Mapeamento de atributos que afetam a publicação e atualização

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

  • O valor de publicar e atualizar o valor para cada item de trabalho.

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

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

  • Classificação da tarefa como uma tarefa de resumo ou pai.

    Uma tarefa pai é uma tarefa que tenha pelo menos uma tarefa de filho é publicada em Team Foundation Server.

Itens de trabalho que não são tarefas de resumo

A tabela a seguir indica se um item de trabalho não é uma tarefa de resumo ou pai é publicada ou atualizada baseado em atributos de campo de mapeamento e a atribuição que é feita para o publicar e atualizar o valor do item.

Publicar e atualizar

(nível de tarefa)

Atributo de PublishOnly

Campo publicado?

Campo é atualizado?

Não

True Ou False

Não

Não

Atualizar somente

True Ou False

Não

Sim

Sim

True

Sim

Não

Sim

Falso

Sim

Sim

Para os itens de trabalho são tarefas de resumo

Se a tarefa de resumo de critérios forem atendida e IfSummaryRefreshOnly é true, seu valor prevalece sobre a PublishOnly valor. A tabela a seguir indica se uma tarefa de resumo ou pai é publicada ou atualizada com base na atribuição feita a sua publicar e atualizar valor e o mapeamento de atributos de campo.

Publicar e atualizar

(nível de tarefa)

Atributo de PublishOnly

IfSummaryRefreshOnly

Atributo

Campo publicado?

Campo é atualizado?

Não

True Ou False

True Ou False

Não

Não

Atualizar somente

True

True

Não

Sim

Atualizar somente

True

Falso

Não

Sim

Atualizar somente

Falso

True Ou False

Não

Sim

Sim

True Ou False

True

Não

Sim

Sim

True

Falso

Sim

Não

Sim

Falso

Falso

Sim

Sim

Voltar ao topo

Consulte também

Conceitos

Trabalhando com tipos de Link

Outros recursos

Personalizando os mapeamentos de campo do Microsoft Project

Histórico de alterações

Date

History

Motivo

Outubro de 2010

Removidas as informações sobre o HierarchyLinkType e DependencyLinkType elementos porque a versão atual não suporta-los.

Comentários do cliente.