ENTRY POINTUnder review

FA290HPAD

User Function FA290HPAD()

Supplies the result assigned to cHistFat in FA290GRVFT.

FA290HPADFINA290

01 · OVERVIEW

Overview

The official index associates the hook with FINA290 without detailing its contract. P12.2210 records cHistFat := ExecBlock in FA290GRVFT without a fourth argument. The destination name suggests invoice history, but the excerpt supplies no formal type, size, persisted field or composition rule. No useful GitHub example was found. (Refs. 1–2) Research includes indexed TDN evidence; no complete specific page was recovered.

02 · SYNTAX

Syntax

User Function FA290HPAD()

Parameters

Entry point context

UnconfirmedContext to confirm

The complete technical contract remains unconfirmed. Do not assume types, PARAMIXB positions or aliases beyond the evidence described.

Return value

Result replaces cHistFat; formal type and limits unconfirmed in recovered evidence.

03 · PRACTICAL EXAMPLE

Observed call and context

// P12.2210 caller excerpt (EURAI, ref. 2); not an entry point implementation.
// FINA290.PRW - FA290GRVFT() -> CHISTFAT := EXECBLOCK("FA290HPAD", .F., .F.)

Expected result

The record shows arguments and immediate return use where present. It omits the full caller body and does not establish commit timing.

BEST PRACTICES

Do not return empty text as a neutral diagnostic: it replaces the caller result. Identify history origin, destination and limits before proposing concatenation or truncation.
A call without a fourth argument does not document a PARAMIXB layout. Preserve caller identifiers and do not invent fields or positions.
Test plan: compare standard and customized flows, exercise success, rejection and repetition, and inspect balances, movements and accounting as applicable.
Under review: example not compiled or run in Protheus. Verify aliases, locks, transaction position and compatibility in the target release and patch.