============= insert_record ============= .. js:function:: insert_record(container) **domain**: client **language**: javascript **class** :doc:`Item class ` Description =========== Open a new, empty record at the beginning of the dataset and creates an :doc:`edit_form ` for visuall editing of the record. If ``container`` parameter (Jquery object of the DOM element) is specified the edit form html template is inserted in the container. If ``container`` parameter is not specified but **Modeless form** attribute is set in the :doc:`Edit Form Dialog ` or modeless attribute of the :doc:`edit_options ` is set programmatically and task has the :doc:`forms_in_tabs ` attribute set and the application doesn't have modal forms, the modeless edit form will be created in the new tab of the :doc:`forms_container ` object of the task. In all other cases the modal form will be created. If insertion of a record is allowed in modeless mode, the application calls the :doc:`copy ` method to create a copy of the item. This copy will be used to insert the record. The ``insert_record`` method * calls the :doc:`can_create ` method to check whether a user have a right to insert a record, and if not, returns * checks whether the item is in edit or insert :doc:`state ` , and if not, calls the :doc:`insert ` method to insert a record * calls the :doc:`create_edit_form ` method to create a form for visuall editing of the record See also ======== :doc:`Forms ` :doc:`Modifying datasets ` :doc:`insert ` :doc:`can_create `