Exibir origem

CONTEÚDO

01. VISÃO GERAL

Esta documentação tem por objetivo passar instruções para que você possa configurar o seu ambiente e desenvolver programas utilizando o Progress Developer Studio (PDS).

Ele possui muitos recursos interessantes como:

- Numeração de linha;
- Code Complete;
- Integração com Appserver/PASOE;
- Gerador e visualizador do Profiler;
- Gerador e visualizador de Logs;
- Integração com o GUI do Progress, permitindo que você possa compilar e executar os seus programas;
- Depuração de programas através do Debug;
- Conexão a bancos de dados;
- Ajuste de PROPATH;
- Abertura rápida de programas;
- Ajuste de código fonte com indentação automática;
- etc.

02. CRIANDO A SUA WORKSPACE NO PDS

Para criar a sua workspace no eclipse, você deverá seguir os seguintes passos:

Executar o atalho do Developer Studio dentro do menu do Progress/OpenEdge;
Após executar o atalho, se for a primeira vez que você está executando o PDS, será apresentado uma janela solicitando que seja informado o diretório da workspace:

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_19-33-36.png

Neste ponto, você deve fornecer o diretório onde será criado a sua workspace;

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_19-35-9.png

Clique em Workbench para ir para a área de trabalho do PDS;

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_19-35-50.png

Dentro da Workbench do PDS, temos as seguintes divisões:

	Área	Descrição
1	Project Explorer	Local onde serão apresentados todos os seus projetos, bem como os nomes dos programas para você poder editar
2	Outline	Local onde você terá a lista de todos os objetos utilizados no seu programa, bem como: variáveis, buffers, temp-tables, procedures internas, includes, etc.
3	Área de código fonte	Local onde você poderá editar os códigos dos seus programas
4	Console, Problems, etc.	Local onde você poderá ver mensagens de execução, erros de compilação, etc.

03. UTILIZANDO O CRIADOR DE PROJETOS NO PDS

Para criar o seu projeto, você deverá executar o programa PDSConfigGenerator.p para preparar as configurações do seu projeto para poder trabalhar dentro do PDS.

Para executar o programa PDSConfigGenerator, tenha certeza de que o seu Eclipse PDS está fechado.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-16-32.png

O PDSConfigGenerator solicitará as seguintes informações:

Campo	Descrição
Arquivo .pf	Nome do arquivo .pf de onde o programa vai importar todas as conexões dos bancos de dados utilizados. Dica: Utilize um .pf que conecta somente o banco do EMSFND, pois os demais bancos serão conectados após da api de login (btapi910za.p)
Arquivo .ini	Nome do arquivo .ini de onde o programa vai importar o PROPATH necessário para você compilar e executar os seus programas. Dica: Os .ini dos atalhos de compilação são interessantes para você fazer a sua compilação, durante a execução ou debug você poderá informar um PROPATH diferente para a execução
Versão Produto	Normalmente a versão de desenvolvimento é a 11.5.X, mas pode ser especificado outras versões (é documentacional)
Versão Progress	Essa informação será apresentada após você mandar processar, onde será do seu progress especificado no seu .ini
Diretório Progress	Essa informação será apresentada após você mandar processar, onde será do seu progress especificado no seu .ini
Nome Projeto	Nome do projeto que será utilizado. Dica: Procure não deixar espaços em branco no nome do projeto. Utilize para o nome o número do ticket ou alguma outra informação relevante para você
Diretório Projeto	Informe o diretório onde estão os programas que serão editados do seu projeto. Dica: Pode ser utilizado um diretório que contenha ou não programas.
Diretório Workspace	Informe o diretório onde foi criado a sua Workspace

Quando você clicar em Processa, será solicitado que você feche o Eclipse PDS, pis ele terá que alterar alguns arquivos de configurações dentro da sua Workspace.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-21-27.png

Após a execução do programa, o que é muito rápido, será apresentado a seguinte mensagem com instruções para você importar o seu projeto:

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-24-34.png

04. IMPORTANDO O SEU PROJETO NO PDS

Para importar o seu projeto, você deverá seguir os seguintes passos:

Abra o seu Eclipse PDS
Na versão 11.7 do Progress, na área do Project Explorer, clique com o botão direito do mouse e clique em Import e depois em Import...

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-42-31.png

Na versão 12.2 do Progress, na área do Project Explorer, clique em Import projects...

Será apresentado a janela abaixo, onde você deverá selecionar General e Existing Projects into Workspace, depois clique no botão Next

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-45-45.png

Informe o diretório onde está o projeto que será utilizado (1), depois clique no TAB para selecionar o projeto encontrado (2) e por último, clique no botão Finish (3).

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-51-35.png

Após todos esses passos, o seu projeto já vai estar aparecendo no Eclipse do PDS.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_20-53-33.png

IMPORTANTE: Após você importar o seu projeto no Eclipse PDS, você terá que reiniciar o Eclipse, para que ele consiga fazer algumas configurações internas.

Uma vez reiniciado o Eclipse, após a importação do seu projeto criado pelo PDSConfigGenerator, você verá que o banco de dados EMSFND foi conectado automaticamente, onde a partir desse momento você conseguirá executar e debugar os seus programas

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_8-43-2.png

05. ENTENDENDO O SEU PROJETO IMPORTADO NO PDS

Dentro do seu projeto recém importado, temos os seguintes arquivos:

Arquivo

Descrição

Debug.p

Este programa serve para execução ou debug de qualquer programa dentro do produto Datasul

EnableDebug.bat

Este arquivo serve para habilitar o debug do progress na sua máquina e deverá ser executado no MS-DOS como Administrador.

Não se esqueça de executá-lo para poder habilitar o DEBUG Progress.
Observação: Uma vez habilitado o Debug para sua máquina, não será mais necessário executar este .bat.

O programa Debug.p possui o seguinte código, onde explicaremos detalhadamente:

/*----------------------------------------------------------------------
  File        : debug.p
  Purpose     : Programa utilizado para login do produto e testes/debug
  Created     : 14/10/22
----------------------------------------------------------------------*/

BLOCK-LEVEL ON ERROR UNDO, THROW.

{utp/utapi009.i}

SESSION:DEBUG-ALERT = TRUE.

// ajuste o propath de acordo com a sua necessidade de testes/debug
// e nao se esqueca de adicionar no propath os programas fontes para debug, caso necessario.
PROPATH = "C:\totvs\workspace\Ticket-0001,c:\datasul\scripts,c:\fndlm,"
        + "C:\Datasul\Programas\fnd,C:\Datasul\Programas\ems2,C:\Datasul\Programas\ems5,"
        + "C:\Datasul\Programas\hcm,C:\Datasul\Programas\eai,C:\Datasul\Programas\eai2,"
        + "C:\Datasul\Programas\gp,C:\Datasul\Programas\crm,C:\Datasul\Programas\crm\database,"
        + "C:\Datasul\Programas\crm\integracoes,C:\Datasul\Programas\fnd\businesshub,C:\fwkNovo\FWK\totvs-fwk-progress\src\main\progress,"
        + "C:\TFS\Fnd\V11\progress\src,C:\TFS\DDK\V11\progress\src,\\caetano\progress_repository\foundation\11.5.X-SNAPSHOT\src,"
        + "\\caetano\progress_repository\ems5\11.5.X-SNAPSHOT\src,\\caetano\progress_repository\ems2\11.5.X-SNAPSHOT\src,"
        + "\\caetano\progress_repository\foundation\11.5.X-NFRW-SNAPSHOT\src,\\caetano\progress_repository\crm\11.5.X-SNAPSHOT\src,".

// faz o login no produto e tambem conecta todos os demais bancos da empresa
//                    USUARIO,    SENHA,    TEMP-TABLE DE ERROS
// voce pode utilizar a api para um login automatico
RUN btb/btapi910za.p ("super", "super@123", OUTPUT table tt-erros).

// ou voce pode utilizar o login padrao do produto, descomentando a linha abaixo
// RUN btb/btb910za.p.

// Aqui voce coloca o RUN do programa a ser executado e debugado
// Adicione o breakpoint desejado
RUN prog.p.

