PONTO DE ENTRADAEm revisão

F040FAB

ExecBlock("F040FAB", .F., .F., nSavRec)

Complementa a gravação do título de FABOV gerado no contas a receber. Contrato técnico em revisão.

F040FABFINXFINExecBlockPARAMIXBFABOV

01 · VISÃO GERAL

Visão geral

O índice oficial relaciona F040FAB ao complemento da gravação do título de FABOV no contas a receber. A linha registra MATXATU e FINXFIN, mas a ficha específica permanece indicada como “Em construção”. (TOTVS, s.d., ref. 1) A listagem pública apresenta FINXFIN chamando ExecBlock("F040FAB", .F., .F., nSavRec). Essa evidência identifica o ponto e a expressão enviada; não demonstra a posição exata em relação ao commit. (TOTVS, s.d., ref. 2)

02 · SINTAXE

Sintaxe

ExecBlock("F040FAB", .F., .F., nSavRec)

Parâmetros

PARAMIXB

ContextualContexto de execução

Contexto disponibilizado pelo quarto argumento de ExecBlock. Não é um argumento formal obrigatório da User Function. A listagem mostra nSavRec sem array explícito; presença, tipo e significado efetivos precisam ser confirmados no release-alvo.

Retorno

Contrato específico não confirmado nas fontes públicas localizadas. O Return sem expressão pertence apenas ao exemplo de diagnóstico e não estabelece o retorno exigido pelo padrão.

03 · EXEMPLO PRÁTICO

Exemplo de diagnóstico

#Include "Protheus.ch"



User Function F040FAB()

    Local uContexto := Nil



    // Preserva o tipo recebido, sem presumir um array de parâmetros.

    If Type("PARAMIXB") <> "U"

        uContexto := PARAMIXB

    EndIf



    // Diagnóstico para homologação: não altera o título nem a transação.

    ConOut("F040FAB: tipo recebido = " + ValType(uContexto))

Return

Resultado esperado

Se o PE for acionado no cenário testado, deverá aparecer no console uma linha com o tipo encontrado. A ausência da mensagem não prova incompatibilidade: confira a compilação, o RPO, o ambiente e se a operação exercita a geração do título correspondente.

BOAS PRÁTICAS

Confirme a chamada e o cenário de geração do título no release e patch utilizados.
Preserve as áreas de trabalho caso a customização futura selecione ou reposicione aliases.
Comece pelo diagnóstico do tipo de PARAMIXB, sem imprimir dados do título.
Compare o processamento sem customização e com o exemplo em homologação.
Registre a versão validada e mantenha os comentários didáticos junto ao código.

ARMADILHAS COMUNS

Não presumir que PARAMIXB seja array nem que PARAMIXB[1] represente o contexto.
Não deduzir a tabela ou o registro recebido apenas pelo nome nSavRec.
Não atribuir ao retorno .T./.F. um efeito de autorização ou cancelamento não documentado.
Não assumir execução após commit, bloqueio de registro ou alias posicionado.
Exemplo não compilado nem executado em Protheus; a leitura integral das fontes continua pendente.

Conteúdos relacionados

REFERÊNCIAS

Situação: Em revisão
Página criada em: 20/10/2026 às 09:02
Última revisão em: 20/10/2026 às 09:42
Idioma original: Português
Revisão: Usina.BR