ABAP101

Então você decidiu trabalhar com os Projetos Open Source almejando adquirir conhecimento e ganhar reconhecimento na comunidade open source SAP. Pois bem, a primeira parte você consegue instalando o MiniSAP e aprendendo a usar o SAPLink. Já a segunda parte, você precisará ser fluente no repositório de projetos open source da SAP, o Code Exchange.

Compilamos abaixo algumas instruções para você começar  a usar o Code Exchange like a boss.

Criando Uma Conta no Code Exchange

Para começar a participar dos projetos no Code Exchange você precisará de uma conta no SCN, SAP Community Network, antigamente conhecido como SAP Developer Network.

Além de ter acesso ao Code Exchange, você poderá ter acesso para postar e responder perguntas nos fóruns, baixar programas trial da SAP, e muitas outras coisas.

O cadastro é muito simples e gratuito. Lembrando que para participar dos Projetos Open Source do ABAP101 é obrigatório a criação de uma conta no SCN. Não consigo imaginar um bom programador ABAP que ainda não tenha uma conta lá. Se você ainda não se inscreveu (shame on you) pare tudo o que você está fazendo e vá fazer o seu registro.

Filiar-se a Um Projeto

Quando você se interessar por algum projeto e quiser acompanhar sua evolução, você deve afiliar-se a este projeto. Você faz isso simplesmente clicando no link Join this Project que geralmente fica na barra lateral direita.

As vantagens de se filiar a um projeto é poder postar issues, postar e responder dúvidas no fórum, acompanhar as atualizações dos desenvolvedores e o melhor, poder ajudar no desenvolvimento do mesmo.

Todos os projetos do ABAP101 estão no Code Exchange pois consideramos ser o repositório mais indicado para os projetos SAP/ABAP.

Repositório SVN

O Code Exchange usa o SVN como controlador de versão e por esse motivo você deve instalar algum cliente, como por exemplo o Subversion ou TortoiseSVN . Eu uso os dois, o primeiro para integrar como SAP Local (MiniSAP) e o SVN do Code Exchange e o segundo para incluir e alterar arquivos não-SAP, como por exemplo documentação, ABAPDoc, modelos UML etc.

A instalação do Subversion e TortoiseSVN segue o modelo Next-Next-Finish, não há nenhum segredo.

Para mais informações sobre SVN e Code Exchange, acesse esse link.

Checkout, Checkin e Update

Se você ainda não sabe como trabalhar em um controlador de versão, segue algumas operações que você precisará aprender a fazer:

• Checkout, quando você começa a trabalhar em algum arquivo você deve fazer o checkout. Essa é a maneira de dizer para as outras pessoas do projeto que você está trabalhando nesse arquivo. Essa ação é muito importante para evitar conflito de duas pessoas trabalhando em um mesmo arquivo.
• Checkin é usado quando você terminar de trabalhar em algum arquivo e você deseja subir a nova versão para o repositório central e assim ficar disponível para as outras pessoas.
• Update é usado para atualizar seus arquivos locais com a última versão do repositório central. Cuidado, pois os documentos alterados e que não foram feitos checkout serão sobrescritos.

ZAKE

Se eu considero o SAPLink como o projeto mais importante para comunidade open source SAP, o ZAKE é com certeza o segundo projeto mais importante. O ZAKE é o responsável por facilitar a integração entre o SVN e o MiniSAP. As operações de checkout/checkin/update podem ser feitos diretamente com MiniSAP, evitando a necessidade de baixar os objetos para seu micro usando o SAPLink e aí usar o TortoiseSVN para fazer a atualização no repositório SVN.

O ZAKE é na verdade uma API para o Subversion, ou seja, você não terá um programa chamado ZAKE para baixar e usar. Para usar o ZAKE você precisa fazer um programa ABAP para usar a API. Isso motivou o aparecimento do SVNProject e o COEXLink, sendo esse último mais um projeto do ABAP101.

Com o COEXLink temos um simples gerenciador de projetos dentro do MiniSAP. Mas antes de usar o COEXLink, você precisa instalar o ZAKE.

Instalando e Configurando o ZAKE

Antes de instalar o ZAKE você precisa instalar o SAPLink, sem o qual o ZAKE nem ativa, para instalar o SAPLink, veja as instruções aqui.

Você pode baixar o arquivo Nugget daqui (se você não sabe o que é um arquivo Nugget, volte duas casas…).

A instalação do ZAKE é bem tranquila, bastando apenas importar o NUGG file para o seu MiniSAP. Ao ativar, ative primeiro os objetos de dicionário e depois as classes e programas.

Após a instalação, você precisa definir um External Command na transação SM69 no seu MiniSAP. Na transação SM69 clique no ícone Create a insira as informações conforme tela abaixo:

Agora você precisa criar uma diretório chamado C:\Projects e copiar os arquivos de script que vieram no ZIP de instalação do ZAKE. Os nomes dos arquivos são:

• svn-script.cmd
• svn-script.sh
• tortoise-svn-script.cmd

Sem esses arquivos, o ZAKE não funcionará.

Com isso temos o ZAKE instalado e configurado.

Instalando e Usando o COEXLink

Com o SAPLink e o ZAKE instalado, você deve instalar o COEXLink para auxiliar no uso do ZAKE. Você pode criar seu próprio gerenciador e aí não será necessário usar o COEXLink.

Você pode baixar o arquivo nugget desse link aqui. Importe para o seu MiniSAP e ative, começando pelos objetos de dicionário e depois classes e programas.

Gerenciando Projetos no COEXLink

No COEXLink é necessário criar um projeto, definindo um nome (geralmente o mesmo do Code Exchange) e a URL do repositório SVN do projeto. Para criar um projeto, rode o programa ZP_COEX_PROJECT_INTEGRATION e a seguinte tela de seleção será apresentada:

Entre com o CoEx Project Name, Code Exchange project SVN, Username e Password, escolha o radio button Create Project e rode o programa. Uma entrada na tabela ZCOEX_PROJ deve ser criada.

A URL do SVN está na página do projeto dentro do Code Exchange, na aba Sources:

O Username e Password são os do repositório do SVN, não é o do SDN ou MiniSAP. Para definir essas duas informações no Code Exchange acesse o link https://code.sdn.sap.com/ e você irá para a página ”Code Exchange Expert View Home” do seu usuário. Agora click no link “Edit profile” no topo da página do lado esquerdo. Agora defina um nome de usuário e senha:

Para fazer o checkout ou checking é só entrar com o CoEx Project Name, escolher Checkout SVN Repo ou Checkin SVN Repo e rodar o programa. Se tudo estiver correto, os arquivos devem ser baixados no diretório C:\Projects. Depois de um tempo, seu diretório de trabalho de projetos open source ficará com o seguinte aspecto:

Curiosidade: Você já deve ter entendido que CoEx é abreviação de Code Exchange