Form interactions are actions you can add to a form to change how a field appears on a form block when it meets certain conditions. For example, you can set or clear an attribute on a field. You can also add aggregate fields to show a count of the fields or their value total.
You can also use form interactions on detail blocks. Additionally, you can set a form action to apply to new or updated records.
You can edit the field if you want to change how a field appears without meeting a specific condition. See our knowledge base article, Add a Form block.
Conditions
Conditions are particular circumstances when you want to apply an action to a field in a form. For example, you can hide a field for contractors or make fields read-only so users can see the information they need while completing a form, such as their holiday balance. They are like the start of an if-then statement. They can check against the properties of the trigger event and the properties of objects involved in the event. Conditions can check simple yes or no properties. They can also check for more complex properties against text or numbers. Don't add any conditions if you always want your action to apply. Instead, use the Edit field settings. See our knowledge base article, Add a Form block.
Actions
Actions are what you want to happen to the form field for your configured conditions. When adding actions, you can achieve different results through a complex combination of options.
Type of actions
You can use several types of actions. The main ones are to set or clear a field, and we also have actions to aggregate numeric data.
|
Set Attribute |
Sets the selected attribute values for the selected fields based on conditions satisfied, if any. |
|
Clear Attribute |
Clears the selected attribute values for the chosen field based on satisfied conditions. |
| Count Rows |
Counts the rows of the linked model and displays the value in the selected target field. Typically, you would use this in conjunction with the Set Rows action. |
| Sum Column |
Calculates the total value from the values of a selected field and displays the total value in your selected target field. Typically, you would use this in conjunction with the Set Rows action. |
| Average of Column | Calculates the average value from the values of a selected field and displays the total value in your selected target field. Typically, you would use this in conjunction with the Set Rows action. |
| Min of Column | You can find the lowest value from the values of a selected field and then display the minimum value in your selected target field. Typically, you would use this in conjunction with the Set Rows action. |
| Max of Column | You can find the highest value from the values of a selected field and display the maximum value in your selected target field. Typically, you would use this in conjunction with the Set Rows action. |
| Set Rows |
With the Set Rows action, you can map the value from the primary model property field to the linked model property field in the form. For example, when a user selects a date in a date range property on the primary model, "Time off dates," the action copies the selected date to the linked model property, "Daily breakdown - Daily date," in the form. You must save the form to save the value of the model's property. You must add a condition with the "is known" criteria for the primary model property field. For example:
|
Attributes
You can either set or clear an attribute.
|
Help text |
A rich text box appears to configure the help text you want to show. If the help text isn't correct, you can use the clear option to remove it. |
|
| Label | A text box appears to type in the new label for your form's field. If the field is "User" and you want to make it "User's name," you can either set a new label or use the clear option to remove the label entirely. |
|
| Required | A Value option makes the field mandatory or optional. |
|
| Enable | It shows a Value option for you to select to make the field changeable or clear it to disable it when the conditions are met. You can still see the field's value, but you can't amend this. |
|
| Value | Shows a field so you can either type in or select a value. For example, if the Target Field is a text field, you must type in a value. If it is a drop-down list, you need to select it from the list. If the field is a date, you need to choose a date. You can use the clear option to remove any value. |
|
| Visible | Shows a Value option. It shows the field when the option is selected, and the conditions are met. It hides the field when the option is cleared and the conditions are met. |
|
| Highlight weekends | Visually distinguishes weekends on the calendar by highlighting them, making it easier for users to identify Saturdays and Sundays. |
|
| Disable Weekends | Prevents users from selecting weekends on the calendar, restricting selectable dates to weekdays only. |
|
| Highlight public holidays | Marks the public holidays on the calendar with a distinctive highlight, helping users quickly recognize these special dates. |
|
| Disable public holidays | Prevents users from selecting public holidays on the calendar, ensuring that these dates cannot be chosen for scheduling purposes. |
|
| Holiday calendars | Integrates regional or organizational holiday calendars into the form, automatically recognizing and applying public holidays to the user's schedule. |
Same as shown in the above date picker images, highlights and disables dates in the Holiday calendar models.
|