Histórico da Página

CONTEÚDO

1. Visão Geral
2. Criando a Sua Workspace no PDS
3. Utilizando o Criador de Projetos no PDS
4. Importando o Seu Projeto no PDS
5. Entendendo o Seu Projeto Importado no PDS
6. Ajustes Necessários para o Bom Funcionamento do Seu Projeto no PDS
7. Alguns Recursos e Funcionalidades do PDS
   1. Execução de Programas
   2. Depuração de programas com o Debug
   3. Gerando Profiler
   4. Geração de Logs
   5. Monitoramento de Logs (Tailing)
   6. Organização do Código Fonte
   7. Abertura rápida de programas e includes
   8. Help rápido
   9. Code complete
8. Questionamentos
   1. Como adicionar um Breakpoint para Debug?
   2. Como adicionar mais um banco de dados no meu projeto?
   3. Como adicionar ou alterar uma entrada no PROPATH do meu projeto?

01. VISÃO GERAL

Âncora
geral 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;
  • Debug;
  • etc.

02. CRIANDO A SUA WORKSPACE NO PDS

Âncora
criando criando

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:

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

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

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

03.UTILIZANDO O CRIADOR DE PROJETOS NO PDS

Âncora
utilizando utilizando

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.

O PDSConfigGenerator solicitará as seguintes informações:

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.

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:

04.IMPORTANDO O SEU PROJETO NO PDS

Âncora
importando importando

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...

• 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

• 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).

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

• 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

05.ENTENDENDO O SEU PROJETO IMPORTADO NO PDS

Âncora
entendendo entendendo

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

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

Âncora
ajustes ajustes

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

• • 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

07.ALGUNS RECURSOS E FUNCIONALIDADES DO PDS

Âncora
recursos recursos

• Âncora
  execucao execucao

  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

• • • 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
  • 
  •  

• Âncora
  debug 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

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

• • 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

• • 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

• Âncora
  profiler profiler

  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.

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

• • 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

• Âncora
  logs logs

  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

• • 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.

• Âncora
  monitoramento monitoramento

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

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

• • 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)

• • 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)

• • 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

• • 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.

• Âncora
  organizacao organizacao

  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.

• Âncora
  aberturaRapida aberturaRapida

  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.

• Âncora
  helpRapido helpRapido

  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.

• Âncora
  codeComplete codeComplete

  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

08.QUESTIONAMENTOS

Âncora
questionamentos questionamentos

• Âncora
  breakpoint breakpoint

  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

• Âncora
  bancoDados bancoDados

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

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

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

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

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

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

• • 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

• • 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

• Âncora
  entradaPropath entradaPropath

  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.