Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel2
maxLevel5
outlinefalse
excludeSee also
typeflat
separatorpipe
printablefalse

Overview

Workflow builder can be used to add an approval to a state or edit an existing approval in a state and manage the approval reviewer assignmentconfigure the process for the assignment of a reviewer.

Image RemovedImage Added

Select an existing approval in the state to edit the approval.

Image RemovedImage Added

Reviewers for the approval can be managed when adding or editing an approval in workflow builder by choosing one of the following options

Table of Contents
minLevel4
maxLevel4
outlinefalse
stylecircle
typelist
printablefalse

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.

Edit states using workflow builder

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "edit-state-wfb" and space = currentSpace ( )

Reviewers

Excerpt
namereviewers_wfbuilder_1

Reviewers for the approval can be managed when adding or editing an approval in workflow builder.

Image RemovedImage Added

There are three options to manage the reviewers for the approval.

Table of Contents
minLevel4
maxLevel4
outlinefalse
stylecircle
typelist
printablefalse

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

Table of Contents
minLevel5
maxLevel5
outlinefalse
stylecircle
typelist
printablefalse

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

Image Removed
Image Added

No option for manual assignment of a user as a reviewer using the workflow popup on the page

Image Removed

Image Added

Option for manual assignment of a user as a reviewer using the workflow popup on the page

Image Removed
Image Added

Reviewers preassigned by the workflow and set in the approval configuration

Image Removed
Image Added

Credentials required for each reviewer to enable the workflow popup Approve/Reject buttons


Anyone can approve

Image RemovedImage Added

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).

Image RemovedImage Added

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.

Image RemovedImage Added

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.

Image RemovedImage Added

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.

Image RemovedImage Added

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

Image RemovedImage Added

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.

Table of Contents
minLevel5
maxLevel5
outlinefalse
stylesquare
typelist
printablefalse
Users cannot be assigned through UI
Image RemovedImage Added
Info

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

Image RemovedImage Added
Info

Only one user approval decision is required to action the approval approved or rejected transition.

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.

Image RemovedImage Added
Info

The Invert option can be checked to exclude for each of Users that can review and Groups that can review to prevent these users from undertaking the 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.

Image RemovedImage Added

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.

Tip

You can use this option to exclude specific users from being a reviewer but allow any any other user with edit permission to undertake the approval by simply adding the list of users who you don’t want to undertake the approval to the Users that not allowed to review dialog box/

At least one user or user group must be added in one of the three dialog boxes in the workflow builder approval editor to Apply this setting for the approval.

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
Image RemovedImage Added
Info

Available as a Reviewers option when choosing to Limit who can approve and/or assign.

Allows one or more users to be manually assigned as a reviewer by another user using the workflow popup.

Image RemovedImage Added

Choose the + Add reviewer option to open the Assign dialog box.

Image RemovedImage Added
  • 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

Info

The Assign dialog box includes the current approval name in the title, for example, Assign for Review where Review is the name of the approval,

The assigned user avatar is added to the workflow popup.

Image RemovedImage Added
Info

Once at least one user has been assigned as a reviewer the approval is disabled for any other user.

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

Until a user is assigned as a reviewer, the approval can be undertaken by any user (with edit permission)

  • once a reviewer has been assigned, all other reviewers must be assigned to undertake the approval

  • additional users can be assigned to the approval until the transition occurs

  • an assigned reviewer can be unassigned if they have not undertaken an approval decision

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.

Image RemovedImage Added

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

Tip

Setting a value for Minimum approvals value will prevent a single initial approval decision from a user before any user is assigned causing an approval transition .

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.

Image RemovedImage Added

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

Image RemovedImage Added
Info

The Users can be assigned through UI setting for the approval can be applied without limiting the users/user groups who can be assigned as reviewers and/or limiting the users/user groups who can assign allowing any Confluence user to be manually assigned as a reviewer using the workflow popup by any Confluence user with view and edit permission for the page or blog post.

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

This setting requires that a user must be assigned to undertake the review using the workflow popup. The choice of assignees is limited to the users or members of the user groups added to the approval editor.

Image RemovedImage Added
Info

Available as a Reviewers option when choosing to Limit who can approve and/or assign.

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.

Image RemovedImage Added

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

Tip

Setting a value for Minimum approvals value will prevent a single initial approval decision from a user who has not been assigned causing an approval transition .

Only one user must be assigned to approve

Allows ONLY one user to be manually assigned as a reviewer by another user using the workflow popup. The single assigned reviewer decision will cause the workflow approval transition.

Image RemovedImage Added
Info

Available as a Reviewers option when choosing to Limit who can approve and/or assign.

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.

Image RemovedImage Added

The single user that must be assigned as the reviewer must be limited by adding users and/or user groups to the approval in the approval editor.

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

Image RemovedImage Added

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.

Image RemovedImage Added

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.

Image RemovedImage Added
Info

At least one user or one user group must added as reviewers.

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.

Image RemovedImage Added

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.

Note

Adding a Confluence user group with a large number of users and/or, a large number of individual users, may cause a ‘logjam’ in your document approval process as all users assigned will need to undertake and agree the approval.

Reviewer Credentials

Excerpt
namereviewercredentials

Each approval can be set to require user authentication

Open the Advanced dropdown options.

Image RemovedImage Added

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.

Image RemovedImage Added

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.

A global administrator can set the default credentials required for approvals in a workflow in the instance. Identity authentication can be

  • Confluence username and password

  • Confluence username and a signing token generated by a third-party app

Sticky assigned reviewers

Excerpt
namestickyreviewers

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.

Image RemovedImage Added

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.

Tip

If Remember reviewers is checked, will also assign the reviewers to other approvals with the same name in other states in the workflow.

Reviewer roles

Excerpt
namereviewerroles

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.

Image RemovedImage Added

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.

Image RemovedImage Added

Assignee roles are displayed as a lozenge in the workflow popup when the assignee views the page.

Image RemovedImage Added

Assignee role names once added are retained in the workflow and are available in a role dropdown menu when assigning users.

Image RemovedImage Added

Once a role has been added to a workflow in a space, the roles will be available to add when assigning users to an approval for all reviewer role-enabled approvals for each workflow in the space.

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

See also

Using Workflow Builder

Workflow Authoring Guide

Administration Guides