Compartilhar via

Definir os tipos de itens de trabalho disponíveis para sincronização

  • Artigo

Antes de poder sincronizar dados entre Visual Studio Team Foundation Server (TFS) e o servidor de Microsoft Project , você deve configurar a integração dos dois produtos de servidor. Como parte das tarefas de configuração, você deve associar um plano de projeto da empresa com um projeto de equipe, e você deve especificar os tipos de itens de trabalho que participarão em sincronia. Após fazer suas configurações inicial e mapeamento, você pode alterar os tipos de itens de trabalho que são mapeados.

Você pode gerenciar os tipos de itens de trabalho que participam de sincronização usando as seguintes opções de ferramenta de linha de comando TfsAdmin ProjectServer :

  • /MapWorkItemTypes: Define os tipos de itens de trabalho que podem participar na sincronização para um projeto de equipe. Embora você possa mapear vários tipos, apenas estes itens de trabalho que são enviados publicando são sincronizados.

  • /GetMappedWorkItemTypes: Retorna a lista de tipos de item de trabalho que são configurados para participar na sincronização para um projeto de equipe.

  • /UnmapWorkItemTypes: Remove os tipos de item de trabalho de participação na sincronização para um projeto de equipe.

Para obter uma visão geral de como integrar os dois produtos de servidor, consulte Configurar a integração TFS-Project Server. Para obter uma visão geral de como associar um projeto da empresa com um projeto de equipe, consulte Gerenciar a associação de projetos corporativos a projetos de equipe.

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. 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 PWA 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 /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/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

/teamProject:TeamProjectName

Especifica o nome de um projeto de equipe que é definido na coleção de projeto.

/workItemTypes:ListofWorkItemTypes

Especifica, em uma lista delimitada por vírgulas, os nomes de referência de um ou mais tipos de itens de trabalho. Você deve especificar somente os tipos de itens de trabalho cujos dados você deseja controlar o professional Project. Por exemplo, você pode especificar os seguintes tipos de itens de trabalho para suportar um processo agile como “User Story,Task” ou “User Story”,Task. Não inclua um espaço após a vírgula.

/skipUIChanges

Especifica que o guia de Project Server no formulário de item de trabalho não deve ser alterado para os tipos que você especificar. Você deve incluir este sinalizador se você personalizou a guia de Project Server para os tipos afetados ou comando de MapWorkItemTypes não pode concluir. Você pode atualizar manualmente uma definição de tipo. Para obter mais informações, consulte Elementos XML adicionados à definição para o tipo de item de trabalho.

/force

Remove todos os links que associa itens de trabalho dos tipos que você especifica para tarefas em Project. Se você usa essa opção, você pode remover os tipos de itens de trabalho de participação na sincronização de dados, mesmo se um ou mais itens de trabalho do tipo que estão sendo sincronizados atualmente.

/? ou help

Exibe informações sobre o comando.

Comentários

Quando você executa um comando, uma mensagem aparecer que indica que ação está sendo executada em qual objeto. Por exemplo, a seguinte mensagem indica que as histórias e tarefas do usuário estão sendo configuradas participar na sincronização de dados.

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .

Outra mensagem aparece após o comando ser concluído. Por exemplo, a seguinte mensagem indica que as histórias e tarefas do usuário foram configurados com êxito.

You have successfully configured the following work item types for team project ProjA: User Story, Task.

Além de configurar os tipos de itens de trabalho que podem participar em sincronia, o comando de /MapWorkItemTypes executa as seguintes operações:

  • Adiciona os tipos de itens de trabalho que você especifica para o conjunto de tipos que participam na sincronização de dados. Isto é, o comando não faz unmap quaisquer tipos mapeada existentes.

  • Adiciona o guia de Project Server a formulários para os tipos de itens de trabalho que você especificar.

    Se um guia de Project Server já está definido para um tipo de item de trabalho que você especificar, esse tipo é ignorado, e nenhuma alteração é feita a formulários para itens de trabalho do tipo.

Se você tentar mapear os tipos de item de trabalho para um projeto de equipe que não está associado com um plano de projeto da empresa, um erro aparecerá. Você pode mapear tipos de item de trabalho somente para os projetos de equipe que são configurados para participar na sincronização. Para obter mais informações, consulte Gerenciar a associação de projetos corporativos a projetos de equipe.

Se você remover o mapeamento para um tipo de item de trabalho, o guia de Project Server é removido do formulário para aquele tipo para o projeto de equipe que você unmapped.

Antes de unmap um tipo para um projeto de equipe, você de item de trabalho deve excluir as tarefas de plano de projeto da empresa remover todas as associações entre eles e itens de trabalho em Team Foundation. Depois de excluir as tarefas de plano de projeto da empresa, você deve publicá-lo e esperar a sincronização para concluir. Como alternativa, você pode especificar o sinalizador de /force para remover todos os links que associa itens de trabalho para tarefas para o projeto de equipe. Apenas esses itens de trabalho que são os tipos que você especifica são removidos de participação em sincronia.

Dica

Se você excluir as tarefas, você pode desejar-las a primeira impressão para outro plano para manter um registro deless.

Exemplos

Tipos de item de trabalho de lista que são mapeados

O exemplo a seguir recupera os tipos de itens de trabalho que são configurados para participar na sincronização para o projeto de equipe Contoso em DefaultCollection em AdventureWorksServer.

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

Mapear um tipo de item de trabalho para um projeto de equipe

O exemplo a seguir configura as histórias de usuário e tarefas participar na sincronização de dados para Contoso projeto.

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

Remova o mapeamento de um tipo de item de trabalho para um projeto de equipe

O exemplo a seguir remove as tarefas de participação na sincronização de dados para o projeto de Contoso.

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

Consulte também

Conceitos

Especificar os tipos de itens de trabalho a serem sincronizados

Mapear componentes de integração [TfsAdmin ProjectServer]

Outros recursos

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