Manual de utilização do TFS

(Team Foundation Server)

Revisão 02

Página 1 de 81
 Manual de utilização do TFS

1. INTRODUÇÃO ............................................................................................3
2. INSTALAÇÃO DO CLIENT DO TFS (TEAM EXPLORER) .................................3
3. CONEXÃO AO TFS ......................................................................................5
4. MAPEAMENTO DO WORKSPACE ...............................................................10
5. GET, ALTERAÇÃO E CHECK IN DE ARQUIVOS ...........................................16
6. CONSULTA DE HISTÓRICO, RECUPERAÇÃO DE VERSÕES E COMPARAÇÃO
DE ARQUIVOS ...............................................................................................29
7. GERENCIAMENTO DE BRANCHES .............................................................39
8. GERENCIAMENTO DE LABELS ..................................................................63
9. GERENCIAMENTO DE PERMISSÕES..........................................................68
10. BUSCADOR DE FONTES NO TFS ...............................................................77
11. GLOSSÁRIO .............................................................................................81

Página 2 de 81
 Manual de utilização do TFS

1. INTRODUÇÃO

Esse documento contém informações de uso do Team Foundation Server (TFS) para o controle de versão de
arquivos, definido pelo projeto PHOENIX fase II.

2. INSTALAÇÃO DO CLIENT DO TFS (TEAM EXPLORER)

O TFS (Team Foundation Server) é um repositório centralizado que armazena todos os arquivos contidos no
seu controle de versão. Assim, para ter acesso ao conteúdo do repositório são necessárias ferramentas que
consultem o TFS. São exemplos dessas ferramentas o Team Explorer que pode ser ou não associado a IDE
Visual Studio, e o Team Explorer Everywhere, um plug-in para a IDE Eclipse. Abaixo os procedimentos para
instalação do Team Explorer 2010.

2.1 Copie o diretório ftp.totvs.com.br/tdi/VS2010TE para um diretório local e execute o arquivo

setup.exe contido no mesmo (Link para download do Team Explorer:
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=fe4f9904-0480-4c9d-a264-02fedd78ab38);

2.2 Clique em Next:

Página 3 de 81
 Manual de utilização do TFS

2.3 Marque a opção I have read and accept the license terms e clique em Next:

Clique em Install:

Página 4 de 81
 Manual de utilização do TFS

2.3 Clique em Finish:

3. CONEXÃO AO TFS
O TFS é organizado em Team Projects, unidade que centraliza, controla e armazena todos os artefatos
produzidos por um projeto como os códigos-fonte. Por sua vez, os Team Projects são agrupados em Team
Projects Collections com o objetivo de facilitar a gerenciamento dos Team Projects com aspectos em
comum. A TOTVS adotou o padrão de utilizar uma Team Projects Collection para cada CD e uma para a área
de TI Corporativa. Dentro de cada CD foi adotado que seria criado um Team Project para cada produto de
responsabilidade do CD. Assim, os passos abaixo contêm o procedimento para se conectar a um Team
Project para ter acesso aos dados do produto:

Página 5 de 81
 Manual de utilização do TFS

3.1 Clique em Iniciar > Todos os Programas > Microsoft Visual Studio 2010 > Microsoft Visual Studio
2010:

3.2 Primeiramente é necessário configurar o Proxy do TFS. Para isso Clique em tools > options>Visual
Studio team fondation Server. O Proxy o que deve ser informado é: tfscdjv.totvs.com.br:8081

Página 6 de 81
 Manual de utilização do TFS

3.3 Clique em Team > Connect to Team Foundation Server:

Página 7 de 81
 Manual de utilização do TFS

3.4 Clique em Servers:

3.5 Clique em Add:

Página 8 de 81
 Manual de utilização do TFS

3.6 Em Name or URL of Team Foundation Server, informe o valor tfscdjv.totvs.com.br e clique em Ok:

3.7 Clique em Close:

Página 9 de 81
 Manual de utilização do TFS

3.8 Em Team Project Collections, selecione o seu Centro de Desenvolvimento (CD) ou selecione TI se
você for da TDI. Em Team Projects, selecione um produto e clique em Connect:

4. MAPEAMENTO DO WORKSPACE
Um Workspace é o mapeamento de pastas no Controle de versão do TFS para pastas locais na estação. A
partir dele você consegue obter cópias locais dos arquivos, para então poder alterá-los localmente, até que
estejam prontos para serem atualizados no Controle de versão através da operação de Check In, também
disponível a partir de um Workspace.
Você pode sincronizar seu Workspace com as alterações mais recentes no Controle de versão utilizando a
operação Get Latest Version, ou ainda recuperar uma versão específica de algum arquivo utilizando a
operação Get Specific Version.
Se você desejar ter várias cópias dos arquivos do controle de versão em seu computador, você pode criar
mais de um Workspace para um mesmo Controle de versão no TFS.
Os passos abaixo contêm o procedimento para realizar o gerenciamento de um Workspace:

Página 10 de 81
 Manual de utilização do TFS

4.1 Expanda um produto do seu CD e dê um duplo clique em Source Control:

4.2 Expanda a caixa de seleção Workpace e selecione a opção Workpaces:

Página 11 de 81
 Manual de utilização do TFS

4.3 Clique em Add:

4.4 Em Name informe o nome Capacitação (Privado). Em Working folders clique em Source Control
Folder e selecione o diretório raiz ($/) do CD. Em Local Folder crie a pasta C:\ControleVersão e clique
em Ok:

Página 12 de 81
 Manual de utilização do TFS

4.5 Clique em Close:

4.6 Expanda a caixa de seleção Workspace, valide a criação do workpace privado e clique em Workspace
novamente:

Página 13 de 81
 Manual de utilização do TFS

4.7 Em Name informe o nome Capacitação (Público). Em Permissions selecione a opção Public workpace
e clique em Ok:

4.8 Clique em Close:

Página 14 de 81
 Manual de utilização do TFS

4.9 Expanda a caixa de seleção Workspace, valide a criação do workspace público e clique em
Workpaces novamente:

4.10 Selecione o workspace Capacitação (Público) e clique em Remove. Selecione o workspace com o
nome da estação e clique em Remove:

Página 15 de 81
 Manual de utilização do TFS

4.11 Selecione o workspace Capacitação (Privado) e clique em Close:

5. GET, ALTERAÇÃO E CHECK IN DE ARQUIVOS

A partir do workspace é possível recuperar os arquivos do controle de versão para a estação local,
alterá-los e fazer o check in dos mesmos enviando as alterações para o controle de versão.
Os passos abaixo contém o procedimento para realizar o essas operações:

Página 16 de 81
 Manual de utilização do TFS

5.1 Em Folders, selecione um produto do seu CD e selecione uma pasta do produto que não contenha
pastas internas, somente arquivos. Clique com o botão direito sobre a pasta e clique na opção Get
Latest Version:

Página 17 de 81
 Manual de utilização do TFS

5.2 Selecione um arquivo da pasta recuperada, clique com o botão direito e clique na opção Check Out
for Edit:

5.3 Clique em Check Out:

Página 18 de 81
 Manual de utilização do TFS

5.4 Dê um duplo clique no arquivo com check out, insira, por exemplo, a linha de comentário //Alteração
realizada na capacitação, salve e feche o arquivo:

5.5 Dê um duplo clique em outro arquivo que não está com check out, insira, por exemplo, a linha de
comentário //Segunda alteração realizada na capacitação, salve e feche o arquivo:

Página 19 de 81
 Manual de utilização do TFS

5.6 Perceba que foi feito check out automático do arquivo ao realizar a alteração:

5.7 Clique com o botão direito sobre o arquivo alterado por último e clique em Shelve Pending Changes:

Página 20 de 81
 Manual de utilização do TFS

5.8 Em Shelveset name, informe o nome Capacitação, desmarque a opção Preserve pending changes
locally e clique em Shelve:

5.9 Selecione outro arquivo, clique com o botão direito sobre o mesmo e clique em Lock:

Página 21 de 81
 Manual de utilização do TFS

5.10 Clique em Lock:

