› User interface › Forms › Form properties › Initialization and events

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.

  1. In the properties panel of the form, click Add for Initialization variables.

    The Add initialization variables dialog box is displayed.

  2. Select the form controls, form variables, and/or global variables.
  3. Click 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

  1. In the properties panel of the form, select the event for which to configure the action.

    The Event dialog box for the form appears.

  2. Click Add for actions.

    The Add form action dialog box is displayed.

  3. On the list of actions, select the required action. The selected action is added to the Selected items list.
    To add all actions, click Add all. To remove a selected action, click for the action. To remove all selected actions, click Remove all.

    You can filter on actions to make your search easy.

  4. Click Done.
    Once an action is used in an event, you can click on 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.
  5. 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.

  6. Click Save.

Create a new action for a form

  1. In the properties panel of the form, select the event for which to configure the action.

    The Event dialog box for the form appears.

  2. Click Create new action.

    The New action dialog box is displayed.

  3. On the Type list, select the action.
  4. Enter a Name for the action.
  5. Optional. Enter a Description for the action.
  6. Click Add. For more information on individual actions, see Action types.

    The action is automatically added to the Actions list.

  7. Click 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 click 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.