› User interface › Forms › Form events and actions › Form actions › Composite action

Composite action

Use a Composite action to execute multiple actions from within one action.

You can use a Composite action on multiple controls.

  • You can duplicate an action within a composite action.
  • You can add a composite action within another action. But you cannot add a composite action to itself.

  1. On the form modeling bar, click Actions and click New.

    The New action dialog box is displayed.

  2. On the Type list, select Composite.
  3. Change the default Name (Composite1) to something meaningful.
  4. Optional. Enter a Description for the action.
  5. To add actions, click Add for Actions.
    The Add form action dialog box is displayed.
  6. Select the required actions and click Done.
    The selected actions appear in the Actions box.
  7. Use to set the order in which the actions must be executed.
  8. Click Add.

    The newly created action appears on the Actions page.

  9. Associate the action with the control to trigger this action. See Configure actions for form control events. Alternatively, to call this action for a form event, associate the action with the form. See Associate an action with a form.

    When this action is triggered, all enabled actions within it are executed in the specified order.

Create Composite action within an event

You can select multiple actions within an event and create a Composite action; this allows for reusing the actions within an event.

  • This option is enabled only when you select actions in a consecutive order.

  • This option is not applicable for Capture actions.

The following scenario illustrates saving actions as a "Composite action" within an event.
  1. Create a standard form. See Create a form.
  2. Add a Button control to the form.
  3. On the Events tab, click the Clicked event.

    The Event dialog box is displayed.

  4. Select the actions you want as a composite action. Press Ctrl+click to select multiple actions.
  5. Click Create composite action.

    The New action dialog box is displayed with the selected actions in the correct order. By default, the "Action type" is set to Composite, and "Name" is set to Composite 1.

    You can reuse this Composite action in other form events which uses the same logical sequence of actions. You can change the name and description; however, you cannot change the order of actions.

  6. Save the action.

    The action is saved and listed as Composite action on the Actions list page.

See also: