Visual SourceSafe - Parte 1

Ol pessoal, meu nome Mauricio Junior. Farei uma srie de artigos mostrando
e explicando a forma correta de utilizao do programa da Microsoft chamado Visual
Source Safe. Sero vrias partes mostrando dinamicamente a utilizao do mesmo. Se
voc no conhece, estes artigos podero ajudar da melhor maneira possvel.

Requisitos:
- Visual Studio.NET 2005 instalado
- Framework 2.0 instalado
- Visual Source Safe 2005 ou 2003 instalado

Os programas acima citados so de necessria instalao devido integrao dos
versionadores de arquivos, ou seja, para o Visual Source Safe.

Para que serve

O programa Visual Source Safe serve para manter todas as verses de cdigo
fonte, e dos programas criados por equipes ou por voc. Na realidade, o mesmo pode ser
utilizado para versionar qualquer tipo de arquivo ou cdigo fonte. Hoje em dia,

documentos do Word, Excel, Notepad e outros podem ser mantidos verses especficas
com dos usurios, datas e informaes. Qualquer informao pode ser colocada dentro
do programa, qualquer pessoa que for alterar alguma informao do arquivo, o mesmo
ser versionado com segurana e dados especficos.
um programa muito importante principalmente para empresas, porm pode ser
usado para verses pessoais de dados, documentos e programas. Resumindo serve para:
manter verses de documentos ou artefatos, no importa qual; todas as verses alteradas
sero mantidas.

Banco de dados do visual source safe

O banco de dados do VSS funciona como pasta, pastas onde armazenam dados e
verses dos sistemas. No existe um banco de dados como Access, SQL Server ou
Oracle, so feitos em pastas dentro do prprio local onde o software instalado. Por
exemplo: ao instalar o programa na pasta C:\Arquivos de Programas\VSS,
automaticamente ser colocado uma pasta chamada data cujo ser responsvel para
manter os dados. No importa se o seu servidor de documentos ou computador
pessoal. Ao abrir a pasta, note que existem vrias pastas seguindo o alfabeto, a, b, c, d....
e assim por diante. As extenses dos arquivos so entendidas internamente pelo
software.

Onde Usar

O VSS pode ser usado tanto em servidores especficos para manter arquivos, ou
seja, a sua funcionalidade exclusivamente manter verses de documentao de uma
empresa ou tambm em seu computador pessoal. Isso porque necessrio manter
verses de documentos, artigos, cdigos fontes e outros. Um exemplo bsico de que
qualquer pessoa precisa necessariamente manter as verses de documentos : em
universidade onde todos os alunos mexem em um mesmo arquivo, esse arquivo
atualizado diariamente, porm necessrio manter as verses anteriores e posteriores.
Resumindo, tanto pessoalmente quanto via servidor de dados, necessrio manter um
backup e verses.
O interessante , mesmo que apague do computador o documento fisicamente, o
mesmo pode ser baixado sem qualquer problema do VSS (Visual Source Safe) para a
mquina ou servidor. Isso ajuda a surpreender qualquer pessoa caso os seus dados
forem apagados indevidamente.
Portanto, usar para caso pessoal ou empresarial ser muito bem vindo.

Backup de Dados

Foi falado anteriormente que no existe o seu banco de dados, porm os dados
so guardados dentro de pastas que possuem extenses especficas do software. Mesmo
com esses dados sendo guardados em pastas, no necessrio copiar as pastas e
arquivos para backup, o software disponibiliza em sua parte administrativa um sistema
de backup, onde voc pode escolher todas as pastas e gerar backup dos arquivos; o
resultado do mesmo se torna apenas em um arquivo da extenso .ssa. uma forma
mais fcil e gil para fazer backup dos dados colocando os mesmos em um arquivo.
Conheci vrias pessoas de suporte tcnico de empresas que faziam e fazem
backup dos dados copiando os arquivos de dentro da pasta data; sinceramente a
forma mais errada que j vi, isso tudo por falta de conhecimento da ferramenta, sem
conta que demora uma eternidade para copiar tantos arquivos.
O grande problema dos backups hoje em dia o momento que voc precisa
restaur-lo; isso em todo tipo de backup. Se fizer backup copiando as pastas, ficar
difcil quando for restaurar qualquer tipo de dados; o melhor utilizar a ferramenta de
administrao para criar e restaurar backup. muito simples fazer / restaurar backup no
VSS.

