ENTRY POINTUnder review

F290VAL

User Function F290VAL()

Allows intervention when selecting records in FINA290 payable aggregation.

F290VALFINA290

01 · OVERVIEW

Overview

The specific page instructs using TRBSE2 to identify the selected record and shows examples locating SE2 and changing E2_HIST. Their headers mention 12.1.2310 and 2023-11-14, which does not certify every release. (TOTVS, ref. 1) The community listing passes {aChaveLbn} in FA290BAVAL. (Ref. 2) The support article describes a marked-title array return, whereas the specific examples end without an array and the caller excerpt does not assign the result. This disagreement remains explicit; an array contract is not presented as confirmed. (Ref. 3)

02 · SYNTAX

Syntax

User Function F290VAL()

Parameters

PARAMIXB[1] / aChaveLbn

UnknownContext to confirm

The call wraps aChaveLbn in an outer array; its type and internal structure are unconfirmed. (Ref. 2)

Return value

Inconclusive across sources: specific examples use Return without a value; the grouped support article mentions a marked-title array. The editorial diagnostic uses NIL without promising selection or amount changes. (Refs. 1–3)

03 · PRACTICAL EXAMPLE

Inspect selected payable type without writing records

#Include "Protheus.ch"

User Function F290VAL()
    // Editorial example based on the TDN alias and field (ref. 1).
    // Does not repeat a partial-key DbSeek or change E2_HIST.
    If Select("TRBSE2") > 0
        If !TRBSE2->(Eof())
            // Does not log payable number, supplier or amount.
            ConOut("F290VAL: payable type = " + TRBSE2->E2_TIPO)
        EndIf
    EndIf
Return Nil

Expected result

Proposes observing E2_TIPO in the selected temporary record. Does not change amounts, history or marks. Example not compiled or run in Protheus.

BEST PRACTICES

Do not assume all of PARAMIXB is a payable list: the community call shows an outer array containing aChaveLbn, whose layout was not confirmed.
The second official example comments a SE2 index including supplier and store but builds a five-field key. Verify the full key and DbSeek success before writing.
The official examples change E2_HIST despite the page title referring to amounts. They do not establish an amount formula or automatic total update.
A future writing adaptation must validate exact record identity, check RecLock, preserve work areas and respect the standard transaction. The published diagnostic does not write records.
Editorial test plan: compare standard and customized behavior in the described operations, inspect resulting records and record release and patch.
Under review: sources and example checked against documentation; code not compiled or run in Protheus. Exact transaction position and target release behavior remain unconfirmed.