Versions Compared

Key

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

...


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

          Image Added

          Image Removed Figure 1


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

...

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 (See Figure 2).

Image 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).

Image Added

...

Figure 3

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

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 Added

...

Figure 5


6. Click

...

the GENERATE APP button and generate a CRUD (See Figure 6).

Image Added

...

Figure 6


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

...



Image Added

Figure 7

   

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

Image Added

...

Figure 8


   9. Login to the application as another user (example :-

...

username:

...

cat   password: password), navigate to the newly created record and click edit (See Figure 9).

          Image Removed 

Image Added 

Figure 9 


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

Image Added

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).          Image Removed          Image Removed

Image Added

Figure 11

Form Record Locking Form Element Properties

Image Added

Figure 12 : Record Locking Form Element PropertiesImage Removed

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.