Interao

O VSS possui interao com os principais softwares de desenvolvimento como
Visual Studio, Eclipse e outros. Alm do mais, a cada dia so criados plugins
especficos para essa devida interao.
Quando utilizamos um documento do Word importante dentro do VSS; algum
dia ter que alter-lo. Para que isso acontea, necessrio ir diretamente ao VSS, checar
o documento para si e alter-lo, depois disso basta tirar a checagem. Todas as
informaes de usurio, data da alterao, o que foi alterado, verses anteriores e tudo
mais sero gravadas.
importante falar que, dentro do Windows, no importa a verso do SO, o
documento estar marcados em suas propriedades como somente leitura; ou seja; ao
abrir o mesmo localmente sem a checagem devida no VSS, no conseguir alterar,
apagar ou inserir dados e sim somente lido.

Database

Logo aps instalar o VSS, necessrio criar um database onde ficar todos os
arquivos de dados. Direi um pouco na parte de servidor e mquina pessoal.

Note: Ao instalar o sistema operacional Windows, recomendo que reparta o seu HD em
dois (2). Um para instalar o sistema operacional, softwares e o outro para colocar seus
arquivos. uma regra bsica, caso d algum problema junto ao Windows, o mesmo
pode ser formatado sem problemas mantendo assim os seus dados tranquilamente em
outra partio.

Servidor:
Partindo do pressuposto que voc tenha duas parties, crie uma pasta na
segunda partio onde ser colocada a database criada. A primeira coisa ao abrir o VSS
ir pedir para criar ou indicar um database. No existem problemas de verses de
software; foi mantido a compatibilidade entre as verses 2005 e 6.0.

PC:
No muito diferente utilizar o VSS localmente, ou seja, no seu computador
pessoal. Isso porque, colocando na segunda partio, o seu database os arquivos e pastas
estaro sempre seguros, mesmo que o sistema operacional for retirado.

Lembre-se: nunca faa backup das pastas e dos arquivos do database; utilize
sempre a parte administrativa para fazer backup. Nunca deixe de fazer backup!!! Se
possvel diariamente caso muitos artefatos forem alterados; assim sero mantidas todas
as verses. Qualquer database pode ser adicionado ou indicado, contendo que tenha o
arquivo .ini, ou seja, posso adicionar mesmo que esteja na internet, basta colocar o
local.


Visual SourceSafe - Parte 2
Criando banco de dados (create database)

Ol pessoal, meu nome Mauricio Junior e estou disposto a ajudar voc falando
sobre o Visual Source Safe 2005, como utilizar o mesmo de maneira correta e eficaz.
Nesta parte 2, criaremos um banco de dados. Lembrando que primeiro instalamos em
seu computador ou servidor o software. Peo-te que acompanhe desde a srie 1; segue
o link abaixo: http://www.aspneti.com/Visual+Source+Safe+Serie+1+450,0.aspx


Requisitos:
- Ter instalado o Visual Source Safe 2005


Depois da instalao, o software cria no menu com dois atalhos, um chamado
Microsoft Visual SourceSafe Administration e o outro Microsoft Visual
SourceSafe. Referncia 1.1

Referncia: 1.1

Escolhi o atalho Microsoft Visual SourceSafe Administration para trabalhar
primeiramente, ou seja, dentro dessa administrao criaremos o database para incio de
tudo. Ao escolher a opo, automaticamente abriu uma tela, referncia 1.2.

Referncia: 1.2

Note que existem dois usurios cadastrados junto ao sistema administrativo do
VSS, porm no falarei disso no momento. A primeira coisa clicar no menu File e
em seguida New database. (Referncia 1.3)

Referncia: 1.3

Explicao:
Esse novo database a criao de um arquivo .ini, ou seja, o mesmo
possuir referncia para o repositrio padro onde vrios usurios e vrios cdigos sero
colocados para manter verses. Cliquei no menu new database e automaticamente
apareceu uma tela de bem vindo ao sourcesafe. Siga os passos: (Referncia 1.4)

