The progress.data.JSRecord is a JavaScript class that represents a record instance for any table stored in the JSDO memory of an associated progress.data.JSDO class instance (JSDO). The constructor for progress.data.JSRecord is protected. JSRecord instances are created internally by JSDO methods.

Properties

Table 1. progress.data.JSRecord class properties
Member Brief description (See also the reference entry)
data property

The data (field) and state values for a record associated with a JSRecord object.

Methods

Table 2. progress.data.JSRecord class methods
Member Brief description (See also the reference entry)
acceptRowChanges( ) method

Accepts changes to the data in JSDO memory for a specified record object.

assign( ) method (JSDO class)

Alias: update( )

Updates field values for the specified JSRecord object in JSDO memory.

getErrorString( ) method

Returns any before-image error string in the data of a record object referenced in JSDO memory that was set as the result of a resource Create, Update, Delete, or Submit operation.

getId( ) method

Returns the unique internal ID for the record object referenced in JSDO memory.

remove( ) method

Deletes the specified table record referenced in JSDO memory.

rejectRowChanges( ) method

Rejects changes to the data in JSDO memory for a specified record object.

Events

This class has no events.

Example

The following example assumes that a JSDO is referenced by the jsdo variable, and that an instance associated with that JSDO is referenced by the uihelper variable. The example creates a new record object and displays it, along with a message with credit information using properties of the record object:

function addRecord() {
  var jsrecord = jsdo.add( {Balance: 10000, State: 'MA'} );
  uihelper.display( );
  alert( 'Record ID: ' + jsrecord.getId( ) + ' CreditLimit: ' +
         jsrecord.data.CreditLimit );
}

Notes

Using the add( ), find( ), findById( ), or foreach( ) method, or the record property, on a given JSDO and table reference, a JSRecord instance returns a working record for the table referenced in JSDO memory. You can then use properties and methods of the JSRecord to update, delete, or display the specified record from the JSDO.

See also

add( ) method, find( ) method, findById( ) method, foreach( ) method, progress.data.JSDO class, record property, table reference property (JSDO class)