Jam.py documentation

edit

edit()

domain: client

language: javascript

class Item class

Description

Enables editing of data in the dataset.

After a call to edit, an application can enable users to change 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 database using apply method.

The edit method

  • checks if the item dataset is active, otherwise raises exception

  • checks if the item dataset is not empty, otherwise raises exception

  • checks whether the item dataset is already in edit state, and if so, returns

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

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

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

  • puts the item into edit state , enabling the application or user to modify fields in the record

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