Introduction

SubForm is integral in completing a typical process flow. It enables one to show another form within a form, and it has no limit on the depth that it can show.

Get Started

The easiest way to see how the Subform works is to use the existing built-in App Expenses Claims. Here are the steps:

  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. (see Figure 1)


    Figure 1

  3. Click on Expense Claim Form  and you will be directed to the F orm Builder. 

  4. Hover the mouse over the Expense Claim Details section and click on Edit to open up the Edit Subform properties.

  5. Take note in the Form field that is set to Expense Claim New form. (see Figure 2)


    Figure 2

  6. Click on Preview and notice that the first section displayed is the Expense Claim New Form.

Subform Properties

Edit Subform

NameDescription
ID

Element ID.

Since the subform is not an input field, one may leave it as it is.

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

LabelSubform label.
FormForm to be loaded as Subform.

UI

NameDescription
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".

Display without frame?Decorator option. Removes default styling applied to SubForm when checked.

Data & Binder

NameDescription
Parent Field to keep Subform ID

The ID of the field in the parent form to store the SubForm table's primary key. SubForm data will be loaded based on the record ID retrieved from this field.

Subform Field to keep Parent ID

The ID of the field in the SubForm form to store the parent table's primary key.

Load BinderBy default, the Workflow Form Binder plugin is used for loading and storage of form data in the subform, you may override it with other plugins. See the list of available Form Binder.
Store BinderBy default, the Workflow Form Binder plugin is used for loading and storage of form data in the subform, you may override it with other plugins. See the list of available Form Binder .
  • No labels