FIND Function (RecordRef)

Finds a record in a table based on the values stored in the key fields.

[Ok :=] RecordRef.FIND([Which])

Parameters

  • RecordRef
    Type: RecordRef The RecordRef that refers to the table in which you want to find a record.
  • Which
    Type: Text or code Specifies how to perform the search. The table will be searched until the record is found or there are no more records. Each character in the string can be present only one time. You can use the following characters:

    • =  search for a record that equals the key values (default)

    • >  search for a record that is larger than the key values

    • <  search for a record that is less than the key values

    • +  search for the last record in the table (+ can only be used alone)

    • -  search for the first record in the table (- can only be used alone)

    You can combine the '=', '<', and '>' characters. If this parameter contains '=', '>', or '<', then you must assign value to all fields of the current and primary keys before you call FIND.

Property Value/Return Value

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, it is assumed that you will handle any errors.

Remarks

FIND retrieves the first record that meets the conditions set by the Which parameter and the filters associated with the record. The search path reflects the sort order defined by the current key. If the current key is not the primary key, there is a chance that several records might have the same values in current key fields. If this occurs, the sort order defined by the primary key is used as the search path.

Example

The following example opens table 18 (Customer) as a RecordRef variable named CustomerRecref. The value for the field 1 (No.) is set to a specified record. In this example, the field is set to record 40000. The code uses the FIND function to find the record that matches. 40000 in the table. If the record is found, the number, name, address and city of the customer are displayed in message boxes. The values in the fields are retrieved by using the FIELD Function (RecordRef). This example requires that you create the following variables and text constants in the C/AL Globals window.

Name DataType

CustomerRecref

RecordRef

MyFieldRef

FieldRef

varCustomerNo

Code

Text constant name ConstValue

Text000

The customer was found.\

Text001

Customer No. %1 is:\%2

Text002

Sorry, that customer could not be found.

varCustomerNo := '40000';
CustomerRecref.OPEN(18);
MyFieldRef := CustomerRecref.FIELD(1);
MyFieldRef.VALUE := varCustomerNo;
IF CustomerRecref.FIND('=') THEN BEGIN
  MESSAGE(Text000 + Text001,  CustomerRecref.FIELD(1), CustomerRecref.FIELD(2));
  MESSAGE('Address: %1, %2',  CustomerRecref.FIELD(5),  CustomerRecref.FIELD(7));
END
ELSE
  MESSAGE(Text002);

See Also

Reference

RecordRef Data Type