Referncia: 1.4

Cliquei no boto Avanar, logo apareceu outra tela pedindo para indicar o
local onde ser gravado o arquivo .ini. (Referncia 1.5)

Referncia: 1.5

Particularmente, sempre prezei por segurana de dados. No importa se
arquivo local ou pela internet, hoje em dia dados so mais importantes que at dinheiro.
Esse um assunto para ser discutido em outro momento, porm peo que crie uma
partio em seu computador / servidor e armazene este novo banco de dados em outra
partio que no esteja instalado o windows. Isso porque, caso d problema no sistema
operacional, o mesmo pode ser formatado sem perda de dados ou database do VSS.

Cliquei no boto chamado Browse.. e escolhi um diretrio seguro e fora da
mesma partio onde est instalado o sistema operacional. (Referncia 1.6)

Referncia: 1.6

Escolhendo o diretrio corretamente, dei OK e Avancei. Na tela seguinte, o
mesmo pede um nome fictcio. Esse nome serve para que se algum outro usurio quiser
acessar essa base de dados, ou adiciona-la em seu cliente VSS, automaticamente a
mesma aparecer o nome que voc est dando no momento. (Referncia 1.7)

Referncia: 1.7

Deixei o nome VSS, cliquei Avanar e em seguida Concluir. Note que
automaticamente foi criar alguns diretrios e o arquivo .ini do diretrio escolhido.
Caso voc tem uma equipe de desenvolvimento, basta passar o endereo do arquivo .ini
ou compartilhar o diretrio do arquivo para que possa ser vinculado todos os cdigos
fontes e arquivos no mesmo servidor; isto , centralizar servidor mantendo um melhor
controle.


Visual SourceSafe - Parte 3

Ol pessoal, meu nome Mauricio Junior. Darei continuao nos artigos sobre
este programa que serve para controlar documentos e cdigos, o famoso VSS (Visual
SourceSafe). Veja nossa agenda abaixo.


Agenda:
- Entendendo como adicionar arquivos;
- Adicionando documentos do Word e cdigo fonte;


Antes de comear, gostaria de compartilhar uma experincia que tive essa
semana com meu grande notebook toshiba e o meu sistema Windows Vista, envolve o
VSS. Como precavido, possuo sempre meu HD particionado em dois; com isso posso
formatar a primeira partio sem perder os meus dados. O problema foi que, ao comprar
o notebook, veio apenas CDs de recover, ou seja, restaurar o sistema operacional
padro. Resolvi arriscar depois de que meu Vista no estava mais funcionando.
Resultado, o recover apagou todos os meus dados e partio automaticamente.
Tive sorte por ter um HD separado que serve exclusivamente para Backup.
Tinha tudo nele inclusive tinha feito backup da maneira correta do VSS nele, ou seja,
tinha os arquivos .ssa criados pela tela de administrador do VSS.
Depois que instalei tudo, fui voltar o backup dos dados, cdigos e livros que
escrevi em meu notebook lindo. O backup foi restaurado com sucesso de todas as
pastas, cdigos e sites que tinha feito. Sucesso absoluto com meus dados restaurados,
isso tudo porque coloquei no VSS.


Praticando
Depois da grande experincia que tive, fora o medo de no recuperar os dados,
comearemos a praticar como colocar os arquivos no VSS. No artigo passado, criamos a
database, cujo necessrio como primeira tarefa.
A maneira de adicionar um arquivo junto ao VSS muito simples, fcil e rpido.
Existem duas maneiras, uma arrastando e colocando e outro criando um projeto e
adicionando pela prpria ferramenta; as duas coisas so iguais para incio de conversa,
ou seja, fazem o mesmo efeito.
Depois de abrir o programa, criei a um novo projeto separando assim os meus
dados da forma mais organizada possvel. (Referncia 3.1)

Referncia: 3.1

Cliquei com o mouse em cima do menu File, escolhi a opo Create Project.
Abriu automaticamente uma tela cujo possui dois campos, um para o nome da
pasta e outro para comentrios, caso seja necessrio. (Referncia 3.2)


Referncia: 3.2

Digitei a palavra Arquivos, no coloquei comentrio algum e clique no boto
OK. (Referncia 3.3)

