debugar-advpl

Depurar AdvPL/TLPP

As tools tds_debug_* e tds_run ligam o depurador da TOTVS ao AppServer conectado e rodam o programa no SmartClient HTML (webapp). As descrições das tools são a fonte do que cada parâmetro e campo de retorno significa; aqui está o processo. Modo navegador, módulo, headless, REST/jobs, temporários e problemas comuns: REFERENCE.md.

Dois vocabulários de resultado:

• tds_run devolve resultado: concluido, erro (mensagem, fonte/linha, pilha) ou tempoEsgotado (vêm tela e botoes; a execução é encerrada).
• tds_debug_start/wait/step devolvem estado: parado (local, pilha, variáveis), executando (não parou no prazo; headless traz tela e botoes, navegador traz conectado) ou encerrado (programa terminou; erro em erroDeExecucao ou mensagem de nível ERROR).

Arquivo que o programa manda ao navegador (PDF, CpyS2TW) vem em arquivosBaixados, com o caminho local, nos modos headless e job sem WebAgent; com o agente ligado, o PDF abre no visualizador da máquina e não volta (REFERENCE.md, "TOTVS WebAgent").

Passos

1. Licença. Pergunte ao usuário: "Posso executar/depurar <programa> em <servidor>/<ambiente>?" e, se for compilar algo (passo 3), cite os fontes na mesma pergunta. O programa roda de verdade, grava o que gravar, e parado num breakpoint segura a thread no servidor; compilar troca no RPO a versão que estiver lá (num ambiente compartilhado, a de um colega). Ambiente de produção: confirme de novo, à parte, antes de executar ou compilar. A licença vale para aquele servidor nesta conversa. Concluído quando: o usuário autorizou servidor, ambiente e o que será compilado.

2. Caminho. Escolha pelo que a rotina precisa:

   • Saber se roda ou qual erro dá, sem tela, sem empresa e em até ~100 s: tds_run com timeoutSeg adequado (padrão 60; no tempo esgotado a execução é interrompida no meio). A função roda sem empresa aberta (sem xFilial, SX, MV_). O tds_run não devolve o valor de retorno: para ver o que a função devolve, use o wrapper com rastro no Return (REFERENCE.md, "Wrapper de teste").
   • Rotina sem tela, ou processamento que pode passar de 100 s: tds_debug_start modo headless, repetindo tds_debug_wait (também sem empresa aberta).
   • Rotina que usa o ambiente do usuário (empresa e filial, Pergunte, MV_) ou tem tela: modo navegador com modulo e a rotina em programa. Sem o módulo no pedido, pergunte ao usuário em qual módulo a rotina roda. Você faz o login e confirma as telas de entrada no chrome-devtools (REFERENCE.md, "Rotina dentro do módulo").
   • Rotina com parâmetro numérico, lógico ou data (argumentos chegam sempre como caractere e não combinam com modulo), com parâmetro e ambiente ao mesmo tempo, chamada por StartJob/agendamento, ou cujo arquivo gerado (PDF) você precisa conferir: wrapper que monta o cenário e chama a rotina, com nome = prefixoWrapper (devolvido por tds_use_server, único por pessoa e máquina) + 3 letras da rotina, ex.: U_zTK3FRel (no mesmo RPO outro desenvolvedor pode ter o dele), rodado com tds_run ou no modo headless (o arquivo volta em arquivosBaixados) e compilado como temporário (REFERENCE.md, "Wrapper de teste"). Empresa, filial e respostas de pergunta (MV_PARxx) vêm do usuário; sem elas, pergunte. Função que já recebe empresa e filial e abre o próprio ambiente roda direto, com elas em argumentos.
   • Rotina que depende do TOTVS WebAgent (arquivo na máquina do usuário, Excel, porta serial/balança, GetRemoteType() 1): o modo navegador já o liga (abra a página como diz o proximoPasso, com o initScript); nos outros, webAgent: true (REFERENCE.md, "TOTVS WebAgent").
   • O caminho HTTP de um REST, ou a thread exata que o StartJob cria: modo job, só quando o usuário confirmar que o AppServer é exclusivo dele (nenhum outro desenvolvedor ou usuário conectado; "é o de desenvolvimento" não basta) e quem ajusta o appserver.ini (REFERENCE.md, "REST e jobs").
   • Pedido com arquivo e linha, sem dizer que rotina executa aquele trecho: pergunte a rotina ou o menu de entrada; o programa é o ponto de entrada, não a função que contém a linha. Concluído quando: o caminho escolhido cobre o que a rotina precisa de ambiente e de parâmetro.