Rows.status()

note

This article is about the status() function of the Rows object.

Rows.status()

Gets the status of the first record in the Rows object.

Returns a string: 'inserted' if the record is newly inserted (but not yet committed), 'updated' if one or more of its values have been changed (but not yet committed), or '' (the empty string) otherwise.

Syntax

$.udb( *ds* ).rows( [rowRef1], [rowRef2] ).status()
$.udb( *ds* ).rowSet( *rowSet* ).rows( [rowRef1], [rowRef2] ).status()

The required ds parameter is a data source selector.

The optional rowSet parameter is a rowset identifier. If the .rowSet() clause is omitted, then .rowSet('current') is assumed.

The optional rowRef1, rowRef2 are row selectors. If omitted, all records in scope are addressed.

Example

let unchanged = $.udb('EMP').rows('current').status() === '';