Jam.py documentation

insert_record

insert_record(container)

domain: client

language: javascript

class Item class

Description

Open a new, empty record at the beginning of the dataset and creates an 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 Edit Form Dialog or modeless attribute of the edit_options is set programmatically and task has the 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 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 copy method to create a copy of the item. This copy will be used to insert the record.

The insert_record method

  • calls the 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 state , and if not, calls the insert method to insert a record

  • calls the create_edit_form method to create a form for visuall editing of the record