Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

Rotinas automáticas e execução sem interface

Separa o contrato da rotina automática do seu canal de execução.

Rotinas automáticas e execução sem interfaceAdvPL
01 · VISÃO GERAL

Visão geral

Identifique a rotina suportada e seus campos, operação e formato dos vetores. Prepare identidade, empresa e filial apenas se o chamador não os fornecer. Em MsExecAuto, lMsErroAuto sinaliza erro não fatal; não captura sozinho toda exceção possível. lMsHelpAuto habilita captura e lAutoErrNoFile controla a geração padrão de arquivo. Em execução sem interface, não dependa de MsgInfo ou MostraErro em tela: trate mensagens com o mecanismo documentado, minimize dados sensíveis e defina transação e limpeza. O exemplo prepara somente as variáveis, sem chamar uma rotina ou gravar registros. (Fontes: refs. 1–2.)

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed635()
    // Identificadores PRIVATE impostos pelo contrato MsExecAuto.
    Private lMsErroAuto := .F.
    Private lMsHelpAuto := .T.
    Private lAutoErrNoFile := .T.
    // Resetar lMsErroAuto imediatamente antes da chamada homologada.
    ConOut(ValType(lMsErroAuto))
Return Nil
Resultado esperado

Imprime L. Não executa MsExecAuto nem declara sucesso de processamento. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não inventar vetor universal para rotinas distintas. Homologar falhas de regra, exceções, concorrência e reexecução.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Variáveis de controle da MsExecAuto. Consulta em 2026-10-27.
  2. Atilio. dan-atilio/AdvPL. Exemplos/Vídeo Aulas/011 - Gravação de Registros via MsExecAuto/zExecAuto.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha