OpenEdge Development: Mobile Applications - Product ...

JSDO overview
– assign( ) — Called on a JSDO table reference or a JSRecord reference,
this method updates field values for an existing record in JSDO local storage
from property values of an object passed as a parameter to the method; has
no effect on existing working record settings.
Note: An assign( ) method is also available on a table reference of a
progress.ui.UIHelper object. However, it updates the field values
of an existing record from values in an HTML page. For more
information, see the “Getting started with other HTML coding tools”
section on page 122.
– remove( ) — Called on a JSDO table reference or a JSRecord reference,
this method deletes an existing record in JSDO local storage; no working
record is set for the table reference or any of its child table references.
These methods always execute synchronously. You save the changes that these
methods make in JSDO local storage to the AppServer by calling the
saveChanges( ) method on the JSDO, which executes asynchronously.
• Searching for record objects in JSDO local storage:
– find( ) — Searches for a record in a referenced temp-table according to the
criteria defined by a function that you pass, and returns the record object if
the function indicates it has been found; sets any record found as the working
record for the table reference, and sets the working record for any child table
references to the first record that is related to the parent working record.
– findById( ) — Searches for a record in a referenced temp-table with the
specified record ID, and returns the record object if found; sets any record
found as the working record for the table reference, and sets the working
record for any child table references to the first record that is related to the
parent working record.
– foreach( ) — Loops through the records of a referenced temp-table, and
allows a function that you pass to access each record object and perform
whatever actions you define until the function tells the method to stop looping
or the method has reached the end of the record set; the record for each
iteration is set as the working record for the table reference, and sets the
working record for any child table references to the first record that is related
to the parent working record. If the loop terminates, the last working record
remains the working record for the table reference.
These methods are called on a JSDO table reference and always execute
synchronously.
OpenEdge ® Development: Mobile Applications 97