Skip to main content

Submit Action

Description​

Use the Submit Action activity to complete and return a result for an App action or task in an Action Center workflow.

This activity becomes available when you select Define workflow file in the Events tab of a control in your Action app.

The Submit Action activity works as follows:

  1. The activity submits the outcome of an Action Center task to the parent process that created the task using the Create App Task activity.

  2. That same process waits for the outcome using the Wait for App Task and Resume activity.

  3. Once the outcome is submitted, the parent process resumes from where it left off. For more information on App tasks, refer to Working with App tasks.

    docs image

Properties​

  • Outcome: The outcomes of the user action, defined in the action schema. Examples for user action outcomes are the following:
    • Approve: You can approve a submitted form.
    • Reject: You can reject an invoice after review.
  • Properties override: You can override output and input/output properties defined in the action schema when submitting the task.

To override a property, follow these steps:

  1. Select Add Properties Override in the activity. The user-specified action properties defined in the action schema are displayed.

  2. Select the property you want to override.

    note

    You can override only output and input/output properties.

  3. Select Update Fields.

    Figure 1. Add Properties Override dialog

    Add Properties Override dialog

  4. Bind the property to the value of an app input control.

Use the following expression to bind app control values to action properties: <Controls>.<MainPageName>.<InputControlName>.value

For example, to override a property like Reviewer Comment with the value from a comment field in the app, use: Controls.SimpleApproval.ReviewerComment.Value.

   :::important
   * If you rename a property after adding it to the
   override list, the override is removed. You must re-add it using **Add Properties Override**.
   * The **Submit Action** activity returns
   default values for all output or input/output properties that are not overridden.
   :::

Figure 2. Example of overriding an action schema property with the Submit Action activity

Example of overriding an action schema property with the Submit Action activity