$.udb(ds).rowSet()

note

This article is about the rowSet() function of the DataSourceContainer object.

$.udb(ds).rowSet()

Gets a row set of the data source for a specified parent key.

Returns a Rowset object. If parent-key refers to an existing Rowset object in the data source, then the details of this Rowset are returned in a Rowset object. Otherwise, the return value is undefined.

Syntax

$.udb( *ds* ).rowSet( *parent-key* )

*parent-key*  ::=  { current | *key-string* | *key-object* }

*key-object*  ::=  {
*data-source-id* : {
*key-column* : *value*,
        ...
  },
  ...
}

The optional ds is a data source selector.

The required parent-key must be one of the following:

• The literal string 'current'. This refers to the currently active row set of the data source.
• Any other key-string representing the row set's parent key. This must be an exact match to any Rowset object in the data source object in the data layer.
• An object that is a struct specifying one or more parent keys for at least one data source. This object is transformed to the corresponding key-string at runtime.

note

For more on keys strings, go to the Rowset help topic. See also the Rowset.keysString() function.

Example

var rowSet = $.udb('EMP').rowSet('current');
if (rowSet.exists()) {
…
}