Skip to main content

Submit Form step

Choose when to submit a form, save changes, or act on an approval task, and verify what the action changed.

Add Submit Form to a form action to submit or save the current record, or act on an approval task. For example, a Reject request button can require a reason before it rejects the task.

Note

Submit Form is available in list forms, approval forms, and public forms. The step is unavailable in dashboards.


When to Use Submit Form Step

Use this step when a button needs to submit or save a form after validating input, setting a value, or getting confirmation. In an approval form, use it for custom actions such as approving, rejecting, or forwarding a task.

Use Cases


Configure Submit Form Step

In the form designer, open Actions. Select or create a form action, then add the Submit Form step. Choose the submit type for the form and the intended outcome.

1. Execution Condition

Set Execution Condition when the step should run only after the user confirms or provides a required value. Select Continue next step when condition is not met only if the remaining steps can run independently of submission. Execution Condition of actions

2. Submit Type - Approval form

Choose one of the five approval form modes. For an action triggered outside the task panel, use Task settings to specify inputs such as the comment or recipient.

2.1 Form Submit / Task Approve / Task Complete

Submit the form, approve the task, or complete the task as applicable. For a custom button, open the expression editor next to Task Comment if the action needs to record a value from the form. Run the action on a test task with the intended role and check the task status and history.

2.2 Save Changes

Save the edits on the current form. Choose Ignore form validation or Close this form after submitted if the form design calls for it. Reopen the same record and verify the edited field. In an approval task, check the status separately.

2.3 Reject

Reject the task. For an action outside the task panel, use the Task Comment expression in Task settings. The mode offers Ignore form validation. If a rejection reason is required, check for it in the execution condition. Test an empty reason, then test a supplied reason and check the status and task history.

2.4 Task Forward

For a trigger outside the task panel, set Forward to and Remark in Task settings. Select Disable default email notification if the action should skip the default email. Verify the assigned recipient and remark on a test task.

2.5 Add Task Assignee

For a trigger outside the task panel, set Assignee and Remark in Task settings. Choose Disable default email notification if needed. Verify that the intended assignee and remark appear on the test task.


3. Submit Type - List form

List form Submit Form settings showing the four submit types and the validation and closing options for Save changes.

  • Form submit. Submit the data in the current form. Use a test value and reopen the submitted record to verify it.

  • Save changes. Save the edits. Select Ignore form validation or Close this form after submitted if appropriate. Reopen the record to verify the saved fields.

  • Cancel changes. Discard unsaved edits. Select Close this form after submitted if appropriate. Reopen the record to verify it still shows the last saved value.

  • Delete this item. Delete the current record. Use Show confirm dialog before deletion if users should confirm deletion. On a disposable test record, cancel once and confirm once. Check the list after each attempt.

Note

Public forms do not show a separate Submit type selector. Submit test data and check the expected record.

Did this answer your question?