Esse Wiki tem como finalidade explicar todos os passos para a integração do Team Foundation Server 2012 ou 2013 e o Project Server 2013 e os testes de validação para identificar se o sincronismo está funcionando corretamente.
A integração do TFS e Project Server é extremamente importante, pois além de termos o projeto bem alinhado entre a equipe de Projetos e Desenvolvimento, ou o Scrum Master e o time de DEV, também evitamos diversos locais de atualização em que o desenvolvedor
precisa atualizar no TFS, Web do Project Server, etc., além da equipe de projetos e lideres terem que ficar insistindo para que a equipe atualize para que as informações sejam atuais. Ou seja, um trabalho imenso que pode ser evitado fazendo esse sincronismo
e deixando todos felizes e fazendo realmente o que interessa: Programar, Criar, etc.
1 - REQUISITOS
Observe os requisitos para realizar o procedimento corretamente.
1.1 - Permissões
Direitos administrativos no TFS e Project Server (nas aplicações) para a conta de serviço do TFS que irá executar o sincronismo.
Direitos administrativos do usuário ao executar os comandos de sincronismo. Importante que esse usuário também seja administrador do TFS e Project Server para acessar os caminhos da URL.
1.2 - Visual Studio Team Foundation Server 2013
Esse post parte do pressuposto que o TFS 2013 já está instalado e funcional. Dúvidas na instalação poderão ser tiradas no guia de instalação da Microsoft.
http://msdn.microsoft.com/pt-br/library/dd631899.aspx
- Visual Studio Team Explorer 2013
Será necessária a instalação do Team Explorer para execução dos comandos CLI de sincronismo. Instale em sua estação e no servidor TFS.
1.3 - Visual Studio Team Foundation Server 2013 Power Tools
Instale também o Power Tools do TFS para poder usar ele sempre que necessário, como para editar Work Items, etc. Instale em sua estação e no servidor TFS.
http://visualstudiogallery.msdn.microsoft.com/f017b10c-02b4-4d6d-9845-58a06545627f
1.4 - Sharepoint Server 2013
Esse post parte do pressuposto que o Sharepoint 2013 já está instalado e configurada sua integração com o TFS 2013 e também com o Project Server 2013. Dúvidas na instalação poderão ser tiradas no guia de instalação da Microsoft.
http://msdn.microsoft.com/pt-br/library/hh667648.aspx
1.5 - Project Server 2013
Esse post parte do pressuposto que o Project Server 2013 já está instalado e funcional. Dúvidas na instalação poderão ser tiradas no guia de instalação da Microsoft.
http://technet.microsoft.com/pt-br/library/ee662109.aspx
1.6 - Extensões do Project Server 2013 para Team Foundation Server 2013 que está disponível na mídia de instalação do TFS 2013
http://msdn.microsoft.com/en-us/library/hh549244.aspx
Para instalar as extensões do TFS no Project, siga o procedimento abaixo:
Abra a mídia no seu servidor do Project Server e realize a instalação conforme os passos abaixo:
2 - CENÁRIO DE INTEGRAÇÃO
Depois de instalar os pré-requisitos, iremos criar um projeto a partir do zero para realizar a integração.
Primeiramente você deverá executar 03 comandos (execute os comandos com direitos administrativos, de preferência dentro do servidor TFS) para ativar o sincronismo do TFS com o Project Server.
2.1 - Comandos Shell para a integração doTFS e Project Server
Execute esse comando a partir do Team Explorer ou Prompt de Comando do TFS:
Atenção (execute do CMD do Visual Studio 2013).
1. Comando: TfsAdmin ProjectServer /RegisterPWA /pwa:http://servidordoproject/PWA /tfs:https://servidordotfs/tfs/
Obs.: No exemplo do comando está em HTTPS, mas funcionará normalmente em HTTP na porta 8080 se seu TFS estiver publicado dessa forma.
Depois execute o comando abaixo:
2. Comando: TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://servidordoproject/PWA /collection:https://servidordotfs/tfs/collection
Obs.: Collection é a coleção de projetos que você irá mapear.
Caso apresente algum erro, consulte esse Wiki que fiz justamente para incidentes de execução: http://social.technet.microsoft.com/wiki/pt-br/contents/articles/22691.tf244064-an-error-occurred-while-retrieving-event-handler-tfsapprovalsupdatedeventhandler-generalsecurityaccessdenied.aspx
3. Comando: TfsAdmin ProjectServer /UploadFieldMappings /collection:https://servidordotfs/tfs/collection /useDefaultFieldMappings
Obs.: Na tela usei o /force pois já havia mapeado os campos, porém para demonstração realizei novamente o processo.
Qualquer dúvida, você poderá consultar o link: http://msdn.microsoft.com/en-us/library/gg412656.aspx
2.2 Criando um Team Project no TFS
Crie um projeto de desenvolvimento no TFS chamado Projeto Exemplo XII.
Criando um Projeto de Desenvolvimento no Team Foundation Server 2013 (dentro da Collection que você sincronizou):
Siga os passos abaixo:
2.3 - Criando um Projeto no Project Server (EPM).
Crie um projeto no EPM chamado Projeto Exemplo XII (com o mesmo nome do Projeto do Team Foundation Server).
Depois de criado os dois projetos, vamos sincronizar seus campos (no caso iremos mapear Requirement, Task e Bug). Para isso execute o comando abaixo:
4. Comando: TfsAdmin ProjectServer /MapPlanToTeamProject /collection:https://servidordotfs/tfs/collection /enterpriseproject:Projeto Exemplo XII /teamproject:Projeto Exemplo XII /workitemtypes:"Requirement, Bug, Task"
Conforme o tipo de Metodologia de Desenvolvimento que você selecionou ao criar um projeto no TFS, você irá mapear os campos correspondentes a esse tipo de metodologia. No caso, escolhemos CMMI que usa Requirement, se fosse Scrum, iriamos mapear PBI.
Pronto! Os campos estão mapeados, agora vamos aos testes.
3 - VALIDAÇÃO
Se tudo foi configurado corretamente, você poderá observar dentro de um Work Item do projeto sincronizado, em seu Visual Studio, uma nova aba criada chamada Project Server.
Ok, parece que está funcional, vamos realizar o primeiro teste!
3.1 - Criando Work Item do Visual Studio para Publicar para o Project Server
Crie uma Tarefa (TASK) no Visual Studio:
Depois vá na aba Project Server e selecione para sincronizar com o Project Server:
Obs.: No caso da figura, o nome do projeto de empresa é outro PJExemploTFS, pois acabei criando um novo Projeto no TFS e Project Server com esse nome mas, no caso seria o projeto Exemplo XII.
Em seguida salve sua Task.
Obs.: Caso ocorra o erro TF285010, veja esse Wiki que postei para solução do erro.
Para validar se seu Work Item sincronizou, vá na aba History – All Changes e verifique se o sincronismo ocorreu com sucesso, conforme a tela abaixo:
Isso significa que seu Work Item foi para o Project Server e aguarda a aprovação. Vamos conferir?
Abra a Web do seu Project Server e vá no projeto correspondente e em Aprovações e verifique se há uma aprovação sobre o novo Work Item criado:
Agora e só aprovar e verificar se o Work Item já está disponivel na tela do Project Professional.
E lá está ele!
Criando Work Item do Project Professional para Publicar para o Team Foundation Server
Abra seu Project Professional e selecione o Enterprise Project que está sincronizado com o Team Project do TFS.
Crie o Work Item desejado e atribua as informações como nome, recurso (que será o Assigned to do TFS), etc.
Salve e publique.
Aguarde alguns minutos e verifique se o Work Item já está disponível no seu Visual Studio.
E ele está lá!
3.2 - Avaliando se o Work Item é atualizado
Vamos alterar alguns campos do Work Item e salvá-lo:
Agora, vamos identificar se houve alteração no cronograma do Project Professional. Clique em verificar andamento do Projeto em questão:
Aprove a nova atualização.
Clique em OK.
Clique em Sim.
Clique em Sim.
Veja que houve um avanço. Calculado já em % do jeito que o Gestor de Projeto gosta!
Bom é isso, é possível sincronizar mais projetos, coleções, Work Items, conforme sua necessidade!
Espero que esse post ajude a todos!
Este artigo também está disponível nos seguintes idiomas: