FINDSET Function (RecordRef)

Finds a set of records in a table based on the current key and filter. FINDSET can only retrieve records in ascending order.

Syntax

  
[Ok :=] RecordRef.FINDSET([ForUpdate][,UpdateKey])  

Parameters

RecordRef
Type: RecordRef

The RecordRef that refers to the table in which you want to find the set of records.

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

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

ForUpdate
Type: Boolean

Set this parameter to false if you do not want to modify any records in the set. Set this parameter to true if you want to modify records in the set.

If you set this parameter to true, the LOCKTABLE Function (RecordRef) is immediately performed on the table before the records are read.

UpdateKey
Type: Boolean

This parameter only applies if ForUpdate is true.

If you are going to modify any field value within the current key, set this parameter to true.

Property Value/Return Value

Type: Boolean

true if the record set was found; otherwise, false.

If you omit this optional return value and if 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

You should use this function only when you explicitly want to loop through a recordset. You should only use this function in combination with REPEAT..UNTIL.

Furthermore, FINDSET only allows you to loop through the recordset from the top down. If you want to loop from the bottom up, you should use FIND(‘+’).

The general rules for using FINDSET are the following:

  • FINDSET(FALSE,FALSE) - Read-only. This uses no server cursors and the record set is read with a single server call.

  • FINDSET(TRUE,FALSE) - This is used to update non-key fields. This uses a cursor with a fetch buffer similar to FIND(‘-’).

  • FINDSET(TRUE,TRUE) - This is used to update key fields.

    This function is designed to optimize finding and updating sets. If you set any or both of the parameters to false, you can still modify the records in the set but these updates will not be performed optimally.

    This function works the same way as the FINDSET Function (Record).

Example

The following example opens table 18 (Customer) as a RecordRef variable that is named MyRecordRef. The FIELD Function (RecordRef) creates a FieldRef variable that is named MyFieldRef with the first field (No.). The SETFILTER Function (FieldRef) uses the MyFieldRef variable to set a filter that selects records from 30000 to 32000. MyRecordRef.FIELD(2) creates a FieldRef for the second field (Name). The FINDSET function finds the set of records based on the key and the filters that have been set. The ForUpdate parameters and UpdateKeys are both set to FALSE. This makes the records in the set read-only. The record ID and name of each customer in the record set is displayed in a message box until no records are left in the record set. The following example requires that you create the following variables and text constant in the C/AL Globals window.

Variable name DataType
MyRecordRef RecordRef
MyFieldRef FieldRef
Text constant name DataType ENU value
Text000 Text %1: "%2" is found in the set of records.
  
MyRecordRef.OPEN(18);  
MyFieldRef := MyRecordRef.FIELD(1);  
MyFieldRef.SETFILTER('30000..32000');  
MyFieldRef := MyRecordRef.FIELD(2);  
IF MyRecordRef.FINDSET(FALSE, FALSE) THEN BEGIN  
  REPEAT  
    MESSAGE(Text000 , MyRecordRef.RECORDID, MyFieldRef.VALUE);  
  UNTIL MyRecordRef.NEXT = 0;  
END;  

See Also

RecordRef Data Type
FIND Function (RecordRef)
FINDFIRST Function (RecordRef)
FINDLAST Function (RecordRef)