approve trigger action

Overview

You can use this action in a workflow trigger to approve a workflow approval. This action completes the approval, even if there are pending assigned reviewer decisions or a reviewer rejection decision.

cdmc_visualeditor_workflowtrigger_action_approve_useradded_optiontochooseapprovaldisplayed.png

The approve action requires that you specify a user. This user is logged in the document activity report as the approving reviewer.

By default, the approval action applies to the first named approval in the workflow state specified by the trigger event. Optionally, you can configure the approve action to target a different approval within the workflow.

When the workflow trigger event occurs, the trigger checks that any required conditions are met, and if met, the "approve" action approves a named approval.

`"approve"`

The trigger action "approve"sets an approved decision for a named approval if the provided parameters are valid.

action (approve)
- approval Name of the Approval to be approved. If not specified, the default approval^† is used
- user❗️ Atlassian userID of the approver

❗️ Mandatory parameter

user

The trigger action must define a value for the user parameter for the approve action to take place.

† Default approval

If no approval name is specified in the trigger action, the default approval is the approval in the state named in the trigger event condition.

If the state has multiple approvals, the default approval is the first approval listed in the state's JSON markup.

o

Example trigger code

"triggers":
[
	{"event": "on-change-state",
	"conditions":
	[
		{"final":true}
	],
	"actions":
	[
		{"action": "approve",
			"approval": "Sign-off",
			"user":"5d52a37ef0f22a0da2d6f070"}
	]}
]

The Atlassian user Identification Number (userId) is visible in the URL when viewing the User Profile.

You can add or edit a workflow trigger using the workflow visual editor. For the JSON code example above:

cdmc_visualeditor_workflowtrigger_statechnaged_final_approve_action.png

This includes the Approve action for the Sign-off approval.

cdmc_visualeditor_workflowtrigger_approve_action_sign-off_approval.png