Rows.rowId()

note

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

Rows.rowId()

Gets the unique row ID of the first record in the Rows object. A row ID is a client-side identifier that stays the same for the lifetime of the record, unlike its index which can shift as other records are inserted or deleted. Row ID's are unique over all data sources and their contents, for the whole frame context they are created in.

Returns a row ID. Returns undefined if no record is available.

Syntax

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

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 id = $.udb('EMP').rows('current').rowId();