Personalizando o mapeamento de campo entre o Project Server e do Team Foundation Server

Para sincronizar dados entre um plano de projeto da empresa e um projeto de equipe, você deve associar os campos de item de trabalho em Visual Studio Team Foundation Server 2010 com os campos na Microsoft Project Server 2007 ou 2010 do Project Server. Você pode adicionar campos e especificar como eles sincronizem personalizando os mapeamentos de campo. Você pode mapear os campos internos e personalizados de projeto. Por exemplo, você pode compartilhar dados não relacionados a agendas (como, por exemplo, centros de custo, os nomes de equipe ou status de integridade) se você adicionar campos que armazenam esses tipos de dados para os mapeamentos.

Você mantém um conjunto de mapeamentos de campo para cada conjunto de projeto de equipe hosts equipe de projetos que você deseja sincronizar com o Project Server. Você deve definir os mapeamentos de campo para cada conjunto de projeto de equipe que você tiver mapeado para uma instância do Project Web Access ou projeto Web App (PWA). Você pode carregar os mapeamentos padrão, ou você pode personalizar um arquivo de mapeamento e carregá-lo. Para carregar os mapeamentos padrão, consulte Carregar mapeamentos posteriormente neste tópico.

Como mostra a ilustração a seguir, você pode personalizar os mapeamentos de cinco etapas:

Personalizando os mapeamentos de campo entre de Team Foundation Server e o Project Server

Importante

Você pode atualizar o arquivo de mapeamento com tanta freqüência como você deseja. Os campos que aparecem sobre o Project Server guia são atualizados para cada tipo de item de trabalho que participa de sincronização de dados. Você não deve alterar manualmente as definições para o Project Server guia. Para obter mais informações, consulte Personalizar o guia do servidor de projeto posteriormente neste tópico.

Neste tópico

• Mapeamentos padrão

• Determinar os campos adicionais para o mapa

• Mapeamentos de baixar para um arquivo

• Atualizar mapeamentos

• Carregar mapeamentos

• (Opcional) Personalizar a guia do servidor de projeto

Permissões necessárias

Para concluir os procedimentos neste tópico, você deve ter o a integração de administrar o Project Server permissão definida Permitir. Além disso, o serviço de conta para Team Foundation Server deve ser concedido a a integração de administrar o Project Server. Para obter mais informações, consulte Atribuir permissões a integração de suporte do Project Server e do Team Foundation Server.

Mapeamentos padrão

Os mapeamentos de determinam quais campos são sincronizados quando um usuário atualiza as informações em Team Foundation ou o Project Server. Cada um dos seguintes tipos de sincronização tem seu próprio conjunto de mapeamentos:

• Para Publicar sincronização, os dados no Project Server atualiza os dados na Team Foundation. Você pode usar o targetToTfs elemento para especificar o campo no Project Server, que atualiza o campo Team Foundation.

• Para a sincronização de status, os dados de Team Foundation é enviada para a fila de status no Project Server. Você pode usar o tfsToTarget elemento para especificar o campo que atualiza o campo de fila de status no Project Server.

Para obter mais informações sobre esses dois tipos de sincronização, consulte Visão geral do processo de sincronização de Team Foundation Server e a integração do Project Server.

A tabela a seguir lista o conjunto padrão de campos que são mapeados entre Team Foundation e o Project Server. A tabela também indica quais tipos de itens de trabalho usam os campos com base nos modelos de projeto de três para o Microsoft Solutions Framework (MSF). Se você está mapeando para um projeto de equipe foi criado a partir de um modelo de processo baseado em v 5.0 do desenvolvimento de Software ágil ou v 5.0 a melhoria do processo de integração de modelo de maturidade de capacidade (CMMI), você não deve modificar esses mapeamentos. Se você está mapeando para um projeto de equipe foi criado a partir do modelo de processo Scrum 1.0, você precisará fazer algumas modificações como Modificar mapeamentos ao mapeamento de campos para uma equipe de projeto que foi criado usando o modelo de processo Scrum 1.0 descreve neste tópico.