Referncia: 3.3
Depois de criar uma pasta junto ao meu VSS, basta adicionar um arquivo ou
cdigo de sistema. Como anteriormente eu falei, existem duas maneiras, a primeira
arrastando colocando. (Referncia 3.4)


Referncia: 3.4

Ao arrastar do meu desktop e posicionar o mouse na pasta arquivos, note que a
mesma ficou pretinha, ou seja, selecionada, basta soltar o arquivo. Antes de ser
adicionado o arquivo, o mesmo aparece uma caixa de dilogo para que possa colocar
alguns comentrios sobre aquele arquivo adicionado. (Referncia 3.5)


Referncia: 3.5

Voc pode comentar ou no sobre o mesmo, caso no for comentar nada, basta
clicar no boto OK. Resultado (Referncia 3.6)

Referncia: 3.6
Note que ao lado direito da referncia 3.6 foi adicionado um arquivo
normalmente. Utilize sempre o lado esquerdo para as pastas e o direito para os arquivos.
Nunca os arquivos aparecero do lado esquerdo.
A segunda forma de adicionar arquivos, isto , qualquer tipo de arquivo,
utilizando o menu Filee depois Add Files... (Referncia 3.7)


Referncia: 3.7
Depois de adicionar o arquivo, note nas propriedades do mesmo que marcada
automaticamente a opo READONLY, ou seja, s leitura.
Visual SourceSafe - Parte 4

Como citei anteriormente em outros artigos sobre o mesmo assunto, qualquer tipo de arquivo pode ser
versionado e assim manter verses do mesmo em seu repositrio.

Requisitos:

- Visual Studio.NET 2005 instalado
- Visual SourceSafe qualquer verso instalada
- Framework 2.0
- Ler os artigos anteriores (veja a lista em artigos do autor ao final deste artigo)

Mo na massa

O primeiro passo criar ou j pegar um projeto pronto do seu Visual Studio.NET e abri-lo. No exemplo,
mostrarei um projeto do tipo Windows Forms; lembro que pode ser feito com qualquer tipo de plataforma.


VSS 4 - 1

Depois de ter o projeto para armazenamento e o banco de dados do VSS criado, como em verses
anteriores, basta apenas acessar o menu especfico. Por padro, dentro do Visual Studio.NET no vem
configurado para adicionar o projeto no VSS, isso porque voc pode escolher qual tipo de versionador
usar em seu computador.

Siga os passos: MENU TOOLS / OPTIONS. (VSS 4-2)


VSS 4 -2

Automaticamente apareceu outra tela sem as opes necessrias para SourceSafe. Porm necessrio
marcar para mostrar todas as configuraes. (VSS 4 -3)


VSS 4- 3

Verifique a seta marcada de vermelho na figura (VSS 4-3), ao marcar a mesma aparecer todas as
opes necessrias para configurar a vinculao dentre o Visual Studio.NET e VSS. (VSS 4 - 4)


VSS 4 - 4

Depois de todas as opes mostradas em tela, basta escolher o submenu Source Control, (controle de
cdigo fonte). Note que ao lado direito da tela possui uma combo mostrando os plugins aptos e instalados
para o Visual Studio.NET. Ao clicar na combo, voc pode vincular o programa ao versionador. (VSS 4 - 5)


VSS 4-5

Escolha a determinada e instalada em sua mquina e clique no boto OK. Automaticamente dentro do
Visual Studio.NET aparece no menu File ou clicando com o boto direito em cima do projeto a opo de
adicionar o projeto no VSS. (VSS 4 - 6).


VSS 4 - 6

Clique em ADD PROJECT TO SOURCE CONTROL e automaticamente aparece a tela para logar no VSS
associado. (VSS 4 -7)


VSS 4 - 7

Coloque o usurio, escolha a opo Database o banco de dados do VSS e clique no boto OK. Lembre-
se que no precisa colocar no campo password a senha atribuda ou criada desde o primeiro artigo. O
mesmo j loga automaticamente no software. Em seguida, aparece o diretrio como nome do projeto
especfico, apenas clique OK, e automaticamente foi adicionado todos os artigos no database.


VSS 4 - 8

