Você está na página 1de 81

Manual de utilizao do TFS

(Team Foundation Server)


Reviso 02

Pgina 1 de 81
Manual de utilizao do TFS

1. INTRODUO ............................................................................................3
2. INSTALAO DO CLIENT DO TFS (TEAM EXPLORER) .................................3
3. CONEXO AO TFS ......................................................................................5
4. MAPEAMENTO DO WORKSPACE ...............................................................10
5. GET, ALTERAO E CHECK IN DE ARQUIVOS ...........................................16
6. CONSULTA DE HISTRICO, RECUPERAO DE VERSES E COMPARAO
DE ARQUIVOS ...............................................................................................29
7. GERENCIAMENTO DE BRANCHES .............................................................39
8. GERENCIAMENTO DE LABELS ..................................................................63
9. GERENCIAMENTO DE PERMISSES..........................................................68
10. BUSCADOR DE FONTES NO TFS ...............................................................77
11. GLOSSRIO .............................................................................................81

Pgina 2 de 81
Manual de utilizao do TFS

1. INTRODUO

Esse documento contm informaes de uso do Team Foundation Server (TFS) para o controle de verso de
arquivos, definido pelo projeto PHOENIX fase II.

2. INSTALAO DO CLIENT DO TFS (TEAM EXPLORER)


O TFS (Team Foundation Server) um repositrio centralizado que armazena todos os arquivos contidos no
seu controle de verso. Assim, para ter acesso ao contedo do repositrio so necessrias ferramentas que
consultem o TFS. So exemplos dessas ferramentas o Team Explorer que pode ser ou no associado a IDE
Visual Studio, e o Team Explorer Everywhere, um plug-in para a IDE Eclipse. Abaixo os procedimentos para
instalao do Team Explorer 2010.

2.1 Copie o diretrio ftp.totvs.com.br/tdi/VS2010TE para um diretrio 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:

Pgina 3 de 81
Manual de utilizao do TFS

2.3 Marque a opo I have read and accept the license terms e clique em Next:

Clique em Install:

Pgina 4 de 81
Manual de utilizao do TFS

2.3 Clique em Finish:

3. CONEXO AO TFS
O TFS organizado em Team Projects, unidade que centraliza, controla e armazena todos os artefatos
produzidos por um projeto como os cdigos-fonte. Por sua vez, os Team Projects so agrupados em Team
Projects Collections com o objetivo de facilitar a gerenciamento dos Team Projects com aspectos em
comum. A TOTVS adotou o padro 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 contm o procedimento para se conectar a um Team
Project para ter acesso aos dados do produto:

Pgina 5 de 81
Manual de utilizao do TFS

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

3.2 Primeiramente necessrio 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

Pgina 6 de 81
Manual de utilizao do TFS

3.3 Clique em Team > Connect to Team Foundation Server:

Pgina 7 de 81
Manual de utilizao do TFS

3.4 Clique em Servers:

3.5 Clique em Add:

Pgina 8 de 81
Manual de utilizao 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:

Pgina 9 de 81
Manual de utilizao 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 verso do TFS para pastas locais na estao. A
partir dele voc consegue obter cpias locais dos arquivos, para ento poder alter-los localmente, at que
estejam prontos para serem atualizados no Controle de verso atravs da operao de Check In, tambm
disponvel a partir de um Workspace.
Voc pode sincronizar seu Workspace com as alteraes mais recentes no Controle de verso utilizando a
operao Get Latest Version, ou ainda recuperar uma verso especfica de algum arquivo utilizando a
operao Get Specific Version.
Se voc desejar ter vrias cpias dos arquivos do controle de verso em seu computador, voc pode criar
mais de um Workspace para um mesmo Controle de verso no TFS.
Os passos abaixo contm o procedimento para realizar o gerenciamento de um Workspace:

Pgina 10 de 81
Manual de utilizao do TFS

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

4.2 Expanda a caixa de seleo Workpace e selecione a opo Workpaces:

