Controlando código fonte PowerBuilder.NET 12.5 utilizando Microsoft Team Foundation Server (TFS)

Versão

Autor: Reed Shilts, grupo de desenvolvimento da IDE PowerBuilder .NET, Sybase Inc.

Data: 14/01/2011

Nota: Documento não oficial, apresentado apenas como apoio aos usuários.

Glossário

TFS - Team Foundation Server

SCC - Source Code Control (Controle de código fonte)

MSSCCI - Microsoft Source Code Control Interface (Interface para controle de código fonte)

Resumo

O Team Foundation Server (TFS), da Microsoft, é o sucessor do Microsoft Visual Source Safe, e pode ser utilizado com o PowerBuilder.NET. O PowerBuilder.NET, assim como o Visual Studio, requer uma interface MSSCCI para fornecer a conexão com o Team Foundation Server. Imagine esta interface MSSCCI como se fosse um provedor ODBC, uma API padrão para programas clientes como PowerBuilder.NET, Eclipse, e versões mais antigas do Visual Studio. Este documento irá descrever como instalar e utilizar o TFS para controlar código fonte do PowerBuilder .NET 12.5.

Em suma, para utilizar o TFS com o PowerBuilder .NET você precisará:

a) Baixar e instalar a interface MSSCCI

b) Selecionar o SCC provider no PowerBuilder .NET

c) Conectar ao seu servidor SCC

Servidor TFS

Neste exemplo, foi instalado o TFS-2010 em um servidor Windows 2008, chamado "VPC2008-32A". Este servidor possui alguns usuários sem domínio associados: PBAdmin, PBStandardUser1, PBStandardUser2, etc. A conexão com o servidor foi testada usando o "Team Explorer" no Visual Studio 2010.

Algumas observações importantes sobre o TFS:

a) As contas de usuários requerem senhas. As senhas em branco são aceitas, porém sempre resultam em erro.

b) Você pode alterar o "local path" do workspace SCC da seguinte forma: File → Source Control → Workspace → Edit The "Local Folder".

Seguindo a filosofia dos provedores SCC, essencialmente todos os diálogos relacionados ao controle de código fonte são gerados pelo próprio provedor SCC; independentemente se estamos falando de TFS, Perforce ou algum outro provedor. Este é um dos aspectos positivos da abordagem de provedores, pois eles podem fornecer diálogos adicionais, específicos de acordo com a funcionalidade. Se uma ferramenta (como o PowerBuilder) fosse obrigada a fornecer os diálogos, ela teria que seguir a o menor denominador comum, ou seja, seguir o básico que funcionasse em qualquer provedor, mas convenhamos, nenhuma ferramenta pode ficar presa a isso.

O Team Foundation Server Provider

Uma interface MSSCCI está disponível no site da Microsoft, no seguinte endereço:
http://visualstudiogallery.msdn.microsoft.com/en-us/bce06506-be38-47a1-9f29-d3937d3d88d6

Baixe e instale o arquivo MSI.

No PowerBuilder.NET você verá que agora o TFS estará disponível como uma opção SCC, conforme abaixo:

Adicionando sua solution ao Source Control

Para começar, adicione sua solution ao TFS SCC.

a) Abra o PowerBuilder .NET e em seguida abra o workspace.

b) Clique em: File → Source Control → Add Solution to Source Control

c) Selecione o servidor

d) Faça login com seu usuário e senha

e) Especifique o local do servidor onde será armazenado o workspace

 

f) Faça o check-in inicial dos arquivos do workspace. A maneira mais fácil é clicar no botão "Check In", na TAB "Pending Checkins" da IDE. Então será aberta a janela de diálogo "Check In" onde você deverá adicionar um comentário. Em seguida, pressione o botão "Check In" da janela de diálogo.

 

Observe que alguns arquivos dinâmicos e específicos de usuários não são adicionados ao SCC:

1) o arquivo oculto "user options", com extensão "pbshell_suo"

2) arquivos de build incremental com extensões "llat_dat" e "tlat_dat" (para library e target). Estes arquivos nunca devem ser adicionados ao SCC. Eles são constantemente atualizados com informações correntes sobre a sessão de edição atual, não podendo ser bloqueados para gravação.

g) Pronto. O workspace agora já está controlado pelo Team Foundation Server.

Como editar um arquivo

No PowerBuilder.NET, abra um arquivo no editor. Se a opção do SCC de fazer check out automaticamente estiver setada, o arquivo já estará automaticamente em check out ao ser aberto (desejo antigo dos desenvolvedores PowerBuilder). No exemplo abaixo, estão abertos 2 arquivos: o objeto application (SmallTest01) e uma janela (w_window). Na TAB "Pending Checkins" da IDE, note que o objeto “PowerBuilder window” é composto por um par de arquivos, um com extensão "srw" e outro com extensão "xaml". Esta é a semântica do PowerBuilder para lidar com janelas.

Fazendo Check In no arquivo

Quando terminar de editar os arquivos, faça o check in. Como já foi feito anteriormente, pressione "Check In" na TAB "Pending Checkins".

Como obter o código fonte do SCC para um disco local

Vamos agora abordar uma situação comum: quando o código fonte está no servidor SCC, mas não existe no disco local. Vamos utilizar o PowerBuilder .NET para mostrar o que deve ser feito para obter o código.

Abra o PowerBuilder .NET e feche a solution que estiver aberta. Em seguida, clique em File → Source Control → Open From Source Control...

Repita os passos já mostrados anteriormente neste documento.

a) selecione o servidor

b) efetue log in com seu usuário e senha

Porém agora você irá escolher uma solution já existente (No nosso exemplo, SmallTest01).

 

Pronto. É comum o arquivo PBWX ser baixado, então a janela "Open Solution" será exibida. Caso isso aconteça, selecione o arquivo PBWX da solution e prossiga com a ação de abrir.

Opções de Menu quando o workspace está integrado com o SCC

Existem novas opções de menu específicas para o SCC. Algumas são fornecidas pelo provider específico, como 'Perforce' ou neste caso, o plugin do Team Foundation Server. Note que elas são bem auto-explicativas.

Fonte: http://blogs.sybase.com/powerbuilder/

Adaptado por: Blog PowerBuilder Brasil