Para obter mais informações sobre mapeamentos e o processo de sincronização, consulte Campo de referência do elemento XML de mapeamento para a integração de Team Foundation Server de e o Project Server.

Voltar ao topo

Adicionando campos para tipos de itens de trabalho quando o mapeamento para um projeto de equipe foi criado a partir do modelo de processo Scrum 1.0

Porque o modelo de processo Scrum 1.0 não usa os campos concluída funcionam e estimativa Original, você deve adicionar esses campos para os tipos de itens de trabalho que você deseja participar da sincronização de dados. Por exemplo, você pode adicionar os campos não utilizados para o tipo de tarefa do item de trabalho.

Para adicionar esses campos, você deve exportar o tipo de tarefa do item de trabalho do projeto de equipe e, em seguida, para cada campo, adicione um FIELD elemento a FIELDS seção. Você também pode adicionar um Control elemento a FORM seção. Você pode adicionar o seguinte FIELD elementos:

<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>The number of units of work that have been spent on this task</HELPTEXT>
</FIELD>
<FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>Initial value for Remaining Work - set once, when work begins. </HELPTEXT>
</FIELD>

Você também pode adicionar o seguinte Control elementos:

<Control FieldName="Microsoft.VSTS.Scheduling.OriginalEstimate" Type="FieldControl" Label="Original Estimate:" LabelPosition="Left" />
<Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed:" LabelPosition="Left" />

Para obter mais informações, consulte Exportar e importar os tipos de Item de trabalho a partir de um projeto existente, A definição de campos de Item de trabalho e Criando e personalizando um formulário de Item de trabalho.

Voltar ao topo

Determinar os campos adicionais para o mapa

Determine as seguintes informações para cada campo que você deseja sincronizar com os campos padrão:

• O nome de referência do campo na Team Foundation. Se você deseja sincronizar um campo no Project Server com um campo que você deve criar no Team Foundation, primeiro crie o campo em cada tipo de item de trabalho que você está sincronizando. Para obter mais informações, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF e A definição de campos de Item de trabalho.

• O nome do campo no Project Server que irá atualizar o campo Team Foundation. Para obter uma lista de campos disponíveis, consulte Restrições de mapeamento de campos do Project Server para integração com de Team Foundation Server.

• O nome do campo na fila de status para o Project Server que Team Foundation será a atualização.

• Se exibir os campos do formulário de item de trabalho. Você define o valor de displayTfsField atributo para true para campos que você deseja que apareça no formulário de item de trabalho. Você define o valor de displayTfsMirror atributo para true para o item de trabalho formulário.

• Se deseja resolver conflitos de dados, permitindo que o valor do campo no Team Foundation para substituir o valor do campo no Project Server ou para manter os dois valores. Essa decisão determina o valor de onConflict atributo.

• Valores adicionais que você deve definir para dar suporte à escolha listas ou tabelas de pesquisa personalizada no Project Server.

Voltar ao topo

Restrições de dados que você pode mapear

Depois de determinar quais campos você deseja mapear, observe as seguintes restrições:

• Você pode enviar apenas o nível de tarefa informações, pjTask * campos, a partir do Project Server para Team Foundation Server.

• Você pode enviar informações de nível de recurso somente, pjResource * campos, de Team Foundation Server para a fila de status do Project Server.

• O campo título é o único campo, você pode enviar para Team Foundation Server e para a fila de status.

• Pacote cumulativo de atualizações é calculado automaticamente para os campos de atribuição, trabalho concluído e trabalho restante. Você não pode mapear os campos adicionais e ter rollup calculado para eles. Para obter mais informações, consulte Trabalhando com o pacote cumulativo de atualizações de recursos em projetos da empresa mapeado para projetos de equipe.

• Você deve certificar-se de que as unidades de cada campo que você mapeie ou de tipos de dados em conformidade com os critérios de mapeamento de campo para campos da empresa de padrão e personalizados. Para obter mais informações, consulte "Dados tipos e campo mapeamento critérios em" Restrições de mapeamento de campos do Project Server para integração com de Team Foundation Server.

