Jam.py documentation



domain: client

language: javascript

class Item class


Puts the current record in edit state and creates an edit_form for visual 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 editing is allowed in modeless mode, the user can edit several records at the same time. In this case the application calls the copy method to create a copy of the item. This copy will be used to edit the record. The application will call its open method to get the record from the server by using the value of the primary key field as a filter.

In case of modal editing the application executes refresh_record methods to get from the server the latest data of the record.

If a record locking is enabled for the item, along with receiving the record data from the server the application receives the version of the record.

Then the edit_record method

  • calls the can_edit method to check whether a user have a right to edit the record,
  • if the user have a right to edit the record, checks whether the item is in edit or insert state , and if not, calls the edit method to edit the record
  • calls the create_edit_form method to create a form for visual editing of the record