Pgina 11 de 81
Manual de utilizao do TFS

4.3 Clique em Add:

4.4 Em Name informe o nome Capacitao (Privado). Em Working folders clique em Source Control
Folder e selecione o diretrio raiz ($/) do CD. Em Local Folder crie a pasta C:\ControleVerso e clique
em Ok:

Pgina 12 de 81
Manual de utilizao do TFS

4.5 Clique em Close:

4.6 Expanda a caixa de seleo Workspace, valide a criao do workpace privado e clique em Workspace
novamente:

Pgina 13 de 81
Manual de utilizao do TFS

4.7 Em Name informe o nome Capacitao (Pblico). Em Permissions selecione a opo Public workpace
e clique em Ok:

4.8 Clique em Close:

Pgina 14 de 81
Manual de utilizao do TFS

4.9 Expanda a caixa de seleo Workspace, valide a criao do workspace pblico e clique em
Workpaces novamente:

4.10 Selecione o workspace Capacitao (Pblico) e clique em Remove. Selecione o workspace com o
nome da estao e clique em Remove:

Pgina 15 de 81
Manual de utilizao do TFS

4.11 Selecione o workspace Capacitao (Privado) e clique em Close:

5. GET, ALTERAO E CHECK IN DE ARQUIVOS


A partir do workspace possvel recuperar os arquivos do controle de verso para a estao local,
alter-los e fazer o check in dos mesmos enviando as alteraes para o controle de verso.
Os passos abaixo contm o procedimento para realizar o essas operaes:

Pgina 16 de 81
Manual de utilizao do TFS

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

Pgina 17 de 81
Manual de utilizao do TFS

5.2 Selecione um arquivo da pasta recuperada, clique com o boto direito e clique na opo Check Out
for Edit:

5.3 Clique em Check Out:

Pgina 18 de 81
Manual de utilizao do TFS

5.4 D um duplo clique no arquivo com check out, insira, por exemplo, a linha de comentrio //Alterao
realizada na capacitao, salve e feche o arquivo:

5.5 D um duplo clique em outro arquivo que no est com check out, insira, por exemplo, a linha de
comentrio //Segunda alterao realizada na capacitao, salve e feche o arquivo:

Pgina 19 de 81
Manual de utilizao do TFS

5.6 Perceba que foi feito check out automtico do arquivo ao realizar a alterao:

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

Pgina 20 de 81
Manual de utilizao do TFS

5.8 Em Shelveset name, informe o nome Capacitao, desmarque a opo Preserve pending changes
locally e clique em Shelve:

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

Pgina 21 de 81
Manual de utilizao do TFS

5.10 Clique em Lock:

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

Pgina 22 de 81
Manual de utilizao do TFS

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

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

Pgina 23 de 81
Manual de utilizao do TFS

5.14 Em To, selecione um diretrio para mover o arquivo e clique em Ok:

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

Pgina 24 de 81
Manual de utilizao do TFS

5.16 Em Comment, informe o comentrio Capacitao, 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 cdigo do chamado ou do
Projeto\Requisito:

Pgina 25 de 81
Manual de utilizao do TFS

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

5.19 Clique em Check-in Notes:

Pgina 26 de 81
Manual de utilizao do TFS

5.20 Em Chamado, informe o cdigo do chamado e clique em Check In:

5.21 Verifique a mensagem e erro informando que o chamado informado no possui uma tarefa de
desenvolvimento em execuo para o usurio:

Pgina 27 de 81
Manual de utilizao do TFS

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

5.23 Clique em Check-in Notes:

Pgina 28 de 81
Manual de utilizao do TFS

5.24 Em Chamado, informe o nmero do chamado e clique em Check In:

6. CONSULTA DE HISTRICO, RECUPERAO DE VERSES E COMPARAO DE


ARQUIVOS

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

Pgina 29 de 81
Manual de utilizao do TFS

6.2 Clique com o boto direito sobre a primeira linha do histrico de verses e clique em Changeset
Details:

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

