====== append ====== .. js:function:: append() **domain**: client **language**: javascript **class** :doc:`Item class ` Description =========== Open a new, empty record at the end of the dataset. After a call to append, 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 :doc:`post ` method, and then apply them to the item database table, using :doc:`apply ` method. The ``append`` method * checks if item dataset is :doc:`active ` , otherwise raises exception * if the item is a :doc:`detail ` , checks if the master item is in edit or insert :doc:`state ` , otherwise raises exception * if the item is not a :doc:`detail ` checks if it is in browse :doc:`state ` , otherwise raises exception * triggers the :doc:`on_before_append ` event handler if one is defined for the item * open a new, empty record at the end of the dataset * puts the item into insert :doc:`state ` * triggers the :doc:`on_after_append ` event handler if one is defined for the item. * updates :doc:`data-aware controls ` See also ======== :doc:`Modifying datasets `