insert

insert()

domain: client

language: javascript

class Item class

Description

Inserts a new, empty record in the item dataset.

After a call to insert, an application can enable users to enter data in the fields of the record, and can then post those changes to the item dataset using post method, and then apply them to the item database table, using apply method.

The insert method

  • checks if item dataset is active , otherwise raises exception

  • if the item is a detail , checks if the master item is in edit or insert state , otherwise raises exception

  • if the item is not a detail checks if it is in browse state , otherwise raises exception

  • triggers the on_before_append event handler if one is defined for the item

  • inserts a new, empty record in the item dataset.

  • puts the item into insert state

  • triggers the on_after_append event handler if one is defined for the item.

  • updates data-aware controls

See also

Modifying datasets