Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

2. Login as admin and click on Design New App or click on existing application (See Figure 2).

Image RemovedImage Added

Figure 2


3. For new application, fill up the App ID and App Name then proceeds to click on Save button (See Figure 3).

...

 4. Create New Form, fill up Form ID, Form Name and Table Name then click on Save button (See Figure 4).
Image Removed
Image Added

Figure 4


5. Fill up the form with a Text Field with the id as name and a Record Locking form element, Configure the Record Locking form element as shown then save the form. (See Figure 5)
Image Removed
Image Added

Figure 5


6. Click the GENERATE APP button and generate a CRUD (See Figure 6).
Image Removed
Image Added

Figure 6


7. After creating the CRUD, Launch the UI (See Figure 7).

Image Modified

Figure 7

   

8. Create a new record and save it (See Figure 8).

Image Modified

Figure 8


   9. Login to the application as another user (example :- userusername: cat passwordcat   password: password), navigate to the newly created record and click edit (See Figure 9).

Image RemovedImage Added 

Figure 9 


10. Observe the timer, reload the page to see the current time left for the record to be unlocked (See Figure 10). 

Image Modified

Figure 10


  11. After the Timer runs out, the 2nd account (Cat Grant) should be able to edit the record and save the new edit (See Figure 11).

...

Form Record Locking Form Element Properties

Image Modified

Figure 12 : Record Locking Form Element Properties

Name

Description

ID

Element ID (By declaring as "title", a corresponding database table column "c_title" will be created)

LabelElement Label to be displayed to the end-user.
Lock DurationTime duration for the record to be locked from editing by other users
Display Name FormatName Formatting of the User that locked the record.
Validator

Attach a Validator plugin to validate the input value.

Info
titleWhen will validation take place?

Validation will take place whenever a form is submitted except when it is submitted as "Save as Draft".

FormSelect the form to be locked from editing



Image Added

Figure 13 : Record Locking Form Validator Properties

Image Added

Figure 14: Record Locking Form Validator Error Message


Note

The Record Locking Form Validator's is not meant to be used for "Regular" use cases. The validator's error message is only accessible for advanced users through editing the form page's source code. For example, since the Record Locking Form Element does not allow the users to save a locked record (the "Save" button is hidden), an advanced user can attempt to circumvent this by inspecting another page's source code and copying the save button HTML element and attempt to save the form; This is where the Record Locking Form Validator can be of use, as it would still deny the user from saving the form even though the "Save" button is shown.  

NameDescription
Error MessageMessage to be displayed when the user tries to manipulate a locked record.
FormSelect the form to be locked from editing.