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:
Para criar a sua workspace no eclipse, você deverá seguir os seguintes passos:
| Á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. |
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. |
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.
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:
Para importar o seu projeto, você deverá seguir os seguintes passos:
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. |
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. |
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 */ |
| 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. |
, onde aparecerá um atalho com o mesmo nome do seu programa, neste exemplo Debug
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. |
| 4 | Console do que está sendo executado. |
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. |
, onde aparecerá um atalho com o mesmo nome do seu programa, neste exemplo Debug
(1)
(2)
