cPontoEntradaCaracterObrigatório
Nome do ponto de entrada ou bloco a executar.
FUNçãOPublicado
ExecBlock
ExecBlock( <cPontoEntrada>, [lMostraErro], [lRetorna], [aParametros] ) --> uRetExecuta um ponto de entrada ou bloco customizado do ambiente Protheus.
Visão geral
ExecBlock() chama uma customização registrada no ambiente. É um mecanismo clássico de extensão do Protheus: a rotina padrão verifica ou executa um ponto de entrada para permitir validações, complementos e comportamentos específicos sem alterar diretamente o fonte padrão.
Sintaxe
ExecBlock( <cPontoEntrada>, [lMostraErro], [lRetorna], [aParametros] ) --> uRetParâmetros
lMostraErroLógicoOpcional
Indica tratamento/exibição de erro conforme o padrão do ambiente.
lRetornaLógicoOpcional
Indica se a chamada deve considerar retorno do bloco executado, conforme contrato da rotina.
aParametrosArrayOpcional
Parâmetros enviados ao ponto de entrada, quando previstos pelo contrato.
Execução com validação de retorno
#Include "TOTVS.ch"
User Function ExExecBlock()
Local lContinua := .T.
If ExistBlock("MA030VLD")
lContinua := ExecBlock("MA030VLD", .F., .F.)
EndIf
If !lContinua
MsgStop("Validação interrompida pelo ponto de entrada.")
EndIf
ReturnResultado esperado
Executa a customização apenas quando existe e respeita o retorno lógico.
- Combine com ExistBlock() quando o ponto de entrada for opcional.
- Leia a documentação do ponto de entrada para saber parâmetros, momento de execução e retorno esperado.
- Em validações, trate retorno lógico de forma explícita.
- Chamar ExecBlock() sem conhecer o contrato do ponto de entrada pode produzir erro ou comportamento inesperado.
- Não use como atalho genérico para acoplar rotinas sem documentação.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.