Versionamento de documentos

1. VB - Usando o Visual SourceSafe ( VSS )
Você sabe o que é o Visual SourceSafe - VSS ? De uma forma simplista podemos dizer que o VSS tem
como função principal o controle da versão de um sistema durante o processo de desenvolvimento no
qual temos uma equipe de analista(s) e programador(es) trabalhando em uma equipe.
O VSS funciona como um repositório dos componentes criados pela equipe de desenvolvimento durante o
processo de geração do sistema. Ele armazena os objetos do sistema - formulários , tabelas , consultas,
etc. - em suas diversas versões . Isto permite uma comparação de qualquer objeto para cada versão , ou
seja , você pode comparar o código de uma classe da versão 1.0 com o código da mesma classe já na
versão 2.0 ; pode recuperar um objeto de uma versão anterior e pode bloquear um objeto que esta sendo
usado por um dos integrantes da equipe de forma que os demais não tenham acesso a ele.
Você pode instalar o VSS separadamente , após ter instalado o VB , ou , se possuir o Visual Studio ,
escolher pela instalação do VSS durante a instalação da suite. A instalação pode ser feita no servidor e
nas estações de trabalho.
Após a instalação você deve cadastrar uma senha para o usuário admin (administrador) e também para
cada integrante da equipe de desenvolvimento. Vamos ver como fazer isto:
Acesse o Visual SourceSafe e
selecione - Visual Source Safe Admin
- De inicio você deve se logar como Administrador. Para isto
informe a senha do usuário Admin conforme figura ao lado
Obs- Você pode alterar a senha do administrador selecionando a
opção - Change Password do menu Users
- Após você se logar , verá a tela do
VSS Administrator como a figura ao lado
- Para incluir um novo usuário selecione a opção - Add User.. -
do menu Users

2. - A seguir informe o nome do usuário e
forneça sua senha clicando em OK.
Pronto o usuário será incluído no VSS.
Após isto você pode configurar a segurança que deseja nos projetos controlados pelo VSS . Acesse o
menu Tools opção Options ; na guia - Project Security (veja a tela abaixo) , você pode definir
previlégios para cada integrante da equipe de desenvolvimento , conforme abaixo:
- Se a opção - Enable project security -
estiver inativa todos os usuários terão o mesmo
previlégio dentro de um projeto.
- Se a opção estiver ativa você poderá definir os
previlégios para cada usuário. Os previlégios são
:
- Read - Permite ler o banco de dados do VSS
- Check Out/Check In - Bloqueia objetos
p/alteração - Check Out ; e grava a nova versão
do objeto no VSS - Check In
- Add/Rename/Delete - Inclui, Renomeia e
apaga objetos
- Destroy - Elimina um arquivo de um projeto
ou o próprio projeto do VSS.
Obs: Geralmente você permite que somente o
gerente de projeto da equipe de
desenvolvimento tenha a opção Destroy ativa.
- Se a opção - Enable project security - estiver ativa
podemos atribuir previlégios para cada integrante do
grupo através da opção - Rights Assignments for
User... do menu Tools.(Selecione o usuário antes)

3. - Nesta tela você pode definir os previlégios para
o usuário selecionado.
- No VSS menu Tools->Options você pode configurar
várias opções para o seu ambiente de trabalho com o
VSS
- Geralmente a configuração padrão é suficiente para
trabalhar com o VSS , mas se o seu ambiente de
desenvolvimento requerer um ajuste mais fino existem
várias opções que você pode usar para isto.
Após realizar os passos descritos acima o VSS já esta pronto para ser usado. Geralmente , quando se
trabalha com uma equipe de desenvolvimento com várias pessoas , o VSS é instalado no servidor. Para os
fins deste artigo eu tenho o VSS instalado em minha máquina local e é assim que vou usá-lo para
exemplificar seu uso.
Usando o VSS na prática
Após instalar e configurar o VSS quando você abre
ou cria um projeto no VB irá surgir a tela ao lado.
Nela o VSS pergunta se você quer incluir o projeto
que esta criando ou carregando no SourceSafe. Se
você confirmar e for a primeira vez que você esta
usando o VSS o seu Login será solicitado.

4. - A próxima tela informa o nome do Projeto que você
esta inserindo no VSS.
- Você pode confirmar , cancelar ou criar o projeto
Obs: O VSS exibe todos os projetos que já esta foram
incluidos no Source Control.
-Se o projeto Não existir a tela seguinte solicitara
sua confirmação para criar o mesmo
- A seguir você será solicitado a informar quais
arquivos
deseja incluir no SourceSafe.
- Clicando OK todos os arquivos selecionados serão
incluidos
- Voce pode desmarcar a seleção para alguns arquivos
Após isto o projeto é os arquivos selecionados
estarão sob o controle do SourceSafe.
Ao lado os arquivos sendo exibidos após a inclusão
no SourceSafe
Muito bem , carregue então projeto e tente fazer qualquer alteração no código ou no formulário. Você não
vai conseguir . O código esta protegido e se você tentar excluir algum controle vai receber a mensagem -
File is Ready-Only ; se tentar apagar ou alterar algum trecho de código vai receber a mensagem -
Can´t Edit Module. (Os cadeados ao lado do ícone do projeto e formulário indicam isto)

5. Afinal oque esta acontecendo ??? Ora, é o SourceSafe em ação !!! Para você poder editar o projeto e seu
código , vai ter que ter permissão para isto. O comando que você deve usar para poder alterar qualquer
objeto do sistema é o comando Check-Out. Este é o comando que deve ser usado por qualquer
membro da equipe para fazer alterações no projeto.
- Clique com o botão direito do mouse sobre o projeto
- O menu ao lado irá surgir . Vejas as opções na parte inferior do menu.
- Vejamos o que faz cada uma das opções :
1. Get Latest Version - Pega a última versão do projeto
2. Check-Out - Copia a última versão do objeto presente no banco de
dados do SourceSafe e bloqueia o mesmo para que ninguém mais
possa alterá-lo usando o comando Check-Out.
3. Check-In - Grava as alterações feitas no projeto no banco de dados
do SourceSafe.
4. Undo Check-Out - Desfaz o comando Check-Out em um objeto ou
conjunto de objetos.
Obs: Se você alterar qualquer objeto e depois der um comando - Undo Check-Out - vai receber a
seguinte mensagem :
Ou seja ,o VSS pergunta se você quer desfazer o Check-Out e perder as alterações feitas. As opções são
oferecidas e , a escolha é sua...
Após realizar um Check-Out o membro da equipe pode dar um comando Check-In e gravar as
alterações feitas no VSS ; ao fazer isto o VSS mantém as versões anteriores do objeto no banco de dados
, permitindo com isto a comparação entre as diferentes versões do mesmo objeto.
Para dar um Check-In selecione o objeto que sofreu alteração e clicando com o botão direito do mouse
selecione a opção - Check-In . A tela abaixo será exibida

6. - Aqui você pode confirmar se deseja realmente
gravar as alterações no banco de dados do VSS
-Após confirmar as alterações são gravadas e
os arquivos do projeto são protegidos contra
edição.
Obs: Todos este comando podem também ser executados a partir da barra de
ferramentas do VSS
Comparando versões de um projeto
O VSS lhe dá a possibilidade de comparar as diferentes versões de um objeto. Vamos ver como fazer
isto...
Uma das maneiras de fazer isto é abrir o VSS e selecionar o projeto que você quer analisar. Então no
menu Tools selecione a opção - Show Diferences... - e a seguir clique em - OK - e você verá o
resultado abaixo:
Fig 1.0 - A tela - Difference Options A janela exibindo as diferenças entre as versões do projeto
Você pode exibir as diferenças em outro formato. Basta clicar na opção - Visual - e o resultado será o
seguinte:

7. Aqui as diferenças estão descatas no arquivo de projeto - telnet.vbp.
Bem , esta foi somente uma pequena introdução ao mundo do VSS. Existem muitos outro recursos que
não mencionamos neste artigo ; deixamos o assunto para um próximo artigo.
O principal intuito foi mostrar que com esta ferramenta você pode melhorar a qualidade de seu código ,
evitando retrabalho e trabalhando com segurança , principalmente quando se trabalha em grupo.