Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  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

...

Bloco de código
linenumberstrue
collapsetrue
/*----------------------------------------------------------------------
  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:

    BlocoDescrição
    PROPATHO 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 WindowPreferences é aberto a janela de configurações do Eclipse

...

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 AsProgress 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 AsProgress OpenEdge Application

...

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

      BotãoAtalhoDescrição

      F8Resume, que permite continuar uma execução


      Suspend, que permite fazer uma pausa na execução e continuar a execução passo-a-passo

      Ctrl-F2Terminate, que permite terminar a depuração e continuar a execução do programa normalmente sem depuração

      F5Step Into, que permite entrar na depuração dentro de um programa filho, função ou procedure interna.

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

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

...

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

...

    • 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 WindowPreferences é aberto a janela de configurações do Eclipse

...

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

...