$.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 UdbRowSets object array of UdbRowSet objects. If parent-key refers to an existing UdbRowSet object in the data source, then this rowset is added to the array.

Syntax

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

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

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

The required 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 rowset of the data source.
• Any other key-string representing a rowset's parent key. This must be an exact match to any UdbRowSet 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 and matched to the corresponding key-string at run-time.

note

For more on key strings, go to the UdbRowSet help topic. See also its .keysString() function.

Example

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