Gerenciar mapeamentos de campo para a integração do Team Foundation Server e do Project Server

Você pode personalizar como você sincronizar dados entre Visual Studio Team Foundation Server 2012 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 Team Foundation Server e de 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 .

Observação
O arquivo de mapeamento de campo para a integração de Team Foundation Server e de Project Server é distinto 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 como e sua personalização, consulte Referência de elemento XML de mapeamento de campo para a integração do Team Foundation Server e do servidor e Personalizar o mapeamento de campo entre o Project Server e o Team Foundation Server.

Para usar a ferramenta de linha de comando TfsAdmin ProjectServer , abra uma janela de prompt de comando onde Visual Studio ou Team Explorer sejam instalados e insira:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Em uma edição de 64 bits do windows, substitua %programfiles% com %programfiles(x86)%.

Permissões Necessárias

Para usar esses comandos, sua permissão de deve ser definida Administre a integração do servidor a Permitir para a coleção de projeto de equipe.Além de isso, 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 Web App (PWA) que participará em sincronização de dados.Para obter mais informações, consulte Atribuir permissões para oferecer suporte à integração do Project Server e do Team Foundation Server.

Observação

Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra o menu de atalho para Prompt de Comando, e então escolha Executar como Administrador.Para obter mais informações, consulte a seguinte página no site da Microsoft: Controle de acesso de usuário.

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 de uniform resource identifier (URL) de uma coleção de projeto de equipe.Você especifica a URL no seguinte formato: http:ServerName: porta/VirtualDirectoryName/CollectionName/ Se você não especificar um diretório virtual, você especifica a URL no seguinte formato: http:ServerName: porta/CollectionName/
/filePath:mappingFile	Especifica o caminho e o nome do arquivo de definição de XML que contém os mapeamentos do campo. Observação 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 a um local onde você não tem permissões, a tecnologia virtualização do Registro automaticamente redireciona o arquivo exportado e o salva no armazenamento virtual.Para evitar essa 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 do Registro e Problemas de virtualização de arquivo comum e do Registro 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 carrega o.
/useDefaultFieldMappings	Carrega os mapeamentos de campo padrão em vez de um arquivo de mapeamento personalizados.Para obter mais informações, consulte Referência de elemento XML de mapeamento de campo para a integração do Team Foundation Server e do servidor.
/force	Substitui o arquivo existente de mapeamento.Você deve especificar esta opção se você especificar a opção de /useDefaultFieldMappings quando você substitui os mapeamentos existentes com os mapeamentos diferentes.

De volta ao topo

Comentários

Você pode mapear somente os campos personalizados da empresa ou campos que são construídos a Project Server.Você deve especificar o nome de um campo válido no projeto.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 o personalizado é 01 pjCustom01.As restrições existem em como você pode mapear campos internos ou personalizados, e você deve corresponder aos tipos de dados de campos.Para obter mais informações, consulte Restrições em mapear campos de Project Server para a integração com o Team Foundation 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.

Observações 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 estar de acordo com os campos mapeados.

• Para os tipos de itens 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 da Team Foundation Server Project Server, certifique-se que você corresponde os tipos de dados dos 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 Data Types and Field Mapping Criteria.

De volta ao topo

Exemplos

Baixar o mapeamento Arquivo do 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 mapeamento Arquivo de campo para uma coleção de projeto de equipe

O exemplo carrega AWMappingFile.xml a AdventureWorksCollection.

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

De volta ao topo

Consulte também

Tarefas

Configurar a integração do Team Foundation Server e do Project Server

Conceitos

Referência de elemento XML de mapeamento de campo para a integração do Team Foundation Server e do servidor

Restrições em mapear campos de Project Server para a integração com o Team Foundation Server

Gerenciar integração do Project com o TfsAdmin ProjectServer

Outros recursos

Personalizar o mapeamento de campo entre o Project Server e o Team Foundation Server