• Você pode mapear os campos que estão associados a listas de opções em Team Foundation. No entanto, você deve criar tabelas de pesquisa no Project Server para corresponder às listas de opções. Você não pode sincronizar automaticamente listas de opções e tabelas de pesquisa.

Para obter mais informações, consulte Restrições de mapeamento de campos do Project Server para integração com de Team Foundation Server.

Voltar ao topo

Exemplo: Mapear o nome apareça no projeto de equipe

No exemplo a seguir, a seqüência personalizada de campo em Team Foundation, MyCompany.MyOrg.DevTeamName, é mapeado para um campo de texto personalizado da empresa no Project Server, pjMyCompanyTeamName. Você pode usar este exemplo, para exibir, no Project Professional, o nome da equipe que está associado uma tarefa.

<field tfsName="MyCompany.MyOrg.DevTeamName" tfsMirrorName="Mirror.MyCompany.MyOrg.DevTeamName" displayTfsField="false" displayTfsMirror="false" onConflict="DoNothing">
   <tfsToTarget>
   v<target provider="ProjectServerStatusQueue" name=" pjMyCompanyTeamName" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" pjMyCompanyTeamName" />
   </targetToTfs>
</field>

Nenhum campo aparece no formulário de item de trabalho. Além disso, se os valores não coincidem, cada campo mantém seu próprio valor.

Voltar ao topo

Exemplo: Exibindo a área e os caminhos de iteração no projeto

Você pode mapear o área (System.AreaPath) e iteração (System.IterationPath) campos Team Foundation para que eles apareçam em seus planos de projeto. Porque esses campos de caminho de árvore mudam com freqüência, você deve mapeá-los como campos de texto no projeto. Os gerentes de projeto que usam esses campos devem inserir manualmente o caminho da área total ou o caminho de iteração.

Importante

A implementação atual do Visual Studio Team Foundation Server 2010 e Project Server não oferece suporte à integração a sincronização automática de listas de valores de permissão selecione listas, listas globais ou listas de caminho de árvore que são definidas para os campos mapeados entre o servidor de dois produtos. Para obter a melhor experiência, você deve fazer entradas manuais no plano de projeto que coincidam com os Team Foundation. Se você especificar uma entrada que não é válida, aparecerá uma caixa de diálogo de validação quando você publicar o plano.

Para adicionar os campos de Area e Iteration para um plano de projeto, execute as seguintes ações:

1. Adicionar dois campos da empresa personalizado ao Project Server e rotulá-las como Área (TFS) e Iteração (TFS).

   Para obter mais informações, consulte a seguinte página no site da Microsoft: Criando tabelas de pesquisa e campos personalizados da empresa.

2. Exporte os mapeamentos de campo da coleção de projeto de equipe onde são definidos os projetos de equipe.

   Para obter mais informações, consulte Mapeamentos de baixar para um arquivo posteriormente neste tópico.

