Remover um componente da participação na sincronização de dados

Artigo
06/10/2015

É possível remover componentes configurados para participar em sincronização de dados entre Visual Studio Team Foundation Server (TFS) e Microsoft Project Servidor. Para encerrar a sincronização permanentemente, é necessário desmapear a coleção de projetos de cada equipe que estiver mapeada e cancelar o registro de cada instância do Project Web Access ou Project Web App (PWA) que estiver registrada para TFS.

Componentes que podem ser removidos da participação na sincronização:

Todos os componentes
Um plano de projeto corporativo
Coleção de projetos da equipe
Uma instância de PWA
Um tipo de item de trabalho
Um campo de item de trabalho

Ao mover servidores ou coleções, não é necessário encerrar a sincronização, mas é necessário realizar algumas tarefas administrativas adicionais. Para obter mais informações, consulte Alterar a configuração de sua implantação.

Ao excluir uma tarefa do Project Server que foi sincronizada com um item de trabalho em Team Foundation, a associação entre a tarefa e o item de trabalho é removida. Itens de trabalho permanecem no banco de dados para Team Foundation. Se desejar excluir esses itens de trabalho, é necessário usar o comando witadmin destroywi. Para obter mais informações, consulte Excluir tarefas e remover itens de trabalho que não participam mais da sincronização.

Requisitos

Para usar esses comandos, sua permissão para Administrar a integração com o Project Server deve estar definida para Permitir. Além disso, a conta de serviço para Team Foundation Server deve possuir as permissões necessárias para interagir com a instância do PWA que participará da sincronização de dados. Para registrar ou cancelar o registro de uma instância do PWA, é necessário pertencer ao grupo Administradores da instância. Para obter mais informações, consulte Atribuir permissões para dar suporte à integração TFS-Project Server.

Dica

Mesmo ao fazer logon com permissões administrativas, é necessário abrir uma janela elevada do Prompt de Comando para executar a ferramenta de linha de comando TfsAdmin em um servidor que estiver executando Windows Server 2008.Para abrir uma janela elevada do Prompt de Comando, escolha Iniciar, abra o menu de atalho do Prompt de Comando e escolha Executar como Administrador.Para obter mais informações, consulte a seguinte página no site da Microsoft: Controle de Acesso de Usuário.

Remover integração e encerrar sincronização

A seguinte ilustração mostra a sequência sistemática de etapas tomadas para encerrar o mecanismo de sincronização e remover a integração do Team Foundation Server e do Project Server. É possível realizar a sequência de etapas conforme mostrado ou usar a comutação /force ao realizar a etapa 3 usando a opção de comando TfsAdmin ProjectServer /UnMapPWAFromCollection.

Fluxo de trabalho para remover o mapeamento entre PS e o TFS

Dica

Se você excluir não apenas uma coleção de projeto de mapeamento, mas também todas as instâncias do PWA que foram mapeadas para ele, você removerá todos os mapeamentos de itens de trabalho que foram sincronizados.No entanto, a instância do PWA para Team Foundation Server ainda estará registrada.

A comutação /force remove automaticamente componentes mapeados ou vinculados. Ao usar essa comutação, é necessário executar apenas um comando para cada coleção e instância do PWA que deseja remover da participação na sincronização. Para encerrar o mecanismo de sincronização usando a comutação /force, realize as seguintes ações na sequência indicada:

Remova o mapeamento para cada coleção conforme descrito por Removendo uma coleção do team project da participação na sincronização mais adiante neste tópico.
Cancelar o registro de cada instância do PWA conforme descrito por Removendo uma instância do PWA da participação na sincronização mais adiante neste tópico.

O mecanismo de sincronização é executado sob um serviço de tarefa gerenciado pelo Team Foundation Background Job Agent. Um mecanismo de sincronização é registrado para cada coleção que for mapeado para uma instância do PWA. Ao remover a integração do Project Server e Team Foundation Server, a sincronização é encerrada e as seguintes ações são causadas:

Remove a associação entre tarefas em itens de trabalho e do Projeto no projeto da equipe.
Remove a associação entre planos de projeto corporativo e projetos da equipe. Essa alteração inclui a remoção da guia Project Server dos formulários de todos os tipos de itens de trabalho no projeto da equipe que não estiverem mais mapeados, caso nenhum outro plano estiver mapeado para o projeto da equipe.
Remove a associação entre coleções e uma instância do PWA.
Remove a associação entre a instância do PWA e o Team Foundation Server.

