Submit Action Set

Overview

The Submit action set is a series of actions in Commerce that are essentially sub-actions of Submit. The Submit action set is comprised of Submit, Request Approval, Approve, Reject, and Revise.

Name Variable Name Action Type Description

Initiate Approval

submit_t

Submit

Submits the transaction for approval. If no approvals are defined or triggered for the transaction, the status will move directly to the approved step.

Request Approval

request_approval_submit_t

Request for Approval

This action is performed when submit action is clicked and there is at least one reason to approve.

Reject

reject_submit_t

Reject

This action is performed when a reason is rejected by the approver.

Approve

approve_submit_t

Approve

This action is performed when a reason is approved by the approver.

Cancel Approvals

revise_submit_t

Revise

This action is performed when Revise button is clicked.

ClosedWhen does the Submit action run?

When the Submit button is clicked, the Submit action and its associated modifications do not necessarily run.

After Submit is clicked:

  1. The quote passes through the approval tree defined on the Submit action. If any of them return true, the Request Approval action will be performed first.
  2. Approvers receive notifications and the Approve and Reject actions are available to them until they have performed either action, at which time the actions will no longer be visible to them.
  3. When the quote has received its final approval, or if no approvals are required, the Submit action and its associated modifications run.

Plan your status modifications, step transitions, and integrations accordingly!

ClosedSubmit Action Set Behavior

Administration

ClosedCreating the Submit Action Set

  1. Navigate to the Admin home page.
  2. Click Process Definition in the Commerce and Documents section.
  3. Click on the applicable Commerce process.
  4. Select Actions from the Navigation drop-down for the main document, and then click List.
  5. Click Add at the bottom of the Actions List page.
  6. Enter a Label.
  7. Enter a unique Variable Name.

    The Variable Name field populates automatically. Variable names can only contain alpha-numeric characters and underscores. The entry can be changed before saving, but after saving the value is read-only.

  8. Select Submit from the Action Type drop-down.
  9. Click Add to save changes, or click Cancel to return to Action List without saving changes.

Notes:

  • When you create a Submit type action, a Submit type action with four sub-actions (Request Approval, Reject, Revise and Approve) are added.
    The Submit type action and each of the sub-actions can all be edited.
    • Edit the parent Submit type action to Edit Approvals and view associated submit attributes.
    • Edit the Request Approval type action to enable Auto Submit. If the Auto-Submit option is enabled, then all Quotes must go through the approval process.
    • Edit the Revise type action to manage Reset Reasons
  • If a custom Submit action is deleted, all associated actions and attributes are also deleted. The Standard Process Submit action cannot be deleted.

ClosedRevising a Sub-Action (Reset Reasons)

Resetting of reasons is typically used when a quote is required to step through the entire Approval Sequence, or portions of the sequence, even if some of the Approvals have already been received. An approval reason has 4 statuses: Approved, Rejected, Pending or Ignored.

ClosedResetting & Approval Statuses

  1. Navigate to the Admin home page.
  2. Click Process Definition in the Commerce and Documents section.
  3. Click on the applicable Commerce process.
  4. Select Actions from the Navigation drop-down for the main document, and then click List.
  5. Open a Revise type action.
  6. Click the Reset Reasons tab.
  7. Select one of the following: 
    • Simple Reset (All Reasons): If this option is selected, the reason will be reset.
      The default setting is for no reasons to be reset.

    • Define Advanced Reset: Select this option and click Define Function. Write an advanced function that will return the reasons that should be reset. The return format can be an array or delimited string of the reason variable names.

    Notes:

    • If the desired outcome is that the quote only needs an Approval once, regardless of changes or revisions, then the Reason or Reasons should not reset.

    • The Revise sub-action cannot activate reasons or submit the Transaction. Revise will always perform only its own Step transition and all active approval nodes will always be deactivated.
    • Approval workflow cannot be resumed until the request for approval action is performed again.

Notes

  • When setting transitions, try to use just one pending approval Step. Adding multiple Steps increases complexity. Instead, use a variety of participant profiles.
  • Keep both the parent Submit action advanced modification and the sub-action "Submit for approval" advanced modification equivalent.

Related Topics

Related Topics Link IconSee Also