OpenEdge Development: Mobile Applications - Product ...

progress.data.JSDO class
Note: If a field-ref has the same name as a built-in property or method of
the JSDO, you must use the data property to reference its value in the
working record.
Caution: Never write directly to a field-ref using this data property; in this
case, use field-ref only to read the data. Writing to data using
such a reference does not mark the record for update when calling
the saveChanges( ) method. To mark a record for update, you
must assign a field value either by setting a
jsdo.table-ref.field-ref for a working record or by calling the
assign( ) method on a valid table-ref or JSRecord object
reference.
jsrecord-ref
A reference to a JSRecord object of a temp-table in JSDO local storage. You
can return a jsrecord-ref for a working record as the value of the record
property or as a value returned by supported JSDO built-in methods that
return a working record, such as add( ) and find( ).
For more information on the properties available to reference working record fields
using this syntax, see Table 10 and Table 8. For more information on the methods
for setting the working record for referenced temp-tables, see Table 11 and
Table 9.
• Many JSDO built-in methods are actually invoked on a JSDO table reference, and
can only be invoked on the JSDO itself when its local storage is initialized with a
single temp-table.
• For a multi-table ProDataSet, the JSDO accesses the data for all unrelated
temp-tables in local storage as top-level tables of the JSDO. Access to data for all
related child temp-tables depends on the working record of the parent temp-table
in the JSDO and the setting of the useRelationships property.
See also JSRecord object, progress.data.Session class, record property, table reference
property (JSDO), table reference property (UIHelper)
OpenEdge ® Development: Mobile Applications 163