FINDFIRST Function (Record)

Finds the first record in a table based on the current key and filter.


[Ok :=] Record.FINDFIRST

Parameters

Record

Type: Record

If the record was found, it is returned in this parameter and any FlowFields in the record are set to zero. You must update the FlowFields by using the CALCFIELDS Function (Record).

If the record was not found and if you omitted the return value, a run-time error occurs.

Type: Boolean

true if the record was found; otherwise, false.

If you omit this optional return value and the record cannot be found, a run-time error occurs. If you include a return value, you must handle any errors.

This function should be used instead of FIND('-') when you only need the first record.

You should only use this function when you explicitly want to find the first record in a table or set. Do not use this function in combination with REPEAT..UNTIL.

This example requires that you create the following variable.

Variable name Datatype Subtype

SalesSetupRec

Record

Sales & Receivables Setup

This example also assumes that you have a ConfigurePost function.

// Read the first record only. 
IF SalesSetupRec.FINDFIRST THEN BEGIN
  ConfigurePost(SalesSetupRec);
END;

Community Additions

ADD
Show: