OpenEdge Development: Mobile Applications - Product ...

assign( ) method (JSDO class)
assign( ) method (JSDO class)
Updates field values for the specified temp-table record referenced in JSDO local
storage. The specified record can be either the working record of a referenced
temp-table or any record provided by a JSRecord object.
After execution, any working records previously set before the method executed
remain as the working records. To synchronize the change on the AppServer, call the
saveChanges( ) method.
Return type: Boolean
Applies to: JSRecord object, progress.data.JSDO class, table reference property
(JSDO)
Syntax
[table-ref.]assign ( update-object )
jsrecord-ref.assign ( [ update-object ] )
table-ref
A table reference on the JSDO for a temp-table that has a working record. If the
JSDO references only a single temp-table, the method can be called on the JSDO
itself.
jsrecord-ref
A reference to a JSRecord object for a temp-table record in JSDO local storage.
update-object
Passes in the data to update the specified record object in JSDO local storage.
Each property of the object has the name of a temp-table field name and the value
to set for that field in the specified record. Any temp-table fields without
corresponding properties in update-object remain unchanged in the record.
The following code fragment shows a jQuery event defined on a save button to save
the current field values for a customer detail form to the corresponding eCustomer
record in JSDO local storage:
dataSet = new progress.data.JSDO( 'dsCustomerOrder' );
$('#btnSave').bind('click', function(event) {
var jsrecord = dataSet.eCustomer.findById($('#custdetail #id').val());
jsrecord.assign(update-object);
dataSet.saveChanges();
});
The form has been displayed with previous values of the same record. When the button
is clicked, the event handler uses the findById( ) method to find the original record
with the matching internal record ID (jsrecord) and invokes the assign( ) method on
jsrecord with an object parameter to update the fields in eCustomer with any new
values entered into the form.
See also: getSchema( ) method, saveChanges( ) method
OpenEdge ® Development: Mobile Applications 193