OpenEdge Development: Mobile Applications - Product ...

find( ) method
find( ) method
Searches for a record in a temp-table referenced in JSDO local storage and returns a
reference to that record if found. If no record is found, it returns null.
After completing execution, any record found becomes the working record for the
associated temp-table. If the searched temp-table has child temp-tables, and the
useRelationships property is true, the working record of the result set for each child
is set to the first record as determined by the relationship to its respective parent. If a
record is not found, the working record is not set, and the working records of any child
temp-tables are also not set.
Return type: JSRecord object
Applies to: progress.data.JSDO class, table reference property (JSDO)
Syntax
[table-ref.]find ( funcRef )
table-ref
funcRef
A table reference on the JSDO. If the JSDO references only a single temp-table,
the method can be called on the JSDO itself.
A reference to a JavaScript function that returns a Boolean value and has the
following signature:
Syntax
function [ func-name ] ( jsrecord-ref )
Where func-name is the name of a function that you define external to the
find( ) parameter list and jsrecord-ref is a JSRecord reference to the next
available record on table-ref. You can also define funcRef without func-name
directly as an in-line function definition.
The find( ) function executes your funcRef for each record of table-ref, until
it returns true, indicating that funcRef has found the record. You can test the field
values on the data property of jsrecord-ref to determine the result. Otherwise,
you return false, and the find( ) function executes funcRef for the next
available record.
If funcRef finds the record, find( ) completes execution with both its return value and
the record property of table-ref set to the JSRecord reference of the found working
record. If find( ) reaches the end of available records without funcRef returning
true, find( ) completes execution with both its return value and the record property
on table-ref set to null, indicating that the sought for record is not found.
If table-ref references a child temp-table in a ProDataSet, when the
useRelationships property is true, find( ) uses the relationship to filter out all but
the child records of the working record in the parent temp-table. However, if the working
record of the parent is not set, find( ) throws an error. If useRelationships is false,
the search includes all records of the child temp-table and no error is thrown.
210 OpenEdge ® Development: Mobile Applications