Usina BRAdvPL Guide
Sign in
← All topics
ENTRY POINTPublished

FA40PROT

FA40PROT() --> Nil or a return value not consumed by the analyzed flow

FA40PROT runs in the Edit phase of FINA040, in the FA040Alter source section.

Entry pointsFINA040SIGAFINAccounts ReceivableExecBlockEdit
01 · OVERVIEW

Overview

FA40PROT is an Entry Point identified directly in the analyzed FINA040 source flow. Its call is located in FA040Alter, during the Edit phase. Confirm parameters and the expected return value against the release and patch used by the target environment.

02 · SYNTAX

Syntax

FA40PROT() --> Nil or a return value not consumed by the analyzed flow

Parameters

PARAMIXB
ContextualOptional

When the ExecBlock call sends parameters, they are exposed according to this release context. Check the call site and validate the source used by the environment.

Return value

Nil or a return value not consumed by the analyzed flow.

03 · PRACTICAL EXAMPLE

Safe structure for starting the analysis

#Include "TOTVS.ch"

User Function FA40PROT()
    Local uRet := Nil

    // Confirm PARAMIXB and the expected return type in the target release.
    // Keep only rules that belong to this exact FINA040 execution point.

Return uRet
Expected result

Minimum structure: adjust parameters and the return type only after checking the call site in the release used by the environment.

BEST PRACTICES
  • Preserve the work areas used by the customization.
  • Read PARAMIXB only after confirming its structure at the call site in the target release.
  • Keep the implementation short and record the release that was validated.
  • Test creation, edit, deletion, and automatic processing separately when applicable.
COMMON PITFALLS
  • Do not assume similarly named Entry Points share the same contract.
  • Do not change the return type expected by the calling flow.
  • Do not depend on private variables without validating the call context.

Related content

REFERENCES
  1. TOTVS. FINA040.PRX — Accounts Receivable. Standard source dated Aug. 26, 2019; ExecBlock call confirmed in FA040Alter.
  2. TOTVS. Finance Entry Points — P12.
Status
Published
Page created on
Last reviewed on
Original language
Portuguese
Reviewed by
Usina.BR
0 approved comment(s)

Comments

There are no approved comments yet.

Sign in with Google or Microsoft to comment.

Powered by Usina Docs · Alpha