Pgina 30 de 81
Manual de utilizao do TFS

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

6.5 Clique com o boto direito sobre a segunda linha do histrico de verses e clique em Compare:

Pgina 31 de 81
Manual de utilizao do TFS

6.6 Verifique a diferena entre as verses apontadas e feche a janela:

6.7 Clique com o boto direito sobre a primeira linha do histrico de verses e clique em Compare:

Pgina 32 de 81
Manual de utilizao do TFS

6.8 Verifique qual o ltimo check in realizado em cada linha do arquivo, feche o mesmo e feche o
histrico de verses:

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

Pgina 33 de 81
Manual de utilizao do TFS

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

6.11 Em Type, selecione a opo Changeset e clique no boto de busca (...) do changeset:

Pgina 34 de 81
Manual de utilizao do TFS

6.12 Em Find options, clique em Find:

Pgina 35 de 81
Manual de utilizao do TFS

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

6.14 Clique em Merge Changes In Merge Tool:

Pgina 36 de 81
Manual de utilizao do TFS

6.15 Valide a alterao e clique em Ok:

6.16 Clique em Yes:

Pgina 37 de 81
Manual de utilizao do TFS

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

6.18 Clique em Undo Changes:

Pgina 38 de 81
Manual de utilizao do TFS

7. GERENCIAMENTO DE BRANCHES
Um Branch de arquivos ou pastas so cpias inteligentes dos mesmos que no replica todo o contedo de
origem, e sim apenas a diferena entre o contedo de origem e as alteraes que so realizadas no
contedo do Branch. A relao de Branch permite tambm o Merge das alteraes tanto da origem para o
Branch, quanto do Branch para a origem de maneira simples.
A estratgia de Branches base adotada pela TOTVS ser: Cada produto do CD ter Branch base (vBase) a
partir da qual todos os outros Branches sero originados. Para cada verso de inovao ou sustentao do
produto ser criado um Branch do Branch base conforme figura abaixo:

Os passos abaixo exercitam o procedimento de gerenciamento de Branches:

Pgina 39 de 81
Manual de utilizao do TFS

7.1 Clique com o boto 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:

Pgina 40 de 81
Manual de utilizao do TFS

7.3 Crie um arquivo na rea de trabalho;

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

Pgina 41 de 81
Manual de utilizao do TFS

7.5 Clique em Browse:

7.6 Selecione a rea de Trabalho e clique em Ok:

Pgina 42 de 81
Manual de utilizao do TFS

7.7 Selecione o arquivo criado e clique em Next:

7.8 Clique em Finish:

Pgina 43 de 81
Manual de utilizao do TFS

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

7.10 Clique em Details:

Pgina 44 de 81
Manual de utilizao do TFS

7.11 Desmarque a opo Preserver shelveset on Server e clique em Unshelve:

7.12 No Branch criado, clique com o boto direito sobre o arquivo que foi alterado nos passos anteriores
com a insero, por exemplo, da linha de comentrio //Alterao realizada na capacitao, e clique
em Get Latest Version:

Pgina 45 de 81
Manual de utilizao do TFS

7.13 D um duplo no arquivo e insira a linha, por exemplo, de comentrio //Alterao realizada no
Branch, salve e feche o arquivo:

7.14 Clique em View > Other Windows > Pending Changes:

Pgina 46 de 81
Manual de utilizao do TFS

7.15 Clique em Check-in Notes:

7.16 Em Chamado, informe o cdigo do chamado e clique em Check In:

Pgina 47 de 81
Manual de utilizao do TFS

7.17 Clique com o boto direito sobre o arquivo alterado e selecione a opo View History:

7.18 Expanda o registro de branch do arquivo (ltimo registro do histrico de verses com a coluna
Change com o valor branch) e veja as verses do arquivo antes do Branch:

Pgina 48 de 81
Manual de utilizao do TFS

