Versions Compared

Key

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

Table of Contents

Introduction


English

The section is the placeholder to hold Form Elements.

Each section has one column in it by default.


Get Started

To see how Section works, the default bundled Expenses Claims app will be used for this example.

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

  2. Log in as  admin and click on the pencil icon on the  Expenses Claim   to open the  Design App . Composer (see Figure 1).
    Image Removed
    Image Added
    Figure 1

  3. Click onExpense Claim New and you will be directed to the  Form Builder. 

  4. Hover the mouse on Click on the Section element and click on it to open the Edit Configure Section properties.

  5. To add a new section, click on the plus icon below the section (Figure 2)Image Removed


Image Added

Figure 2

Section Properties

...

Configure Section

Image RemovedImage Added

field when readonly
NameDescription
Label

Section label.

ID

Element ID.

Since the section is not an input field, it is optional to change this.

Please see Form Element for more information about defining the ID and list of reserved IDs.

LabelSection label

.

Readonly

Determines if the element is editable.

Display Field as Label When Readonly?Displays the value of the element as plain text when an element is set to "Readonly".

Data

...

NameDescription
Load BinderData From

Optional by default. When it is not set, it will use the parent's binderdata store. You may override this behavior by using its own designated binder data store by defining it.

Store Binder

Available options:

  • Beanshell
  • Database SQL Query
  • Database Wizard
  • Default
  • Directory
  • JSON API
  • Parent Form Data Store
Save Data To

Optional by default. When it is not set, it will use the parent's binderdata store. You may override this behavior by using its own designated binder data store by defining it.

Available options:

  • Beanshell
  • Database SQL Query
  • Database Wizard
  • Default
  • Directory
  • JSON API
  • Multi Store data stores
  • Parent Form Data Store

Advanced Options

Visibility

...

There are several feature enhancements for Joget DX version 8.1 onward. It is explained below.


Info
titleVisibility feature enhancement for 8.1 and above

  This applies to Joget DX version 8.1 onwards

  • Improve the UI to add parentheses/grouping in the visibility control rule.
  • Support more Operators/Operation


Tip

Download this app to see this new feature in action :  APP_kb_dx8_testSection.jwa.


Image Added

NameDescription
Visibility Control Rules
Sub-elementDescription
Join Type

Image Added
Available options:

  • AND
  • OR
Reverse Value
Image Added
Equivalent of a NOT operator.
Field ID

Image Added
The field ID of a form element to control the visibility of this section.

Info
titleLookup Into Subform Field

You can look up into a subform field value to control visibility on your current (parent) form.

Code Block
titleExample
subformId.status

...

iconfalse


Operators/Operation

Image Added

  • Equal To : Field value and compare value are equal. Compare for both string and number.
  • Greater Than : Field value is greater than compare value. Compare for both string and number.
  • Greater Than Or Equal To : Field value is greater than or equal to compare value. Compare for both string and number.
  • Less Than : Field value is less than compare value. Compare for both string and number.
  • Less Than Or Equal To : Field value is less than or equal to compare value. Compare for both string and number.
  • Is True : Field value is true or 1
  • Is False : Field value is false or 0
  • Contains : Field value is containing a compare value as substring
  • List Contains : Field value is a semicolon delimited string which contains compare value as 1 of the delimited value.
  • In : Field value is one of the value of semicolon delimited string in compare value.
  • Regex Match : Field value is matching the regex in compare value.

 

Field Value

Image Added
Show the visibility of this section, when this field value is present in the field ID defined above.




Info

 This applies to Joget DX version 8.0.12 and before.

Image Added


NameDescription
Visibility Control Rules
Sub-elementDescription
Join Type

Available options:

  • AND
  • OR
Reverse ValueEquivalent of a NOT operator.
Field ID

The field ID of a form element to control the visibility of this section.

Info
titleLookup Into Subform Field

You can look up into a subform field value to control visibility on your current (parent) form.

Code Block
titleExample
subformId.status
Tip

The Field

...

ID supports the use of parenthesis ( ), to group multiple conditions.

To see this in action, try out this sample app here: APP_booleanTest-sample.jwa

Field Value

Show the visibility of this section, when this field value is present in the field ID defined above.

Code Block
titleExample using Regular Expression
Approved1|Approved2|Approved3
Using Regular Expressions?In "Field Value", you can use Regular Expression.

Permission

NameDescription
Permission

Manage the permission on who to see this section. See Permission Control.

Available options:

  • BeanShell
  • Controlled By Manage Permission Menu
  • Department
  • Group
  • Is Admin
  • Is Anonymous
  • Logged In User
  • Multi Permissions
  • Organization
  • Plugin Template - Permission
  • User
Show as Readonly When No PermissionShow as readonly when no permission?

Displays the value of the element as plain text when a user's permission is denied.

...

APP_booleanTest-sample.jwa
APP_kb_dx8_testSection.jwa.