Compartilhar via

Carregar ou baixar o arquivo de mapeamento do Microsoft Project [TFSFieldMapping]

  • Artigo

Use TFSFieldMapping para carregar e baixar o arquivo de mapeamento Microsoft Project. Esse arquivo controla como o Microsoft Project publica tarefas para um projeto de equipe especificado que foi criado em Visual Studio Team Foundation Server 2013. Por exemplo, é possível modificar o arquivo para oferecer suporte aos campos adicionados em tipos de itens de trabalho ou modificar como os campos existentes são publicados e atualizados.

Você pode especificar quais campos no Team Foundation estão mapeados para os campos Microsoft Project. É possível controlar também o comportamento da publicação por meio do atributo PublishOnly e designar campos especiais, tais como o campo de contexto. Para obter a sintaxe XML completa do arquivo de mapeamento, consulte Personalizar o arquivo de mapeamento de campo do Microsoft Project. Esse arquivo é o mesmo arquivo que foi definido no modelo de processo usado para criar o projeto de equipe. Consulte Mapear os campos do Microsoft Project para os campos do Team Foundation

Para acessar a ferramenta de linha de comando TFSFieldMapping, abra uma janela do prompt de comando na qual você tenha instalado o Projeto, bem como o Team Explorer ou o TFS e insira:

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

Dica

Mesmo se tiver feito logon com permissões administrativas, você deve abrir um prompt de comando elevado para executar essa função em um servidor que esteja executando o Windows Server 2008.Para abrir o prompt de comando elevado, escolha Iniciar, abra o menu de contexto do prompt de comando e escolha Executar como Administrador.Para obter mais informações, consulte o site da Microsoft.

Permissões necessárias

Para usar o comando TFSFieldMapping, você deve ser um membro do grupo de segurança de Administradores do Team Foundation ou de Administradores do Projeto. Para obter mais informações, consulte Referência de permissões para o Team Foundation Server.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Parâmetros

Argumento

Descrição

upload | download

Especifica se é preciso baixar ou carregar o arquivo de mapeamento de campo.

/collection:CollectionURL

Especifica o URI da coleção de projetos de equipe no seguinte formato: http://ServerName:Port/VirtualDirectoryName/CollectionName

Se você não especificar que um diretório virtual é usado, use o seguinte formato:

http://ServerName:Port/CollectionName

Se você já tiver se conectado ao servidor, especifique o nome amigável do servidor em vez do URI.

/teamproject:ProjectName

Especifica o nome do projeto de equipe cujos parâmetros de mapeamento você deseja modificar. Se o nome apresentar espaços, coloque-o entre aspas.

/mappingfile:MappingFile

Especifica o nome e o caminho de arquivo do arquivo de mapeamento.

Para alterar como os campos de itens de trabalho são mapeados para o Projeto

  1. Abra uma janela do prompt de comando na qual você tenha instalado o Projeto, bem como o Team Explorer ou o TFS e insira:

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

    Dica

    O Projeto não é necessário para baixar o arquivo de mapeamento, mas para carregá-lo sim.

  2. Baixe o arquivo de mapeamento ao inserir o comando a seguir:

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

    Dica

    Se um nome apresentar espaços, coloque-o entre aspas.

  3. Abra o arquivo de mapeamento em um editor de texto ou no editor de XML.

  4. Adicione novos mapeamentos ou edite os mapeamentos existentes no seguinte formato:

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

    Por exemplo, para adicionar campos de agendamento adicionais a um projeto de equipe usando o modelo de processo do Scrum, adicione os seguintes mapeamentos:

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="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.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />

    O modelo padrão do Scrum somente mapeia o campo Trabalho Restante para o Projeto.

    Dica

    Para obter uma lista completa de todos os campos de valores Office Project para o atributo ProjectField, consulte Mapeamentos de campos no Microsoft Project.

  5. (Opcional) Indique se o campo deve ser publicado, mas não atualizado. Adicione o atributo PublishOnly na seção de mapeamento desse campo e defina o atributo como true. Esse atributo pode ser usado para permitir que os membros da equipe vejam um valor de campo, mas não possam alterá-lo em Team Foundation.

  6. (Opcional) Indique como as tarefas de resumo são atualizadas no Projeto. Adicione o atributo fSummaryRefreshOnly="true" para indicar que o campo nunca é publicado no banco de dados de itens de trabalho, mas é atualizado no banco de dados de itens de trabalho se a linha do campo for uma tarefa de resumo no Projeto, a tarefa de resumo tiver Publicar e Atualizar=Sim e a tarefa de resumo apresentar pelo menos uma tarefa filho publicada no TFS.

  7. Salve e carregue o arquivo:

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Consulte também

Referência

Mapeamentos de campos no Microsoft Project

Conceitos

Personalizar o arquivo de mapeamento de campo do Microsoft Project