7.19 Selecione a primeira verso do arquivo e clique em Track Changeset:

7.20 Clique em Visualize:

Pgina 49 de 81
Manual de utilizao do TFS

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

7.22 Clique em Next:

Pgina 50 de 81
Manual de utilizao do TFS

7.23 Clique em Next:

7.24 Clique em Finish:

Pgina 51 de 81
Manual de utilizao do TFS

7.25 Clique em View > Other Windows > Pending Changes:

7.26 Clique em Check-in Notes:

Pgina 52 de 81
Manual de utilizao do TFS

7.27 Em Chamado, informe o cdigo do chamado e clique em Check In:

7.28 Feche a aba Pending Changes:

Pgina 53 de 81
Manual de utilizao do TFS

7.29 Clique em Rerun:

7.30 Clique em Visualize:

Pgina 54 de 81
Manual de utilizao 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:

Pgina 55 de 81
Manual de utilizao do TFS

7.33 Clique com o boto direito sobre o branch criado, selecione a opo Branching and Merging e clique
em View Hierarchy:

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

Pgina 56 de 81
Manual de utilizao do TFS

7.35 Em Target Path, clique no canto direito do boto Browse e clique em Server Path:

7.36 Selecione o branch pai e clique em Ok:

Pgina 57 de 81
Manual de utilizao do TFS

7.37 Em Target Version, selecione a opo Latest Version na caixa de seleo Type e clique em Ok:

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

Pgina 58 de 81
Manual de utilizao do TFS

7.39 Arraste o branch filho sobre o branch pai:

7.40 Clique em Next:

Pgina 59 de 81
Manual de utilizao do TFS

7.41 Clique em Next:

7.42 Clique em Next:

Pgina 60 de 81
Manual de utilizao do TFS

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

7.44 Clique em View > Other Windows > Pending Changes:

Pgina 61 de 81
Manual de utilizao do TFS

7.45 Clique em Check-in Notes:

7.46 Em Chamado, informe o cdigo do chamado e clique em Check In:

Pgina 62 de 81
Manual de utilizao 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, compilao 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 boto direito sobre o branch de uma verso de um produto do CD ou da pasta Maxime
para TDI, e clique em Apply Label:

Pgina 63 de 81
Manual de utilizao do TFS

8.2 Informe em Name o valor Pacote Capacitao e clique em Create:

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

Pgina 64 de 81
Manual de utilizao do TFS

8.4 Clique em Labels:

8.5 Valide a criao do Label, clique com o boto direito sobre o mesmo e clique em Edit Label:

Pgina 65 de 81
Manual de utilizao do TFS

8.6 Clique com o boto 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:

Pgina 66 de 81
Manual de utilizao do TFS

8.8 Clique em Find:

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

Pgina 67 de 81
Manual de utilizao do TFS

9. GERENCIAMENTO DE PERMISSES

9.1 Clique com o boto direito sobre o CD, selecione a opo Team Project Collection Settings e clique
em Group Membership:

9.2 Clique em New:

Pgina 68 de 81
Manual de utilizao do TFS

9.3 Em Group name, informe o nome Capacitao. Em Description, informe a descrio Grupo criado
para capacitao e clique em Ok:

9.4 Clique em Properties:

Pgina 69 de 81
Manual de utilizao do TFS

9.5 Em Add member, selecione a opo Windows User or Group e clique em Add:

9.6 Informe o login de rede de um usurio do CD e clique em Ok:

Pgina 70 de 81
Manual de utilizao do TFS

9.7 Clique em Ok:

9.8 Clique em Close:

Pgina 71 de 81
Manual de utilizao do TFS

9.9 Clique com o boto direito sobre o CD, selecione a opo Team Project Collection Settings e clique
em Security:

9.10 Em Add users and groups, selecione a opo Team Foundation Server Group e clique em Add:

Pgina 72 de 81
Manual de utilizao do TFS

9.11 Selecione o grupo <CD>\Capacitao criado anteriormente e clique em Ok:

