Joget DX Available for Download

Check out Joget DX, the next generation successor to Joget Workflow for faster, simpler digital transformation.

Skip to end of metadata
Go to start of metadata

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:

StepsScreen (Click to view)
  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)

  3. Click on  Expense Claim Form and you will be directed to the  Form 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)


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

Figure 1


Figure 2



Subform Properties

Edit Subform

NameDescriptionScreen (Click to view)
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

NameDescriptionScreen (Click to view)
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

NameDescriptionScreen (Click to view)
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