Edit approval reviewers using workflow builder
Overview
Workflow builder can be used to add an approval to a state or edit an existing approval in a state and configure the process for the assignment of a reviewer.
Select an existing approval in the state to edit the approval.
Reviewers for the approval can be managed when adding or editing an approval in workflow builder by choosing one of the following options
Once one of the above Reviewers options is chosen, it can be configured in a number of ways. These are different for each option.
The Advanced dropdown also includes options to
require reviewer Credentials for a user to enable the approval buttons in the workflow popup
use Sticky assigned reviewers to reassign previous users as reviewers if the workflow returns to the current state
check the Enable Roles for reviewers option allows an assigning user to add a role descriptor for a reviewer when using the workflow popup to assign a reviewer
Assignment of user as reviewers are configured for each individual approval.
Reviewers
Reviewers for the approval can be managed when adding or editing an approval in workflow builder.
There are three options to manage the reviewers for the approval.
In the Edit approval/Add approval panel the Reviewers for the approval, by default, are set so that Anyone can approve if the user has view and edit permission for the page or blog post.
If you choose to configure the approval to Limit who can approve and/or assign you can use the following options
Workflow builder approval icon and reviewer assignment
The display of the approval in workflow builder is appended with an icon to indicate the overall reviewer assignment process.
Approval icon in workflow builder | Approval reviewer assignment |
|---|---|
No option for manual assignment of a user as a reviewer using the workflow popup on the page | |
| Option for manual assignment of a user as a reviewer using the workflow popup on the page |
Reviewers preassigned by the workflow and set in the approval configuration | |
Credentials required for each reviewer to enable the workflow popup Approve/Reject buttons |
Anyone can approve
Allows any user with view and edit permission for the content to undertake the approval decision using the workflow popup.
One user decision using the workflow popup Approve or Reject button will cause the workflow to transition to the destination state (if the approved/rejected transition is configured for the state).
Anyone can approve can be configured to require more than one reviewer decision before a transition can take place by setting the number of reviewer decisions in workflow builder by adding a value for Minimum approvals.
This sets a requirement for the set number of reviewers to undertake the approval AND agree for the approval transition to occur.
Empty reviewer avatars for the set number of required reviewers are added to the workflow popup on transition into the state.
Each user avatar and their review decision is added to workflow popup until the minimum number of reviews have been made and the transition occurs.
A reviewer who has already undertaken an approval decision can change their decision if the transition has not yet occurred.
Limit who can approve and/or assign reviewers
The approval can be configured to limit the users who undertake the approval and/or assign users as reviewers depending on your needs for the approval process in the workflow state.
Choosing the Limit who can approve and/or assign reviewers option displays the following options to manage limiting reviewers who an approve or users who assign reviewers.
Users cannot be assigned through UI
Available as a Reviewers option when choosing to Limit who can approve and/or assign.
Prevents any user from undertaking the approval unless the user is added as a reviewer in the approval configuration.
This option can be used to add users who can undertake the approval by adding either/both
a list of one or more Confluence users as Users that can review
a list of one or more Confluence user groups as Groups that can review
This setting includes the Users that are not allowed to review option. Add one or more users to these named users from undertaking the approval. This useful if you need to exclude a user who is a member of a Confluence user group added as a Group that can review.
In the example above the users who act as a reviewer are
two listed users - matilde enios and suni conn
users who are members of the Confluence user group controlled_documents_approvers
The approval buttons will be enabled in the workflow popup for these users when viewing the page or blogpost in the approval state.
The approval buttons will be disabled for all other users, including any user not allowed to review.
One user cannot act as a reviewer - Rab Appfire - even if they are a member of the added user group or added to the list of users who can review.
This option is similar to Anyone can approve - one user decision will action the workflow approval transition but this one reviewer can only be a user from the list of users or a member of the Confluence user group added to the approval editor in workflow builder.
The Users cannot be assigned through UI option can also be configured to require more than one reviewer decision before a transition can take place by setting the number of reviewer decisions in workflow builder by adding a value for Minimum approvals.
Users can be assigned through UI
Allows one or more users to be manually assigned as a reviewer by another user using the workflow popup.
Choose the + Add reviewer option to open the Assign dialog box.
use the search box to find a user
check the box for the searched user (and if required add a helpful comment for the reviewer)
choose Assign
The assigned user avatar is added to the workflow popup.
Any comment added when assigning the user is
included in a workflow notification to the assigned user
displayed in the approval pending entry in the user profile document actions report
The users that can be assigned as reviewers and the users that can assign reviewers can be limited by adding users and/or user groups to the approval.
You can also
use the Invert option to exclude users and/or user group members from being assigned as a reviewer
use the Invert option to exclude users and/or user group members from assigning a user as a reviewer
add one or usernames to the Users that are not allowed to review option to exclude these users from undertaking the approval
set a Minimum approvals value to require this number of reviewers to undertake and agree the approval before the approval transition can take place
For example, an approval configured to allow users to be assigned using the workflow popup and with a requirement for three reviewers to undertake the approval and agree can be undertaken by an unassigned reviewer.
The approval decision for the transition requires three reviewers to agree
the initial decision is displayed in the workflow popup but there is no transition
all further reviewers must first be assigned
One or more users and/or user groups can be added to the approval editor to limit the users who can be assigned as reviewers.
Users must be assigned to approve
Allows one or more users to be manually assigned as a reviewer by another user using the workflow popup.
The approval can only be saved with this reviewer configuration if at least one user/user group is added to the One or more reviewers must be assigned from this list option.
You can also
add one or usernames to the Users that are not allowed to review options to exclude these users from undertaking the approval
add Users who can assign reviewers or Groups who can assign reviewers
check the Invert option to exclude users and/or user group members who can assign reviewers
set a Minimum approvals value to require this number of reviewers to undertake and agree the approval before the approval transition can take place
Only one user must be assigned to approve
The approval on the page or blog post
is disabled in the workflow popup until a single user is assigned as the reviewer
once a single user is assigned no other users can be assigned as a reviewer
the assigned reviewer can be unassigned if they have not yet undertaken the approval decision
The approval can only be saved with this reviewer configuration if at least one user/user group is added to the Only one reviewer must be assigned from this list option.
You can also
add one or usernames to the Users that are not allowed to review options to exclude these users from undertaking the approval
add Users who can assign reviewers or Groups who can assign reviewers
check the Invert option to exclude users and/or user group members who can assign reviewers
Set all the reviewers that have to approve
The Set the reviewers that have to approve option
automatically assigns set users and/or members of set Confluence user groups as reviewers and
requires all the assigned reviewers undertake and agree the approval for an approval transition to occur
On selecting, options are displayed to add the users and/or user groups who must approve.
Add users and/or user groups for the workflow to Automatically assign users and/or Automatically assign groups as reviewers on transition into the approval state.
Users added as reviewers are assigned as reviewers for the approval on the transition into the workflow approval state. The avatars for these users are added to the workflow popup.
The approval is disabled for all other users - users not listed or not members of the groups listed are automatically excluded from undertaking the approval.
Reviewer Credentials
Each approval can be set to require user authentication
Open the Advanced dropdown options.
User authentication (or e-signature) for reviewer can be set to require either:
a password
a username and password
Users will see the credentials prompt in the workflow popup if identity authentication is required for the reviewer.
The Approve and Reject buttons in the workflow popup will be disabled until the user credentials are added. The credentials are validated when an approval decision is made by the user.
Sticky assigned reviewers
The reviewers assigned to an approval can be stored and automatically assigned to the next occurrence of the current approval.
Check the Remember reviewers option.
Any reviewers who undertook the approval in the current state will be automatically assigned to the named approval if the workflow returns to this state.
Reviewer roles
You can also enable for the approval the option for reviewers to be given a reviewer role when they are assigned in the workflow popup.
Check the Enable roles option.
The option to add a reviewer role is then displayed in the workflow popup after a user is selected to be assigned to the approval.
Assignee roles are displayed as a lozenge in the workflow popup when the assignee views the page.
Assignee role names once added are retained in the workflow and are available in a role dropdown menu when assigning users.
Saving changes to an approval
To amend changes to a state approval, choose Apply.
To avoid the loss of a state update to the workflow you must then
add the changes to the workflow by choosing Save in the Navigation panel
add the updated workflow to the content by selecting Exit in the Navigation panel