Compartilhar via

Gerenciar mapeamentos de campo para a integração do TFS com o Project Server

  • Artigo

Você pode personalizar como você sincronizar dados entre Visual Studio Team Foundation Server (TFS) e Microsoft Project Server modificando o arquivo de mapeamento de campo. Esse arquivo define os campos de dados que são sincronizados e como eles são sincronizados para oferecer suporte a integração de TFS e Project Server. Você pode gerenciar esse arquivo usando as seguintes opções de ferramenta de linha de comando TfsAdmin ProjectServer :

  • /DownloadFieldMappings: Download do arquivo de mapeamento de campo que é definido para uma coleção de projeto de equipe.

  • /UploadFieldMappings: Valida a sintaxe XML do arquivo de mapeamento de campo, e carregá-lo a uma coleção. Para validar a sintaxe mas não carregar o arquivo, você pode usar a opção de /validateonly .

Dica

O arquivo de mapeamento de campo para a integração de Team Foundation Server e Project Server é diferente do arquivo de mapeamento de campo para Microsoft Project.Para obter informações sobre como baixar ou carregar o segundo arquivo, consulte Carregar ou baixar o arquivo de mapeamento do Microsoft Project [TFSFieldMapping].

Para obter mais informações sobre conteúdo do arquivo de mapeamento de campo e como personalizá-lo, consulte Referência a elementos XML de mapeamento de campos para a integração do TFS com o Project Server e Personalizar o mapeamento de campos entre o TFS e o Project Server.

Para usar a ferramenta de linha de comando TfsAdmin ProjectServer, abra uma janela de Prompt de Comando onde Visual Studio ou Team Explorer está instalado e digite:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

Em uma edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%.

Requisitos

Para usar esses comandos, sua permissão de Administrar a integração com o Project Server deve ser definida como Permitir para a coleção de projeto de equipe. Além disso, a conta de serviço para Team Foundation Server deve ser concedido as permissões necessárias para interagir com a instância de acesso Web de Projeto ou projetar o aplicativo (PWA) da Web que participará na sincronização de dados. Para obter mais informações, consulte Atribuir permissões para dar suporte à integração TFS-Project Server.

Sintaxe

TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

Parâmetros

Parâmetro

Descrição

/collection:tpcURL

Especifica o localizador recursos uniforme (URL) de uma coleção de projeto de equipe. Especifique a URL no seguinte formato:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Se você não especificar um diretório virtual, você especifica a URL no seguinte formato:

http://ServerName:Port/CollectionName

/filePath:mappingFile

Especifica o caminho e o nome do arquivo de definição de XML que contém os mapeamentos do campo.

Dica

Se você estiver usando Windows Vista, você pode não ter permissões para acessar determinadas pastas.Se você tentar exportar o tipo de item de trabalho para um local onde não tenha permissões, a tecnologia de virtualização do Registro redirecionará automaticamente o arquivo exportado e o salvará no armazenamento virtual.Para evitar esse redirecionamento, você pode exportar o arquivo para um local onde você tenha permissões.Para obter mais informações, consulte as seguintes páginas no site da Microsoft: Virtualização de Registro e Problemas de virtualização de arquivo e de registro comuns no Windows Vista.

/encoding:encoding

Especifica o nome de um formato de codificação para o.NET Framework 2.0. O comando exportar ou importa os dados xml no formato de codificação que você especificar. Por exemplo, /e:utf-7 especifica a codificação Unicode (UTF-7). Se você não especificar esse parâmetro, o comando tenta detectar e usa a codificação UTF-8 se a detecção falhar.

/validateOnly

Valida o arquivo de mapeamento mas não o é carregado.

/useDefaultFieldMappings

Carrega os mapeamentos de campo padrão em vez de um arquivo de mapeamento personalizado. Para obter mais informações, consulte Referência a elementos XML de mapeamento de campos para a integração do TFS com o Project Server.

/force

Substitui o arquivo de mapeamento existente. Você deve especificar esta opção se você especificar a opção de /useDefaultFieldMappings quando você substitui os mapeamentos existentes com os mapeamentos diferentes.

Comentários

Você pode mapear apenas os campos personalizados da empresa ou campos que são compilados a Project Server. Você deve especificar o nome de um campo válido em Project. Para determinar o nome de um campo interno, remover todos os espaços de nome amigável, e prefixe o resultado com “pj”. Por exemplo, o nome do campo para o gerenciador de status é pjStatusManager, e o nome do campo para utilizar 01 é pjCustom01. As restrições existem em como você pode mapear campos internos e personalizados, e você deve corresponder aos tipos de dados de campos. Para obter mais informações, consulte Restrições ao mapeamento de campos do Project Server na integração do TFS com o Project Server.

Quando você executa um comando de TFSAdmin ProjectServer , uma mensagem indica a ação que está sendo executada e o objeto afetado. Por exemplo, a seguinte mensagem que mostra o arquivo de mapeamento de campo está sendo baixado:

Download field mappings from DefaultCollection

Outra mensagem aparece após as ações de comando for concluída. Por exemplo, a seguinte mensagem aparece quando o arquivo de mapeamento de campo foi baixado:

You have downloaded field mappings to C:MappingFile. . . Done.

Notas sobre carregar mapeamentos do campo

Se um arquivo de mapeamento de campo é carregada com êxito, as seguintes alterações são feitas:

  • Cada campo de espelho em Team Foundation é configurado para seguir com os campos mapeados.

  • Para os tipos de item de trabalho que foram mapeados para uma coleção ou um projeto de equipe, novos mapeamentos aparecem na guia de Project Server do formulário de item de trabalho.

Importante

Quando você mapeia um campo de Team Foundation Server a Project Server, certifique-se que você corresponde os tipos de dados desses campos.Caso contrário, o seguinte erro pode aparecer quando você tenta carregar os mapeamentos do campo:

O índice com base zero () deve ser maior ou igual a zero e menor que o tamanho da lista de argumentos.

Para obter mais informações, consulte Tipos de dados e critérios de mapeamento de campo.

Exemplos

Baixar o arquivo de mapeamento de campo que é definido para uma coleção de projeto de equipe

O seguinte exemplo faz o download os mapeamentos do campo que são definidos para AdventureWorksCollection a AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Carregar o arquivo de mapeamento de campo para uma coleção de projeto de equipe

O seguinte exemplo carrega AWMappingFile.xml a AdventureWorksCollection.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Consulte também

Tarefas

Configurar a integração TFS-Project Server

Conceitos

Referência a elementos XML de mapeamento de campos para a integração do TFS com o Project Server

Restrições ao mapeamento de campos do Project Server na integração do TFS com o Project Server

Mapear componentes de integração [TfsAdmin ProjectServer]

Outros recursos

Personalizar o mapeamento de campos entre o TFS e o Project Server