3. Adicione o seguinte código ao arquivo:

   <field tfsName="System.AreaPath" tfsMirrorName="Mirror.System.AreaPath" displayTfsField="true" displayTfsMirror="true">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Area (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Area (TFS)" />
           </targetToTfs>
         </field>
         <field tfsName="System.IterationPath" tfsMirrorName="Mirror.System.IterationPath" displayTfsField="false" displayTfsMirror="false">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Iteration (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Iteration (TFS)" />
           </targetToTfs>
         </field>
   

4. Importar os mapeamentos de campo atualizado o arquivo como Carregar mapeamentos descreve neste tópico.

5. Sincronize seu plano de projeto com o Project Server.

6. Adicione as duas novas colunas para novos campos, área (TFS) e iteração (TFS), o plano de projeto

As alterações feitas a área e iteração campos Team Foundation serão sincronizadas com esses campos em seu plano de projeto. Além disso, você pode atualizar esses campos no projeto e publicar suas alterações para Team Foundation se você especificar os valores que foram definidos em Team Foundation.

Voltar ao topo

Baixar os mapeamentos para um arquivo

Observação

Você pode baixar os mapeamentos somente a partir de uma coleção de projeto de equipe ao qual foram carregados. Se você quiser baixar os mapeamentos padrão para um arquivo, primeiro você deve carregar os mapeamentos padrão, conforme descrito em para carregar os mapeamentos padrão posteriormente neste tópico. Como alternativa, você pode copiar o conteúdo dos mapeamentos padrão. Para obter mais informações, consulte Default Field Mappings.

Para baixar os mapeamentos para um arquivo

1. Em um computador que esteja executando o Team Explorer e o Service Pack 1 para Visual Studio Team Foundation Server 2010, abra uma janela de Prompt de comando e altere o diretório que contém o TFSAdmin ferramenta de linha de comando.

   Por padrão, a ferramenta está localizada em Drive: \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.

2. Em um prompt de comando, digite o seguinte comando e pressione ENTER.

   TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:MappingFile 
   

   Substitua tpcUrl com o uniform resource locator (URL) da equipe de projeto da coleção e substituir MappingFile com o caminho e nome do arquivo que você irá personalizar.

3. Espere até que as seguintes mensagens são exibidas:

   Downloading MappingFile to Team Project Collection tpcUrl

   You have successfully downloaded field mapping file MappingFile to Team Project Collection tpcUrl

Voltar ao topo

Atualizar os mapeamentos

Para cada campo que você deseja adicionar ao arquivo de mapeamento, que você especificar o field elemento e sua subelementos e atributos. 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.

Voltar ao topo

Carregar os mapeamentos

Carregue o mapeamentos usando o UploadFieldMappings comando. Você pode carregar os mapeamentos padrão usando o /usedefaultfieldmapping opção. Caso contrário, você deve especificar um arquivo que contém os elementos de mapeamento.

Para carregar os mapeamentos padrão

1. Em um prompt de comando, digite o seguinte comando e pressione ENTER.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /usedefaultfieldmappings
   

   Substitua tpcUrl com o URL da coleção de projeto de equipe.

2. Espere até que as seguintes mensagens são exibidas:

   Uploading default field mappingspara CollectionUri

   You have successfully uploaded field mappings to collection CollectionUri

Para carregar os mapeamentos de um arquivo

1. No prompt de comando, digite o seguinte comando e pressione ENTER.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filepath:MappingFile /force
   

   Substitua tpcUrl com o URL da coleção de projeto de equipe e substituir MappingFile com o caminho e o nome do seu arquivo de mapeamento personalizado. Especificar /force se você estiver atualizando mapeamentos existentes.

2. Espere até que as seguintes mensagens são exibidas:

   Uploading MappingFile to Team Project Collection tpcUrl

   You have successfully uploaded field mapping file MappingFile to Team Project Collection tpcUrl

Voltar ao topo

Personalizar a guia do servidor de projeto

Quando você associa um plano de projeto da empresa um projeto de equipe, a guia do Project Server é adicionada ao formulário de item de trabalho, como mostra a ilustração a seguir. A guia é adicionada somente esses tipos de itens de trabalho que você especificar para participar da sincronização de dados. Você personalizar esse guia, definindo a displayTfsField ou displayTfsMirror atributos para true para esses campos que você deseja ter aparecem no formulário.

Guia do Project Server

Importante

Os mapeamentos de campo são definidos para a coleção de projeto de equipe determinam os campos que aparecem na Project Server guia. Depois que este guia foi adicionada a um tipo de item de trabalho para um projeto de equipe, você pode atualizá-lo modificando os mapeamentos de campo para a coleção. Se você personalizar manualmente o formulário de item de trabalho, adicionando campos para o Project Server guia ou alterando o seu local no formulário, na guia talvez não obtenha automaticamente atualizada com as alterações futuras feitas para os mapeamentos de campo. Se essa condição ocorrer, você pode modificar a guia manualmente.

Para obter mais informações sobre cada campo padrão que aparece na Project Server guia, consulte Campos do Project Server é adicionado à sincronização de dados de suporte.

Voltar ao topo

Consulte também

Outros recursos

Especificar os tipos de Item de trabalho podem ser sincronizados.

Configurando a integração de Team Foundation Server e o Project Server

Administrando a integração de Team Foundation Server e o Project Server