Manual de Utilização Do TFS PDF

Manual de utilizao do TFS
(Team Foundation Server)

Reviso 02
Pgina 1 de 81
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
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
2.3 Marque a opo I have read and accept the license terms e clique em Next:
Clique em Install:
Pgina 4 de 81
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
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
3.3 Clique em Team > Connect to Team Foundation Server:
Pgina 7 de 81
3.4 Clique em Servers:
3.5 Clique em Add:
Pgina 8 de 81
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
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
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
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
4.6 Expanda a caixa de seleo Workspace, valide a criao do workpace privado e clique em Workspace
novamente:
Pgina 13 de 81
4.7 Em Name informe o nome Capacitao (Pblico). Em Permissions selecione a opo Public workpace
e clique em Ok:
Pgina 14 de 81
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
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
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
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
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
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
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
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
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
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
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
5.19 Clique em Check-in Notes:
Pgina 26 de 81
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
Pgina 28 de 81
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
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
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
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
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
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
6.12 Em Find options, clique em Find:
Pgina 35 de 81
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
6.15 Valide a alterao e clique em Ok:
6.16 Clique em Yes:
Pgina 37 de 81
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
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
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
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
7.5 Clique em Browse:
7.6 Selecione a rea de Trabalho e clique em Ok:
Pgina 42 de 81
7.7 Selecione o arquivo criado e clique em Next:
Pgina 43 de 81
7.9 Clique em File > Source Control > Unshelve Pending Changes:
7.10 Clique em Details:
Pgina 44 de 81
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
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
Pgina 47 de 81
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
7.19 Selecione a primeira verso do arquivo e clique em Track Changeset:
7.20 Clique em Visualize:
Pgina 49 de 81
7.21 Arraste o branch filho (verde) sobre o branch pai:
7.22 Clique em Next:
Pgina 50 de 81
Pgina 51 de 81
Pgina 52 de 81
7.28 Feche a aba Pending Changes:
Pgina 53 de 81
7.29 Clique em Rerun:
7.30 Clique em Visualize:
Pgina 54 de 81
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
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
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
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
7.39 Arraste o branch filho sobre o branch pai:
Pgina 59 de 81
Pgina 60 de 81
7.43 Clique com o boto direito sobre o branch criado e clique em Delete:
Pgina 61 de 81
Pgina 62 de 81
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
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
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
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
8.8 Clique em Find:
8.9 Selecione o label criado e clique em Delete e clique em Close:
Pgina 67 de 81
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
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
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
9.7 Clique em Ok:
Pgina 71 de 81
em Security:
9.10 Em Add users and groups, selecione a opo Team Foundation Server Group e clique em Add:
Pgina 72 de 81
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
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
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
9.17 Em Permissions for <CD>\Capacitao, selecione a permisso Read, marque a opo Allow e clique
em Ok:
em Group Membership:
Pgina 76 de 81
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
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
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
Ser aberta a tela com o resultado da consulta, conforme abaixo:
Pgina 80 de 81
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

Manual de Utilização Do TFS PDF

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Manual de Utilização Do TFS PDF

Загружено:

Авторское право:

Доступные форматы

Manual de utilizao do TFS

(Team Foundation Server)

2. INSTALAO DO CLIENT DO TFS (TEAM EXPLORER)

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

2.2 Clique em Next:

2.3 Clique em Finish:

3.3 Clique em Team > Connect to Team Foundation Server:

3.4 Clique em Servers:

3.5 Clique em Add:

3.7 Clique em Close:

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:

4.3 Clique em Add:

4.5 Clique em Close:

4.8 Clique em Close:

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

5. GET, ALTERAO E CHECK IN DE ARQUIVOS

5.3 Clique em Check Out:

5.10 Clique em Lock:

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

5.19 Clique em Check-in Notes:

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

5.23 Clique em Check-in Notes:

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

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

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

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

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

6.12 Em Find options, clique em Find:

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

6.14 Clique em Merge Changes In Merge Tool:

6.15 Valide a alterao e clique em Ok:

6.16 Clique em Yes:

6.18 Clique em Undo Changes:

Os passos abaixo exercitam o procedimento de gerenciamento de Branches:

7.3 Crie um arquivo na rea de trabalho;

7.5 Clique em Browse:

7.6 Selecione a rea de Trabalho e clique em Ok:

7.7 Selecione o arquivo criado e clique em Next:

7.8 Clique em Finish:

7.10 Clique em Details:

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

7.14 Clique em View > Other Windows > Pending Changes:

7.15 Clique em Check-in Notes:

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

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

7.20 Clique em Visualize:

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

7.22 Clique em Next:

7.23 Clique em Next:

7.24 Clique em Finish:

7.25 Clique em View > Other Windows > Pending Changes:

7.26 Clique em Check-in Notes:

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

7.28 Feche a aba Pending Changes:

7.29 Clique em Rerun:

7.30 Clique em Visualize:

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:

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

7.36 Selecione o branch pai e clique em Ok:

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