You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Introduction

Form Record Locking is a form element that allows users to lock a record from being edited by other application users for a specified period of time (in minutes).


Get Started

To see how the Record Locking form element actually functions, we should first create a form. Here are the steps for this process:

Steps To Import This Plugin

       1. Go to the website https://github.com/jogetoss/form-record-locking-form-element

       

       2. Go to the "Initial Release" page.


       3. Click on the .jar file to initiate the download (see figure 1).

         


       4. Go to your Joget Workflow localhost or server and login as admin.


       5. In Joget Console navigate to "Admin Bar>Systems Settings>Manage Plugins" and click the "Upload Plugins" button.


       6. In "Upload Plugin", select the plugin .jar file you just downloaded, then click "Upload".


       7. You should be able to view the newly installed plugin under the Installed Plugins tab.


       8. Remember to always uninstall the old plugin before uploading a new version.


The Joget Workflow Knowledge Base has more information on managing and developing plugins.

Steps to use the Plugin

  1. Start the Joget server and open the App Center.

  2. Login as admin and click on Design New App or click on existing application.



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



  4. Create New Form, fill up Form ID, Form Name and Table Name then click on Save button.



  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 4)



  6. Click the GENERATE APP button and generate a CRUD.



  7. After creating the CRUD, Launch the UI.



  8. Create a new record and save it.



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

           

       10. Observe the timer (reload the page to see the current time left for the record to be unlocked). After the Timer runs out, the 2nd account (Cat Grant) should be able to edit the record and save the new edit.

         

         


Form 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.

When 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








  • No labels