5.11 Selecione outro arquivo, clique com o botão direito sobre o mesmo e clique em Delete:

Página 22 de 81
 Manual de utilização do TFS

5.12 Selecione outro arquivo, clique com o botão direito sobre o mesmo, clique em Rename e altere o
nome do arquivo:

5.13 Selecione outro arquivo, clique com o botão direito sobre o mesmo e clique em Move:

Página 23 de 81
 Manual de utilização do TFS

5.14 Em To, selecione um diretório para mover o arquivo e clique em Ok:

5.15 Clique com o botão direito sobre um arquivo alterado e clique em Check In Pending Changes:

Página 24 de 81
 Manual de utilização do TFS

5.16 Em Comment, informe o comentário Capacitação, marque todos os arquivos alterados para fazer
check in e clique em Check In:

5.17 Verifique a mensagem e erro informando que deve ser informado o código do chamado ou do
Projeto\Requisito:

Página 25 de 81
 Manual de utilização do TFS

5.18 Clique com o botão direito sobre um arquivo alterado e clique em Check In Pending Changes:

5.19 Clique em Check-in Notes:

Página 26 de 81
 Manual de utilização do TFS

5.20 Em Chamado, informe o código do chamado e clique em Check In:

5.21 Verifique a mensagem e erro informando que o chamado informado não possui uma tarefa de
desenvolvimento em execução para o usuário:

Página 27 de 81
 Manual de utilização do TFS

5.22 Clique com o botão direito sobre um arquivo alterado e clique em Check In Pending Changes:

5.23 Clique em Check-in Notes:

Página 28 de 81
 Manual de utilização do TFS

5.24 Em Chamado, informe o número do chamado e clique em Check In:

6. CONSULTA DE HISTÓRICO, RECUPERAÇÃO DE VERSÕES E COMPARAÇÃO DE

ARQUIVOS

6.1 Clique com o botão direito sobre um arquivo alterado e clique em View History:

Página 29 de 81
 Manual de utilização do TFS

6.2 Clique com o botão direito sobre a primeira linha do histórico de versões e clique em Changeset
Details:

6.3 Verifique os dados do check in e clique em Check-in Notes:

Página 30 de 81
 Manual de utilização do TFS

6.4 Verifique os dados do check in notes e clique em Cancel:

6.5 Clique com o botão direito sobre a segunda linha do histórico de versões e clique em Compare:

Página 31 de 81
 Manual de utilização do TFS

6.6 Verifique a diferença entre as versões apontadas e feche a janela:

6.7 Clique com o botão direito sobre a primeira linha do histórico de versões e clique em Compare:

Página 32 de 81
 Manual de utilização do TFS

6.8 Verifique qual o último check in realizado em cada linha do arquivo, feche o mesmo e feche o
histórico de versões:

6.9 Clique com o botão direito sobre um arquivo alterado e clique em Check Out for Edit:

Página 33 de 81
 Manual de utilização do TFS

6.10 Clique com o botão direito sobre o arquivo e clique em Get Specific Version:

6.11 Em Type, selecione a opção Changeset e clique no botão de busca (...) do changeset:

Página 34 de 81
 Manual de utilização do TFS

6.12 Em Find options, clique em Find:

Página 35 de 81
 Manual de utilização do TFS

6.13 Em Results, selecione a última linha e clique em Ok:

6.14 Clique em Merge Changes In Merge Tool:

Página 36 de 81
 Manual de utilização do TFS

6.15 Valide a alteração e clique em Ok:

6.16 Clique em Yes:

Página 37 de 81
 Manual de utilização do TFS

6.17 Clique com botão direito sobre o arquivo alterado e clique em Undo Pending Changes:

6.18 Clique em Undo Changes:

Página 38 de 81
 Manual de utilização do TFS