Remove um plano corporativo da participação na sincronização

Um plano é removido da participação na sincronização ao desmapeá-lo do projeto da equipe. Antes de poder desmapear o plano, primeiro é necessário excluir todas as tarefas que estiverem vinculadas aos itens de trabalho no projeto da equipe mapeado. Como alternativa, é possível usar o sinalizador /force para remover esses vínculos.

Desmapear um plano de projeto corporativo de um projeto da equipe

Abra uma janela do Prompt de Comando em que o Visual Studio 2013 ou o Team Explorer 2013 esteja 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%.
Digite o comando a seguir e pressione a tecla ENTER.
```
TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName /force
```
Substitua tpcUrl pela URL da coleção de projetos da equipe, EnterpriseProjectName pelo nome do plano de projeto corporativo e TeamProjectName pelo nome do projeto da equipe.
Aguarde até visualizar as seguintes mensagens:

Desmapeando projeto corporativo EnterpriseProjectName do projeto da equipe TeamProjectName.

O projeto corporativo EnterpriseProjectName foi desmapeado com sucesso do projeto da equipe TeamProjectName.

Remover uma coleção de projetos da equipe da participação na sincronização

Uma coleção é removida da participação na sincronização ao desmapeá-la da instância do PWA. Antes de poder desmapear a coleção, primeiro é necessário desmapear todos os planos de projeto que estão mapeados a projetos da equipe na coleção. Como alternativa, é possível usar o sinalizador /force para desmapear todos os projetos da equipe.

Desmapear uma coleção e todos os projetos da equipe de uma instância do PWA

Abra uma janela do Prompt de Comando, digite o comando a seguir e pressione a tecla ENTER.
```
TfsAdmin ProjectServer /UnMapPWAFromCollection /pwa:pwaUrl /collection:tpcUrl /force
```
Substitua pwaUrl pela URL da instância do PWA e tpcUrl pela URL da coleção.
Aguarde até visualizar as seguintes mensagens:

Desmapeando a coleção de projetos da equipe tpcUrl do PWA pwaUrl.

A coleção de projetos da equipe tpcUrl foi desmapeada com sucesso do PWA pwaUrl.

Remover uma instância do PWA da participação na sincronização

Como etapa final na remoção da integração, é necessário cancelar o registro de cada instância do PWA que estava registrada com Team Foundation Server. É necessário cancelar o registro de todas as instâncias do PWA que não contêm mais projetos corporativos que devem sincronizar seus dados com Team Foundation.

Cancelar o registro de uma instância do PWA

Abra uma janela do Prompt de Comando, insira o comando a seguir e pressione a tecla ENTER:
```
TfsAdmin ProjectServer /UnregisterPWA /pwa:pwaUrl /tfs:tfsUrl
```
Substitua pwaUrl pela URL da instância do PWA e tfsUrl pela URL do servidor da camada do aplicativo.

Aguarde até as seguintes mensagens serem exibidas:

Cancelando o registro de PWA pwaUrl.

Registro de PWA cancelado com sucesso pwaUrl.
Repita a etapa 2 para cada instância do PWA com suporte a planos de projeto corporativo que deseja remover da participação na sincronização com Team Foundation.

Remover um tipo de item de trabalho da participação na sincronização

É possível remover um ou mais tipos de itens de trabalho da participação na sincronização de dados de um projeto da equipe usando o comando TfsAdmin ProjectServer /UnmapWorkItemTypes. Se qualquer item de trabalho do tipo que desejar remover estiver sendo sincronizado, é possível especificar a comutação /force para remover os vínculos que os associam às tarefas correspondentes no Projeto.

Para obter mais informações, consulte Especificar os tipos de itens de trabalho a serem sincronizados.

Remover um campo da participação na sincronização

É possível remover um ou mais campos da participação na sincronização de dados de uma coleção de projetos da equipe. Um campo é removido da sincronização ao remover seus mapeamentos. Os campos que são necessários para sincronização não devem ser removidos. Para obter mais informações, consulte Personalizar o mapeamento de campos entre o TFS e o Project Server e Gerenciar mapeamentos de campo para a integração do TFS com o Project Server.