Base Form
- Last UpdatedJun 25, 2024
- 7 minute read
Use Base Form control to manage controls placed on the record (child controls) in your form.
You can place any number of controls on a record, and add and delete records for the control. At run-time, you can click Add Record to repeat a record, and click Delete Record to remove a record. You can view the values of the child controls in the Summary of the Base Form only when the Repeating property for the child controls is set to True, and the form is viewed on a small form factor mobile device.
Properties
The properties for the control are grouped under the following tabs:
Basic
|
Property |
Description |
|---|---|
|
Name |
Name that identifies the control. This value is also used for the label of the control. |
|
XML Node |
XML node mapped to the control. Use this value to map a list to a form and a form to a workflow. The default value is the value for the Name property without the spaces. Note: If you edit this value later, then it might affect the mapping between forms, lists, and workflows. |
|
Description |
Description for the control. |
Appearance
|
Property |
Description |
|---|---|
|
Visible |
Show or hide the control.
Note: If the value is No, then the child controls will be hidden even when the Visible property for the child controls is set to Yes. |
|
Label Position |
Position of the label for the child control.
Note: |
|
Label-Control Area |
Area occupied by the label and the control in percentage.
Note: |
|
Width |
Width in pixels for the control. The default value is 0. Note: If the value is 0, then the width of the control is set as per the default values. |
|
Height |
Height in pixels for the control. The default value is 0. Note: If the value is 0, then the height of the control is set as per the default values. |
|
Retain Space |
Reserve or remove space when the control is hidden.
|
|
Display Mode |
Show or hide the tabular view for the control.
|
|
Show Column Name |
Show or hide the column name, when the Display Mode is set to Grid.
|
|
Records Caption |
Suffix for the add and delete links. The default suffix is Record. Note: The suffix is limited to 50 characters. |
|
Record Position |
Position of the records added at run-time for the control.
|
|
Image Path |
Path to the image for the control. The image path is specified as:
Note: |
|
Adapt UI |
Change the user interface of the control based on the display width.
Note: The responsiveness of the container depends on the value set for the Desktop View Only property at the Form level. |
Validation
|
Property |
Description |
|---|---|
|
Show Confirmation Message |
Show or hide the confirmation message for the control.
|
|
Confirmation Message Text |
Confirmation message for the control. Note: This property is applicable only when the Show Confirmation Message property is set to Yes. |
|
Repeating |
Allow or deny a user to repeat records for the control.
|
|
Minimum Records |
Minimum records for the control. The default value is 0. Note: This property is applicable only when the Repeating property is set to True. |
|
Maximum Records |
Maximum records for the control. Enter 0 for infinite records. The default value is 0. Note: This property is applicable only when the Repeating property is set to True. |
Advanced
|
Property |
Description |
|---|---|
|
On Record Add |
Run a script when a record is added. For more information, see scripting guidelines for On Record Add property. |
|
On Record Delete |
Run a script when a record is deleted. For more information, see scripting guidelines for On Record Delete property. |
|
ID |
Reference identification code for the control. This value is automatically generated and cannot be changed. |
|
Behavior |
Manage records and edit values at run-time.
|
|
Default Number of Record |
Number of records added at run-time for the control. The default value is 1. |
|
Fast Append |
Add records in the Grid view at run-time by pressing the Tab key from the last focused control of the record.
Note: |
Scripts
For information about using scripts, see scripting guidelines for Base Form control.
Note:
- Description of controls placed on Base Form with Display Mode set as Grid is not displayed.
- Name set through scripts for controls placed on Base Form with Display Mode set as Grid is not displayed.
- Label of controls placed on Base Form is truncated if there are too many controls or if the label is too long.
- When a Base Form with the Default Number of Records set in a form, associated to a workflow with an Invoke Form activity to the same form, is used in Fill Form, and if all records for the Base Form are deleted while submitting the Fill Form, then, in the Invoke Form activity, the Base Form will continue to display the Default Number of Records.
- Adding records in Base Form is not supported for Chart, Slider and Hierarchical List controls.