OpenEdge Development: Mobile Applications - Product ...

addRecords( ) method
key-fields
An object with a list of key fields to use to check for duplicate records. For
example, when merging with a ProDataSet that has eCustomer and eOrder table
references, you might use the following object:
{
}
eCustomer: [ "CustNum" ],
eOrder: [ "CustNum", "Ordernum" ]
When merging with a single table reference, you might use the following array
object:
[ "CustNum", "Ordernum" ]
A typical use for addRecords( ) is to merge additional data returned by an invocation
method without having to re-load local storage with all the data from the fill( )
method.
For example, given a JSDO, dataset, that you fill with available records from the
eCustomer and eOrder temp-tables, you might retrieve a new eOrder record as the
result of a getNewOrder( ) invocation method on the JSDO and add the new record
to JSDO local storage as follows:
var dataset = progress.data.JSDO( "dsCustomerOrder" );
dataset.fill(); // Loads the ProDataSet with all available records
// Adds a new eOrder record restrieved from the service
var request = dataset.getNewOrder(null,false);
dataset.eOrder.addRecords( request.response, progress.data.JSDO.MODE_APPEND,
[ "CustNum", "Ordernum" ],
);
This code fragment adds the eOrder record for an existing eCustomer record specified
by the CustNum property and a new order number specified by the Ordernum property
of the single record object returned in result.dsCustomerOrder.eOrder[0].
See also: fill( ) method, invocation method
182 OpenEdge ® Development: Mobile Applications