9.12 Em Permissions for <CD>\Capacitao, selecione a permisso View collection-level information,


marque a opo Allow e clique em Close:

Pgina 73 de 81
Manual de utilizao do TFS

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

9.14 Clique na aba Security:

Pgina 74 de 81
Manual de utilizao do TFS

9.15 Em Add users and groups, marque a opo Team Foundation Server Groups e clique em Add:

9.16 Selecione o grupo <CD>\Capacitao criado anteriormente e clique em Ok:

Pgina 75 de 81
Manual de utilizao do TFS

9.17 Em Permissions for <CD>\Capacitao, selecione a permisso Read, marque a opo Allow e clique
em Ok:

9.18 Clique com o boto direito sobre o CD, selecione a opo Team Project Collection Settings e clique
em Group Membership:

Pgina 76 de 81
Manual de utilizao 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 manuteno. Esta
opo facilita a localizao do arquivo dentro do TFS, caso voc no saiba o caminho que ele se encontra.

Para obter esta opo dentro do TFS, dever acessar o endereo do FTP (ftp.totvs.com.br/TDI/TFS) e copiar
a pasta TFS Power Tools - Utilitrio de Pesquisa e Remoo de Check-in e instalar na maquina local:

Pgina 77 de 81
Manual de utilizao do TFS

Aps instalao, o usurio dever selecionar a pasta onde se encontram os fontes dentro do TFS e clicar
com o boto direito do mouse sobre ela. No menu aparecer o item Find in Source Control, selecione a
opo Widcard.

Pgina 78 de 81
Manual de utilizao do TFS

Ao selecionar a opo Wildcard ser apresentada a tela para a procura dos fontes, conforme abaixo:

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

Pgina 79 de 81
Manual de utilizao do TFS

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

Pgina 80 de 81
Manual de utilizao do TFS

11. GLOSSRIO
Branch - Um Branch de arquivos ou pastas so cpias inteligentes dos mesmos que no replica todo o
contedo de origem, e sim apenas a diferena entre o contedo de origem e as alteraes que so
realizadas no contedo do Branch. A relao de Branch permite tambm o Merge das alteraes tanto da
origem para o Branch, quanto do Branch para a origem de maneira simples.
Changeset Um changeset um conjunto de modificaes confirmadas para um ou mais itens que esto
armazenados no repositrio do controle de verso do TFS. Ele tambm pode conter dados de item de
trabalho, notas de check-in e informaes de substituio de diretrizes.
Check In Esta funcionalidade permite que o usurio libere o arquivo e envie o arquivo modificado para o
servidor.
Check Out Esta funcionalidade permite que o usurio 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, compilao ou para retornar os arquivos para o mesmo estado de quando o
Label foi criado.
Shelving - Permite que o usurio armazene localmente em sua mquina (espao criado pelo TFS) o arquivo
que ainda no pode ser feito o Check In.
Team Projects - controla e armazena todos os artefatos produzidos por um projeto como os cdigos-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 padro de utilizar uma Team Projects Collection para cada CD e
uma para a rea de TI Corporativa.
TFS - O TFS (Team Foundation Server) um repositrio centralizado que armazena todos os arquivos
contidos no seu controle de verso.
Workspace - o mapeamento de pastas no controle de verso do TFS para pastas locais na estao. A
partir dele voc consegue obter cpias locais dos arquivos, para ento poder alter-los localmente, at que
estejam prontos para serem atualizados no Controle de verso atravs da operao de Check In, tambm
disponvel a partir de um Workspace. Voc pode sincronizar seu Workspace com as alteraes mais
recentes no Controle de verso utilizando a operao Get Latest Version, ou ainda recuperar uma verso
especfica de algum arquivo utilizando a operao Get Specific Version.
Se voc desejar ter vrias cpias dos arquivos do controle de verso em seu computador, voc pode criar
mais de um Workspace para um mesmo Controle de verso no TFS.

Pgina 81 de 81