7. GERENCIAMENTO DE BRANCHES
Um Branch de arquivos ou pastas são cópias inteligentes dos mesmos que não replica todo o conteúdo de
origem, e sim apenas a diferença entre o conteúdo de origem e as alterações que são realizadas no
conteúdo do Branch. A relação de Branch permite também o Merge das alterações tanto da origem para o
Branch, quanto do Branch para a origem de maneira simples.
A estratégia de Branches base adotada pela TOTVS será: Cada produto do CD terá Branch base (vBase) a
partir da qual todos os outros Branches serão originados. Para cada versão de inovação ou sustentação do
produto será criado um Branch do Branch base conforme figura abaixo:

Os passos abaixo exercitam o procedimento de gerenciamento de Branches:

Página 39 de 81
 Manual de utilização do TFS

7.1 Clique com o botão direito sobre o branch vBase de um produto ou sobre a pasta Maxime, clique em
Branching and Merging e clique em Branch:

7.2 Em Target, depois de CodigoFonte, substitua o valor existente por /Inovacao/Capacitacao-<seu login
de rede> e clique em Ok:

Página 40 de 81
 Manual de utilização do TFS

7.3 Crie um arquivo na área de trabalho;

7.4 Clique com o botão direito sobre o branch criado e clique em Add Items to Folder:

Página 41 de 81
 Manual de utilização do TFS

7.5 Clique em Browse:

7.6 Selecione a Área de Trabalho e clique em Ok:

Página 42 de 81
 Manual de utilização do TFS

7.7 Selecione o arquivo criado e clique em Next:

7.8 Clique em Finish:

Página 43 de 81
 Manual de utilização do TFS

7.9 Clique em File > Source Control > Unshelve Pending Changes:

7.10 Clique em Details:

Página 44 de 81
 Manual de utilização do TFS

7.11 Desmarque a opção Preserver shelveset on Server e clique em Unshelve:

7.12 No Branch criado, clique com o botão direito sobre o arquivo que foi alterado nos passos anteriores
com a inserção, por exemplo, da linha de comentário //Alteração realizada na capacitação, e clique
em Get Latest Version:

Página 45 de 81
 Manual de utilização do TFS

7.13 Dê um duplo no arquivo e insira a linha, por exemplo, de comentário //Alteração realizada no
Branch, salve e feche o arquivo:

7.14 Clique em View > Other Windows > Pending Changes:

Página 46 de 81
 Manual de utilização do TFS

7.15 Clique em Check-in Notes:

7.16 Em Chamado, informe o código do chamado e clique em Check In:

Página 47 de 81
 Manual de utilização do TFS

7.17 Clique com o botão direito sobre o arquivo alterado e selecione a opção View History:

7.18 Expanda o registro de branch do arquivo (último registro do histórico de versões com a coluna
Change com o valor branch) e veja as versões do arquivo antes do Branch:

Página 48 de 81
 Manual de utilização do TFS

7.19 Selecione a primeira versão do arquivo e clique em Track Changeset:

7.20 Clique em Visualize:

Página 49 de 81
 Manual de utilização do TFS

7.21 Arraste o branch filho (verde) sobre o branch pai:

7.22 Clique em Next:

Página 50 de 81
 Manual de utilização do TFS

7.23 Clique em Next:

7.24 Clique em Finish:

Página 51 de 81
 Manual de utilização do TFS

7.25 Clique em View > Other Windows > Pending Changes:

7.26 Clique em Check-in Notes:

Página 52 de 81
 Manual de utilização do TFS

7.27 Em Chamado, informe o código do chamado e clique em Check In:

7.28 Feche a aba Pending Changes:

Página 53 de 81
 Manual de utilização do TFS

7.29 Clique em Rerun:

7.30 Clique em Visualize:

Página 54 de 81
 Manual de utilização do TFS

7.31 Valide o merge do changeset e clique em Timeline Tracking:

7.32 Valide o merge do changeset e feche a janela Tracking Changeset:

Página 55 de 81
 Manual de utilização do TFS

7.33 Clique com o botão direito sobre o branch criado, selecione a opção Branching and Merging e clique
em View Hierarchy:

7.34 Clique com o botão direito sobre o branch e clique em Compare:

Página 56 de 81
 Manual de utilização do TFS

7.35 Em Target Path, clique no canto direito do botão Browse e clique em Server Path:

7.36 Selecione o branch pai e clique em Ok:

