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

Artigo
08/01/2011

Você pode personalizar como você sincroniza dados entre Visual Studio Team Foundation Server 2010 e o Project Server, modificando o arquivo de mapeamento de campo. Esse arquivo define os campos de dados são sincronizados e como eles serão sincronizados com o suporte à integração de Team Foundation Server e o Project Server. Você pode gerenciar esse arquivo usando as seguintes opções da TFSAdmin ProjectServer ferramenta de linha de comando:

/DownloadFieldMappings: Baixa o arquivo do 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, em seguida, ele carrega uma coleção. Para validar a sintaxe, mas não carregar o arquivo, você pode usar o /validateonly opção.

Observação
O arquivo de mapeamento de campo para a integração de Team Foundation Server e o Project Server é diferente do arquivo de mapeamento de campo de Microsoft Project. Para obter informações sobre como fazer download ou upload o segundo arquivo, consulte TFSFieldMapping.

Para obter mais informações sobre o conteúdo do arquivo de mapeamento de campo e como personalizá-lo, consulte Campo de referência do elemento XML de mapeamento para a integração de Team Foundation Server de e o Project Server e Personalizando o mapeamento de campo entre o Project Server e do Team Foundation Server.

Para usar o TFSAdmin ProjectServer ferramenta de linha de comando, abra uma janela de Prompt de comando em um computador que esteja executando o Team Explorer e Visual Studio Team Foundation Server 2010 Service Pack 1. Executar a ferramenta a partir do seguinte diretório: Unidade:\Arquivos de Programas\Microsoft 10.0\Common7\IDE de Visual Studio. Para máquinas de 64 bits, a ferramenta está em da unidade:\Arquivos de programas (x86) \Microsoft Visual Studio 10.0\Common7\IDE.

Permissões necessárias

Para usar esses comandos, o a integração de administrar o Project Server permissão deve ser definida Permitir para a coleção de projeto de equipe. Além disso, a conta de serviço de Team Foundation Server devem ser concedidas as permissões necessárias para interagir com a instância do Project Web Access ou do aplicativo da Web de projeto (PWA), que for participar da sincronização de dados. Para obter mais informações, consulte Atribuir permissões a integração de suporte do Project Server e do Team Foundation Server.

Observação
Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em Executar como administrador. Para obter mais informações, consulte a seguinte página no site da Microsoft: O controle de acesso do usuário.

Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em Executar como administrador. Para obter mais informações, consulte a seguinte página no site da Microsoft: O controle de acesso do 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 recursos uniforme (URL) de uma coleção de projeto de equipe. Você pode especificar a URL no seguinte formato: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta Se você não especificar um diretório virtual, especifique o URI no seguinte formato: http: / /Nome_do_servidor: port / NomeDaColeta
/filePath:mappingFile	Especifica o caminho e o nome do arquivo de definição XML que contém os mapeamentos de campo. Observação Se você estiver usando Windows Vista, talvez você não tenha permissões para acessar determinadas pastas.Se você tentar exportar o tipo de item de trabalho para um local onde você não tem permissões, a tecnologia de virtualização do registro automaticamente redireciona o arquivo exportado e salva-lo no armazenamento virtual.Para evitar esse redirecionamento, você pode exportar o arquivo para um local onde você tem permissões. Para obter mais informações, consulte as seguintes páginas no site da Microsoft: Virtualização de registro e problemas comuns de virtualização de arquivo e registro no Windows Vista.
/encoding:encoding	Especifica o nome de um formato de codificação para o.NET Framework 2.0. O comando exporta 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 a codificação e usa UTF-8 se a detecção de falha.
/validateOnly	Valida o arquivo de mapeamento, mas não carrega.
/useDefaultFieldMappings	Carrega os mapeamentos de campo padrão em vez de um arquivo de mapeamento personalizado. Para obter mais informações, consulte Campo de referência do elemento XML de mapeamento para a integração de Team Foundation Server de e o Project Server.
/force	Substitui o arquivo de mapeamento existente. Se você estiver substituindo os mapeamentos existentes com mapeamentos diferentes, você deve especificar essa opção.

Voltar ao topo

Comentários

Você pode mapear apenas os campos personalizados da empresa ou campos que são criados no Project Server. Você deve especificar o nome de um campo válido no projeto. Para determinar o nome de um campo interno, remova os espaços de nome amigável e o resultado com "pj" de prefixo. Por exemplo, o nome do campo para o Gerenciador de Status é pjStatusManager e o nome do campo personalizado 01 é pjCustom01. Restrições existentes em como você pode mapear os campos internos e personalizados, e você deve coincidir com os tipos de dados de campos. Para obter mais informações, consulte Restrições de mapeamento de campos do Project Server para integração com de Team Foundation Server.

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

Download field mappings from Collection0

Outra mensagem é exibida após as ações de comando. Por exemplo, a seguinte mensagem aparece quando tiver sido baixado o arquivo de mapeamento de campo:

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

Observações sobre o carregamento de mapeamentos de campo

As seguintes ações ocorrem quando você executa o /UploadFieldMappings opção:

Se nenhum mapeamento de campo é definido para a coleção de projeto de equipe e você não especificar o /useDefaultFieldMappings opção, uma mensagem solicitará que você crie um mapeamento de campo padrão.
Se os mapeamentos de campo existirem e você especificar o /useDefaultFieldMappings opção, uma mensagem pede que você confirme se deseja substituir os mapeamentos existentes.
Você deve especificar o /force opção se você deseja substituir os mapeamentos de campo que foi carregados anteriormente em uma coleção.
O arquivo de mapeamento de campo é validado antes que seja carregado. Se você tiver um erro de sintaxe, ou se você tiver especificado um campo que não é válido, aparece uma mensagem de erro.

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

Cada campo de espelho de Team Foundation está configurado para estar em conformidade com os campos mapeados.
Para tipos de item de trabalho que foram mapeados para uma coleção ou um projeto de equipe, os novos mapeamentos aparecem na Project Server o guia do formulário de item de trabalho.

Importante
Quando você mapeia um campo de Team Foundation Server para o Project Server, certifique-se de que a coincidir com os tipos de dados nesses campos. Caso contrário, o seguinte erro pode aparecer ao tentar carregar os mapeamentos de campo: O índice (baseado em 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.

Quando você mapeia um campo de Team Foundation Server para o Project Server, certifique-se de que a coincidir com os tipos de dados nesses campos. Caso contrário, o seguinte erro pode aparecer ao tentar carregar os mapeamentos de campo:

O índice (baseado em 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.

Voltar ao topo

Exemplos

Download do campo mapeamento de arquivo que está definido para uma coleção de projeto de equipe

O exemplo a seguir baixa os mapeamentos de campo são definidos para AdventureWorksCollection para AWMappingFile.xml.

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

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

O exemplo a seguir carrega o AWMappingFile.xml para AdventureWorksCollection e substitui qualquer mapeamento de campo que foram definido anteriormente.

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

Voltar ao topo