Personalizar o arquivo de mapeamento de campo do Microsoft Project

Artigo
11/18/2015

Você pode personalizar como trabalho item os campos que são definidos no Team Foundation são mapeados para campos em Microsoft Project, e você pode alterar como campos específicos são publicados. Microsoft Project inclui campos predefinidos, como nome de tarefa e campos personalizados. Quando você publicar ou atualizar dados de item de trabalho no Microsoft Project, o mapa de campo determina quais campos no banco de dados de item de trabalho correspondem aos campos Microsoft Project.

Para obter informações sobre como usar o projeto e o TFS para acompanhar o trabalho, consulte Criar sua lista de pendências e tarefas usando o Project.

Para modificar os mapeamentos de campo para um projeto de equipe, você Exportar e importar o mapeamento de arquivo do Microsoft Project usando a ferramenta de linha de comando TFSFieldMapping.

Elemento de mapeamento

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

Use 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, em seguida, é 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 um campo de referência em um tipo de item de trabalho.
ProjectField	Obrigatório. Especifica o nome de um campo em Microsoft Project. Especifique os nomes de campo predefinidas, 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 no Microsoft Project. Se você não especificar esse atributo, o nome do campo do tipo de item de trabalho será 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. Dica Você pode especificar ProjectUnits somente para campos que especifica a duração de tempo ou em outras unidades de tempo.
PublishOnly	Opcional. Se definido como true, indica que o campo é publicado no banco de dados do item de trabalho, mas não são atualizadas. Esse valor é normalmente usado para os campos calculados que não devem ser atualizados no 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 é definido como true são o Start Date e Data de término.
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 a seguir também forem verdadeira: A linha para o campo é uma tarefa de resumo em Office Project. A tarefa de resumo tiver publicar e atualizar valores 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. O valor padrão quando não especificado é false. Dica O valor atribuído para a IfSummaryRefreshOnly atributo substitui o valor atribuído a PublishOnly.Para obter mais informações, consulte publicação que afetam os campos e atualizando mais adiante neste tópico. No arquivo de mapeamento padrão, o IfSummaryRefreshOnly atributo é 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 de como mapear o campo de tipo de item de trabalho que tem a data de início e a data de início mais complexo Microsoft Project campo. Como o campo é calculado, é especificado para publicar e atualizar não para impedir que os erros estão sendo introduzidas pela Team Explorer atualizações.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

Dica

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

Elemento ReservedField

O ReservedField elemento funciona para dar suporte a links hierárquicos definidos entre tarefas e é um elemento opcional.

Se esse elemento não for especificado no mapeamento, então Microsoft Project usa o padrão pjNumber20 campo.

Elemento 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 quando você usa o planilha de tarefas do Team System exibição.

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

<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 no Office Project, consulte Publicar ou atualizar itens de trabalho no Project.

Elemento ResourceNameSeparator

Você pode usar o ResourceNameSeparator para definir o caractere que fará distinção de nomes de recursos que estão em uma cadeia de caracteres. Team Foundation usuá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 uma vírgula, para separar o sobrenome, nome e inicial do meio de um recurso.

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

Se o Active Directory e a equipe de projeto separador de lista	Em seguida, no Office Project substitua
ou	;
;	:
.	:

Se você deseja especificar um caractere diferente daqueles listados na tabela acima, você pode definir o ResourceNameSeparator usando a seguinte sintaxe:

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

O exemplo a seguir mostra como especificar o caractere "*" como o separador a ser usado em Office Project quando o Team Foundation caractere "-":

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

Tipo de Link de hierarquia

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

Tipo de Link de dependência

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

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

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

O valor de Publicar e atualizar 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.
A classificação da tarefa como uma tarefa de resumo ou pai.

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

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

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

Publicar e Atualizar (nível de tarefa)	Atributo PublishOnly	Campo é publicado?	Campo é atualizado?
Não	VERDADEIRO ou falso	Não	Não
Apenas Atualizar	VERDADEIRO ou falso	Não	Sim
Sim	Verdadeiro	Sim	Não
Sim	Falso	Sim	Sim

Itens de trabalho são tarefas de resumo

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

Publicar e Atualizar (nível de tarefa)	Atributo PublishOnly	IfSummaryRefreshOnly Atributo	Campo é publicado?	Campo é atualizado?
Não	VERDADEIRO ou falso	VERDADEIRO ou falso	Não	Não
Apenas Atualizar	Verdadeiro	Verdadeiro	Não	Sim
Apenas Atualizar	Verdadeiro	Falso	Não	Sim
Apenas Atualizar	Falso	VERDADEIRO ou falso	Não	Sim
Sim	VERDADEIRO ou falso	Verdadeiro	Não	Sim
Sim	Verdadeiro	Falso	Sim	Não
Sim	Falso	Falso	Sim	Sim

Consulte também

Conceitos

Referência de elementos de tipo de link

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

Compartilhar via