Last updated:
Subform
The Subform field lets you use forms within a form, nested potentially endlessly deep. Saved subform messages are shown in an overview inside the field.
Definition
Section titled “Definition”| Property | Value | Description |
|---|---|---|
| Form definition | A form definition | The form that can be edited, added to, or deleted from within the subform. |
| Immediate save | Boolean | Whether a subform message is saved to the server instantly, instead of only when the root form is saved (the default). |
Value linking
Section titled “Value linking”| Property | Value | Description |
|---|---|---|
| Links | Custom | Links field values between the current form and the subform: see below. |
| Update existing | Boolean | Whether existing forms and their already-filled subforms are re-evaluated when opening an existing form. |
Configuring a value link opens a popup with the root form’s bindable source fields on the left and the subform’s bindable target fields on the right: only fields of the same type can be bound to each other (for example a numeric MessageID can only bind to a numeric field). Select a source and target, confirm with the center icon, and the binding is added to the list at the top. Once bound, filling in a source field (say a Textbox with “Any2Info”) sets the same value on the linked subform field; with Update existing enabled, previously saved subform messages are re-evaluated with the new value too.
Navigation
Section titled “Navigation”| Property | Value | Description |
|---|---|---|
| Navigation | Boolean | Lets users navigate between subform messages without returning to the root form. |
| Background color | Color | Background color of the navigation header. |
| Font color | Color | Font color of the navigation header’s text. |
When enabled, viewing a subform message shows the total number of subform messages along with arrows to move to the next or previous one.
Appearance
Section titled “Appearance”| Property | Value | Description |
|---|---|---|
| Icon hidden | Boolean | Hides the “+” icon, preventing users from adding new subforms directly. |
Form overview
Section titled “Form overview”The subform’s form overview styling is copied 1:1 from the subform’s own form definition, including features like inline editing.