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

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;
  • Debug;
  • 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:

Image Removed

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

Image Removed

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

Image Removed

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

...

Outline

...

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.

Image Removed

O PDSConfigGenerator solicitará as seguintes informações:

...

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)

...

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

...

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ê

...

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. 

...

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.

Image Removed

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:

Image Removed

...

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

Image Removed

• 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

Image Removed

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

Image Removed

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

Image Removed

• 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

Image Removed

...

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

...

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 */

...

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

...

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.

...

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

Image Removed

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

Image Removed

...

• 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

Image Removed

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

• 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

Image Removed

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

Image Removed

Abaixo vamos descrever cada janela que está sendo apresentada:

...

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.

...

Image Removed

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

...

...

...

...

...

...

...

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

Image Removed

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

Image Removed

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

Image Removed

Image Removed

Image Removed

• 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

Image Removed

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

Image Removed

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

Image Removed

• • 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 Image Removed (1)

Image Removed

• • 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 Image Removed (2)

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

• 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

Image Removed

...

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image RemovedO conteúdo dessa página foi movido para link