Página 57 de 81
 Manual de utilização do TFS

7.37 Em Target Version, selecione a opção Latest Version na caixa de seleção Type e clique em Ok:

7.38 Valide as diferenças entre os branches e feche a aba Folder Difference:

Página 58 de 81
 Manual de utilização do TFS

7.39 Arraste o branch filho sobre o branch pai:

7.40 Clique em Next:

Página 59 de 81
 Manual de utilização do TFS

7.41 Clique em Next:

7.42 Clique em Next:

Página 60 de 81
 Manual de utilização do TFS

7.43 Clique com o botão direito sobre o branch criado e clique em Delete:

7.44 Clique em View > Other Windows > Pending Changes:

Página 61 de 81
 Manual de utilização do TFS

7.45 Clique em Check-in Notes:

7.46 Em Chamado, informe o código do chamado e clique em Check In:

Página 62 de 81
 Manual de utilização do TFS

8. GERENCIAMENTO DE LABELS
Labels permitem que você tire uma “fotografia” dos seus arquivos de forma que posteriormente possa
recuperá-los para consulta, compilação ou para retornar os arquivos para o mesmo estado de quando o
Label foi criado. Os passos abaixo exercitam o procedimento para gerenciamento de Labels:

8.1 Clique com o botão direito sobre o branch de uma versão de um produto do CD ou da pasta Maxime
para TDI, e clique em Apply Label:

Página 63 de 81
 Manual de utilização do TFS

8.2 Informe em Name o valor Pacote – Capacitação e clique em Create:

8.3 Clique com o botão direito sobre um arquivo do branch e clique em View History:

Página 64 de 81
 Manual de utilização do TFS

8.4 Clique em Labels:

8.5 Valide a criação do Label, clique com o botão direito sobre o mesmo e clique em Edit Label:

Página 65 de 81
 Manual de utilização do TFS

8.6 Clique com o botão direito sobre um arquivo do label, clique em Remove from Label, feche a aba
Label e salve o label:

8.7 Clique em File > Source Control > Label > Find Label:

Página 66 de 81
 Manual de utilização do TFS

8.8 Clique em Find:

8.9 Selecione o label criado e clique em Delete e clique em Close:

Página 67 de 81
 Manual de utilização do TFS

9. GERENCIAMENTO DE PERMISSÕES

9.1 Clique com o botão direito sobre o CD, selecione a opção Team Project Collection Settings e clique
em Group Membership:

9.2 Clique em New:

Página 68 de 81
 Manual de utilização do TFS

9.3 Em Group name, informe o nome Capacitação. Em Description, informe a descrição Grupo criado
para capacitação e clique em Ok:

9.4 Clique em Properties:

Página 69 de 81
 Manual de utilização do TFS

9.5 Em Add member, selecione a opção Windows User or Group e clique em Add:

9.6 Informe o login de rede de um usuário do CD e clique em Ok:

Página 70 de 81
 Manual de utilização do TFS

9.7 Clique em Ok:

9.8 Clique em Close:

Página 71 de 81
 Manual de utilização do TFS

9.9 Clique com o botão direito sobre o CD, selecione a opção Team Project Collection Settings e clique
em Security:

9.10 Em Add users and groups, selecione a opção Team Foundation Server Group e clique em Add:

Página 72 de 81
 Manual de utilização do TFS

9.11 Selecione o grupo <CD>\Capacitação criado anteriormente e clique em Ok:

9.12 Em Permissions for <CD>\Capacitação, selecione a permissão View collection-level information,

marque a opção Allow e clique em Close:

Página 73 de 81
 Manual de utilização do TFS

9.13 Selecione uma pasta de uma versão de um produto do CD, clique com o botão direito sobre ela e
clique em Properties:

9.14 Clique na aba Security:

Página 74 de 81
 Manual de utilização do TFS

9.15 Em Add users and groups, marque a opção Team Foundation Server Groups e clique em Add:

9.16 Selecione o grupo <CD>\Capacitação criado anteriormente e clique em Ok:

Página 75 de 81
 Manual de utilização do TFS