/* fim */

Dentro do programa Debug.p, temos as seguintes partes:

Bloco

Descrição

PROPATH

O Propath que pode ser ajustado de acordo com a sua necessidade para a execução

Login Automático (btapi910za)

Utilizando usuário e senha do Datasul.

Dica: Pode ser utilizado também o login normal através da btb910za, onde será aberto uma janela para você informar o usuário e senha

Prog.p

Local onde você deverá colocar o nome do programa que você deseja executar ou debugar.

Dica: Para debugar, não se esqueça de adicionar os breakpoints primeiro.

06. AJUSTES NECESSÁRIOS PARA O FUNCIONAMENTO DO SEU PROJETO NO PDS

Mostrar os números das linhas do código fonte
- No menu Window → Preferences é aberto a janela de configurações do Eclipse

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_8-26-29.png

- Na janela de configuração do Eclipse (Preferences), você acessará General → Editors → Text Editors → ligue a opção Show Line Numbers e depois em Apply and Close

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-14_21-21-24.png

07. ALGUNS RECURSOS E FUNCIONALIDADES DO PDS

Execução de Programas
- Para a execução de programas, temos que clicar com o botão direito do mouse sobre o nome do programa, Run As → Progress OpenEdge Application

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_21-5-46.png

- - Para demais execuções, basta clicar na seta para baixo ao lado do botão verde , onde aparecerá um atalho com o mesmo nome do seu programa, neste exemplo Debug

Depuração de programas com o Debug
- Para depurarmos um programa, temos que abri-lo no editor e depois adicionar o breakpoint, de acordo com a necessidade. Dica: Para adicionar um breakpoint, verifique os passos no item 08 - Questionamentos.
- Uma vez adicionado os breakpoints, clique com o botão direito sobre o programa e clique em Debug As → Progress OpenEdge Application

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_21-34-34.png

- Uma vez em modulo de depuração, vai aparecer a seguinte tela, onde temos:

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_21-45-13.png

Abaixo vamos descrever cada janela que está sendo apresentada:

Janela	Descrição
1	Pilha de execução do programa, com a lista de todos os programas que estão sendo executados no momento (StackTrace).
2	Código fonte do programa, bem como os demais programas que serão abertos durante a depuração, mostrando linha-a-linha do que está sendo executado.
3	Na aba Variables, podemos ver todas as variáveis do programa, bem como Temp-tables, buffers, etc. Temos a aba Breakpoints, onde podemos ver a lista de todos os breakpoints definidos.
4	Console do que está sendo executado.

Na barra de botões, temos os seguintes botões que permitem navegar na depuração

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_21-55-42.png

Funções dos botões de depuração:

Botão	Atalho	Descrição
	F8	Resume, que permite continuar uma execução
		Suspend, que permite fazer uma pausa na execução e continuar a execução passo-a-passo
	Ctrl-F2	Terminate, que permite terminar a depuração e continuar a execução do programa normalmente sem depuração
	F5	Step Into, que permite entrar na depuração dentro de um programa filho, função ou procedure interna.
	F6	Step Over, que permite pular a depuração sobre um determinado programa filho ou procedure interna. OBS: Esse programa filho ou procedure interna não será depurado.
	F7	Step Return, que permite sair do programa filho ou procedure interna, voltando para o ponto em que este programa ou procedure foi chamado.

Para demais depurações desse programa, basta clicar na seta para baixo ao lado do botão bug verde , onde aparecerá um atalho com o mesmo nome do seu programa, neste exemplo Debug

Gerando o Profiler
- Para gerarmos o profiler, temos que ir no atalho criado para execução ou depuração, clicando na seta para baixo e em Run Configurations... ou Debug Configurations..., respectivamente. Neste nosso exemplo vamos mostrar na execução de programas. OBS: Para depuração é muito similar o processo.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-15-59.png

- Na janela de Run Configurations, selecione o atalho que você possui para o seu projeto, clique sobre a aba Profiler

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-20-21.png

