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