Welcome > 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.

    Note You can filter on actions to make your search easy.

  4. To remove a selected action, click for the action. To remove all selected actions, click Remove all.
  5. 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.

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 Action dialog box is displayed.

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

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.

Note 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.