- Clique em Enable profiling, informe o diretório para output dos arquivos Profiler output folder, desligue a opção Use relative path e ligue as opções Generate debug listing files e Enable tracing. Após isso, clique no botão Run.
- Você executará normalmente o programa e quando terminar a execução, saindo do programa, será apresentado uma janela com informações do Profiler

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-30-16.png

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-30-54.png

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-31-28.png

Geração de Logs
- Para a geração de logs, similar à geração do Profiler, temos que ir na janela de Run Configurations, selecione o atalho que você possui para o seu projeto, clique sobre a aba Logging

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_22-36-28.png

- Clique em Enable logging, informe o logging level com Extended, o Log file e ligue os Log Entry Type desejados. Após isso, clique no botão Run.
- Você executará normalmente o programa e quando terminar a execução, saindo do programa, você terá gerado o log desejado.

Monitoramento de Logs (Tailing)
- Você pode ativar o visualizador de logs no momento que quiser, através de menu Window → Show View → Other...

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_20-43-39.png

- Dentro da janela do Show View, clique em Log Viewer → Log Viewer → Botão Open

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_20-44-34.png

- Vai aparecer na área onde está o Console, a view do Log Viewer, onde você deverá especificar qual o arquivo de log a ser monitorado, através do botão (1)

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_20-56-21.png

- Você também pode adicionar regras no log visualizado, tipo deixar em evidência quando aparecer uma determinada palavra dentro do log, facilitando assim a visualização e detecção de problemas. Para isso você tem que clicar no botão (2)

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-3-33.png

- Clicando no botão Add..., você poderá especificar a regra de destaque que deverá aparecer na visualização do log. Nessa regra você pode especificar alguma String que quando for encontrado dentro do log, será apresentado com destaque

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-5-28.png

- No exemplo de regra que colocamos foi procurar dentro do log o nome do programa btb/btb901zo.p, onde as suas ocorrências foram destacadas no log.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-9-4.png

Organização do Código Fonte
- Com o programa fonte aberto, clique com o botão direito do mouse sobre qualquer linha do programa, onde será aberto um menu de recursos que podem ser utilizados para melhorar a apresentação do seu código fonte. Dentro da opção Source, você encontrará várias opções de formatação do código fonte, bem como recursos para adicionar novas procedures internas e funções.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-16-17.png

Abertura rápida de programas e includes
- Existe também o recurso de abertura rápida de código fonte, onde você segurando na tecla CTRL e clique sobre o nome do include ou RUN de um determinado programa, com isso o fonte do include ou programa será aberto em outra aba para que você possa visualizá-lo. Se for um RUN feito em uma determinada procedure interna, será posicionado o cursor sobre a definição da procedure interna.

Help rápido
- Caso você esteja editando um código qualquer, se você parar o cursor sobre algum comando onde será apresentado um help rápido sobre o comando.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-29-54.png

Code complete
- Ao editar qualquer código, ao colocar o nome do comando, será apresentado opções do comando que você está digitando. Você também pode clicar CTRL+SPACE

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-18_21-31-28.png

Depuração de programas Remotos no PASOE
- É possível depurar programas remotamente no PASOE, onde podemos acompanhar todos os passos da execução do programa dentro do PASOE.
- Temos algumas regras para essa depuração:
  1. O PASOE tem que estar local na sua máquina;
  2. Você terá que ter acesso aos programas fontes.
- Passos para ativar a depuração:
  - Copiar o arquivo C:\dlc122\servers\pasoe\webapps\oedbg.war para dentro do diretório da instancia do PASOE\instancia\webapps
  - Ativar o debug do ambiente através dos comandos, acessando o MS-DOS como administrador da máquina:
    - c:\dlc122\bin\proenv
    - prodebugenable -~~enable-~~all
  - Dentro do PDS, ir em Window → Preferences → Progress OpenEdge → Server → OpenEdge Explorer Connection → Botão Add...

- - Informar os dados necessários para o acesso ao Explorer do PASOE

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_11-7-40.png

- - Selecionar o Server recém cadastrado e depois clicar no botão Apply and Close
- - Em Window → Show View → Other... → Server → Servers
- - Você terá que adicionar um novo server, clicando no link apresentado na view Servers...
- - Especifique um nome para o seu servidor e clique em Next >

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_16-40-46.png