Prontinho, o seu cdigo j est protegido de uma melhor forma mantendo as verses. Caso altere algum
cdigo ou arquivo, basta ver o histrico ou restaurar. Em breve veremos mais sobre os controles da
ferramenta. Fico por aqui e qualquer dvida, favor entrar em contato.

Visual SourceSafe - Srie 5


Ol pessoal, meu nome Mauricio Junior e tenho o objetivo de continuar utilizando o
grande versionador de dados. Coloco passo a passo pra voc aprender a mexer, pois alm de
guardar vrias verses de documentos, de fcil compreenso.

Segue os links de todos os passos abaixo.
Srie 1: http://www.aspneti.com/Visual+Source+Safe+Serie+1+450,0.aspx
Srie 2: http://www.aspneti.com/Visual+Source+Safe+Serie+2+457,0.aspx
Srie 3: http://www.aspneti.com/Visual+SourceSafe+Serie+3+466,0.aspx
Srie 4: http://www.aspneti.com/Visual+SourceSafe+Serie+4+492,0.aspx
Vdeos: http://www.aspneti.com/Visual+SourceSafe+462,0.aspx

Lembro que esse um versionador de documentos e no apenas de cdigo, falo isso
porque as pessoas s utilizam o mesmo para versionar cdigo ou projeto. Um documento
Word, Excel, PPT ou mesmo um arquivo txt pode ser versionado em sua empresa da forma
mais simples e com controle.

No meu caso, criei um projeto dentro do VSS chamado Documentos e dentro de
documentos um outro projeto chamado Word. Quando falo de projeto dentro do VSS o
mesmo tem um conceito de pastas, so como fossem pastas separadas.

Referncia: VSS 5-1

Tenho uma pasta onde est o meu arquivo .doc. (Referncia VSS 5-2)


Referncia: VSS 5-2
A nica coisa a fazer mandar o arquivo .doc; arrastando e colocando; para dentro do
programa. Depois disso o mesmo no deixa ser editado normalmente como antes. Ento agora
passe o documento para dentro do VSS.
Depois de colocar o mesmo no VSS, se voc for nas propriedades do
arquivo, estar marcado como readonly; ou seja, no deixa ser editado. Na
mesma pasta onde est o arquivo, foi criado um outro arquivo com extenso
.scc. Esse arquivo para controle do sistema.


Referncia: VSS 5-3
Para editar o arquivo mantendo verses dentro do VSS, clique com o
boto direito em cima da ferramenta e escolha a opo Check Out. Peo que
siga os passos desde o comeo desta srie. Caso tenha sido adicionado de
outra forma, faa uma outra configurao, ou seja, baixar primeiro em sua
mquina e depois editar. Depois de clicar Check Out, veja como ficar no
programa. (Referncia VSS 5-4)


Referncia: VSS 5-4

O interessante junto ferramenta, que s um usurio pode editar o
arquivo de cada vez. Mas se voc quiser colocar dois ou mais usurios a edio
de um mesmo arquivo ao mesmo tempo, pode ser feito sem problema algum.
Em outras sries posso ensinar um passo a passo. Lembro que toda informao
sobre quem editou, qual hora, qual a diferena entre as verses, quem est com
o arquivo e tudo mais fica registrado na ferramenta de forma dinmica.
Depois de dar um Check Out, acrescentei dados ou tirei dados do documento. Em
seguida fui para a ferramenta, cliquei com o boto direito e escolhi a opo Check In.
(Referncia VSS 5-5)


Referncia: VSS 5-5

Automaticamente foi liberado o documento para ser editado ou Check Out ado por
outra pessoa. Para buscar outras verses do documento ou saber informaes sobre o mesmo,
usurio, o que foi alterado e tudo mais, cliquei com o boto direito em cima do documento e
fui em Show History. Apareceu uma tela logo depois que cliquei. (Referncia VSS 5-6).


Referncia: VSS 5-6
No precisa colocar qualquer tipo de informao, basta clicar Ok e foi isso que fiz. Logo
apareceu a tela com todas as informaes. (Referncia VSS 5-7)


Referncia: VSS 5-7

Note o tanto de verso que tem o documento. Os botes na lateral direita, sero
explicados nas prximas sries. Espero ter ajudado em alguma coisa.