9.17 Em Permissions for <CD>\Capacitação, selecione a permissão Read, marque a opção Allow e clique
em Ok:

9.18 Clique com o botão direito sobre o CD, selecione a opção Team Project Collection Settings e clique
em Group Membership:

Página 76 de 81
 Manual de utilização do TFS

9.19 Clique em Remove e clique em Close:

10. BUSCADOR DE FONTES NO TFS

Este buscador possibilita buscar e/ou consultar os arquivos do TFS, para uma eventual manutenção. Esta
opção facilita a localização do arquivo dentro do TFS, caso você não saiba o caminho que ele se encontra.

Para obter esta opção dentro do TFS, deverá acessar o endereço do FTP (ftp.totvs.com.br/TDI/TFS) e copiar
a pasta TFS Power Tools - Utilitário de Pesquisa e Remoção de Check-in e instalar na maquina local:

Página 77 de 81
 Manual de utilização do TFS

Após instalação, o usuário deverá selecionar a pasta onde se encontram os fontes dentro do TFS e clicar
com o botão direito do mouse sobre ela. No menu aparecerá o item “Find in Source Control”, selecione a
opção Widcard.

Página 78 de 81
 Manual de utilização do TFS

Ao selecionar a opção Wildcard será apresentada a tela para a procura dos fontes, conforme abaixo:

Digite o nome do programa que deseja buscar e clique no botão Find.

Página 79 de 81
 Manual de utilização do TFS

Será aberta a tela com o resultado da consulta, conforme abaixo:

Página 80 de 81
 Manual de utilização do TFS

11. GLOSSÁRIO
Branch - Um Branch de arquivos ou pastas são cópias inteligentes dos mesmos que não replica todo o
conteúdo de origem, e sim apenas a diferença entre o conteúdo de origem e as alterações que são
realizadas no conteúdo do Branch. A relação de Branch permite também o Merge das alterações tanto da
origem para o Branch, quanto do Branch para a origem de maneira simples.
Changeset – Um changeset é um conjunto de modificações confirmadas para um ou mais itens que estão
armazenados no repositório do controle de versão do TFS. Ele também pode conter dados de item de
trabalho, notas de check-in e informações de substituição de diretrizes.
Check In – Esta funcionalidade permite que o usuário libere o arquivo e envie o arquivo modificado para o
servidor.
Check Out – Esta funcionalidade permite que o usuário reserve o arquivo.
Get – Veja em Workspace.
Label - permite que você tire uma “fotografia” dos seus arquivos de forma que posteriormente possa
recuperá-los para consulta, compilação ou para retornar os arquivos para o mesmo estado de quando o
Label foi criado.
Shelving - Permite que o usuário armazene localmente em sua máquina (espaço criado pelo TFS) o arquivo
que ainda não pode ser feito o Check In.
Team Projects - controla e armazena todos os artefatos produzidos por um projeto como os códigos-fonte.
Dentro de cada CD foi adotado que seria criado um Team Project para cada produto de responsabilidade do
CD.
Team Projects Collections – tem como objetivo de facilitar a gerenciamento dos Team Projects com
aspectos em comum. A TOTVS adotou o padrão de utilizar uma Team Projects Collection para cada CD e
uma para a área de TI Corporativa.
TFS - O TFS (Team Foundation Server) é um repositório centralizado que armazena todos os arquivos
contidos no seu controle de versão.
Workspace - é o mapeamento de pastas no controle de versão do TFS para pastas locais na estação. A
partir dele você consegue obter cópias locais dos arquivos, para então poder alterá-los localmente, até que
estejam prontos para serem atualizados no Controle de versão através da operação de Check In, também
disponível a partir de um Workspace. Você pode sincronizar seu Workspace com as alterações mais
recentes no Controle de versão utilizando a operação Get Latest Version, ou ainda recuperar uma versão
específica de algum arquivo utilizando a operação Get Specific Version.
Se você desejar ter várias cópias dos arquivos do controle de versão em seu computador, você pode criar
mais de um Workspace para um mesmo Controle de versão no TFS.

Página 81 de 81