- - Ao clicar na seta para baixo no Progress Application Server for OpenEdge, irá aparecer uma lista de todas as instancias do PASOE que você possui na sua maquina. Selecione a instancia que voce deseja debugar e clique em Finish.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_16-51-0.png

- - Após visualizar a sua instancia do PASOE, clique com o botão direito do mouse sobre ela e selecione a opção Restart in Debug

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_16-53-10.png

- - A sua instancia do PASOE será reinicializada e entrara em modo de Debug
  - Adicione os breakpoints desejados no seu programa fonte e faça a requisição que executará o seu programa dentro do PASOE.

Dica: Na view Servers, clicando com o botão direito do mouse, temos a opção View Log in LogViewer, que mostrará todos os logs da sua instancia do PASOE no LogViewer.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_17-4-17.png

- - Agora é só depurar o seu programa e localizar os problemas que estão acontecendo.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-11-11_17-21-41.png

08. QUESTIONAMENTOS

Como adicionar um Breakpoint para Debug?
- Com o programa aberto, dê um duplo-click na frente da linha desejada, onde será apresentado um marcador de breakpoint, conforme abaixo

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_9-10-26.png

Como adicionar mais um banco de dados no meu projeto?
- Menu Window → Preferences é aberto a janela de configurações do Eclipse

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_8-26-29.png

- Nas preferências, vá em Progress OpenEdge → Database Connections → botão New...

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-1-13.png

- Na janela Add Connection Profile, informe os dados necessários do banco a ser conectado, onde você pode testar a conexão

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-5-55.png

- Você também poderá informar dados de conexão SQL, caso necessário

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-7-6.png

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-7-40.png

- A nova conexão vai aparecer na tela de Database Connections

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-10-13.png

- Após isso, quando você clicar no botão OK, será solicitado que seja reiniciado a sua sessão do Eclipse PDS

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-9-26_17-10-35.png

- Uma vez reiniciado o Eclipse PDS, você deverá adicionar essa nova conexão do banco de dados no seu projeto, clicando com o botão direito do mouse sobre o nome do projeto e em Properties

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_9-58-3.png

- Dentro das propriedades do projeto, você acessa Progress OpenEdge → Database Connections → Show All, para que você possa visualizar todos os bancos de dados da Workspace, após isso é só selecionar o banco desejado e clicar no botão Apply and Close

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_15-6-14.png

Como adicionar ou alterar uma entrada no PROPATH do meu projeto?
- Temos duas formas, que são:
  - 1) Alterando o programa Debug.p, onde temos a linha PROPATH, podemos adicionar, alterar ou remover entradas no PROPATH para a execução e debug de programas.
  - 2) Botão direito do mouse sobre o nome do projeto e Preferences → Progress OpenEdge → PROPATH, onde você poderá adicionar, alterar e remover itens do PROPATH, para a IDE do Eclipse PDS. Este PROPATH serve para edição e localização dos programas fontes.

Linha Datasul > Criando seu ambiente no Progress Developer Studio (PDS) - Movido > image2022-10-17_15-16-50.png

Existe algum exemplo de .INI e .PF que poderia ser utilizado no PDSConfigGenerator?
- Pode ser utilizado .pf e .ini de algum dos ambientes abaixo:
  - Ambiente de compilação
  - Ambiente corporativo
  - Ambiente local, neste caso, os arquivos em anexo abaixo.

Como é feito a instalação do PDS?
- Para fazer a instalação do Progress Developer Studio (PDS), no instalador do Progress, basta fornecer a licença Progress Dev Studio OE que ele será instalará automaticamente.
- O Instalador encontra-se no servidor \\parati.jv01.local\progress\silenciosa\iss, onde temos vários arquivos .bat, e os que possuirem o sufixo _Dev são os que possuem a licença do PDS.

09. ANEXOS

10. LINKS

Instalador do Progress com o PDS:

\\parati.jv01.local\progress\silenciosa\iss → Os .bat que possuem o sufixo _Dev são os instaladores do progress com licença para o PDS.