Initialization and events
You can add initialization variables to the form and configure actions for the form events.
Initialization variables
Add initialization variables (variables or fields) that must be populated when the form is first run.
-
In the properties panel of the form, select
Add for
Initialization variables.
The Add initialization variables dialog box is displayed.
- Select the form controls, form variables, and/or global variables.
- Select Done.
Events
A form includes the following events:
-
Loaded
-
Before render
-
After render
You can either add an existing action or create a new action for a form event.
Associate an existing action to a form
-
In the properties panel of the form, select the event for which to configure the action.
The Event dialog box for the form appears.
-
Select
Add for actions.
The Add form action dialog box is displayed.
-
On the list of actions, select the required action. The selected action is added to the
Selected items list.
To add all actions, select Add all. To remove a selected action, select for the action. To remove all selected actions, select Remove all.You can filter on actions to make your search easy.
-
Select
Done.
Once an action is used in an event, you can select the action from within the event to open the action details and edit the action directly from the event without having to go back to the list of actions.
-
To set the order of the actions use
.
To move multiple actions in an event, use Ctrl+click. This is useful while moving the actions between Begin and Else conditions. The actions you want to move must be in a block.
- Select Save.
Create a new action for a form
-
In the properties panel of the form, select the event for which to configure the action.
The Event dialog box for the form appears.
-
Select
Create new action.
The New action dialog box is displayed.
- On the Type list, select the action.
- Enter a Name for the action.
- Optional. Enter a Description for the action.
-
Select
Add. For more information on individual actions, see
Action
types.
The action is automatically added to the Actions list.
-
Select
Save.
The action is associated with the form event.
Error on load
You can specify where the form should be redirected to if a form fails to load at runtime. Available options are:
-
Origin: Redirects back to the original page where the current page was launched.
-
Form: Redirects to the selected form.
At runtime, if a form fails to load, an error message appears. When you select OK, you are redirected to the configured form (origin or specific form), and the form loads in the same window.
If "Redirect confirmation" is selected in the Settings tab, the system redirects you to the error form without having to confirm leaving the page.
Action menus
Define action menus on a touch-enhanced Phone or Tablet form to display a list of options.