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:
- Start the Joget Server and open the App Center.
- Log in as admin and click on the pencil icon on the Expenses Claim to open the App Composer. (see Figure 1)
Figure 1 - Click on Expense Claim Form and you will be directed to the Form Builder.
Click on the Expense Claim Details section to open up the Configure Subform properties.
- Take note in the Form field that is set to Expense Claim New form (see Figure 2)
Figure 2 - Click on Preview and notice that the first section displayed is the Expense Claim New Form.
Subform Properties
Configure Subform
| Name | Description |
|---|---|
| Label | Subform label. |
| 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. |
| Form | Form to be loaded as Subform. |
UI
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| 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 Data From | By 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 Data Store. |
| Store Data TO | By 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 Data Store . |