Administrator state override

Overview

This example shows how a workflow administrator can override the workflow state on a page or blog post.

Who are the workflow administrator users?

To be a workflow admin user, you must be one of:

Space administrator
Confluence administrator
Defined as a workflow adminusers – see below

Defining adminusers

For any workflow, additional admins can be defined by using the adminusers parameter on the workflow macro.

{workflow:name=Test|adminusers=janedoe,johndoe}
   {state:Can't change|hideselection=true}
   {state}
   {state:Normally unavailable}
   {state}
{workflow}

In the example above, users janedoe and johndoe are considered adminusers for that particular workflow.

State override

If you apply the workflow above, you'll see that it's not possible to transition from the Can't change state because of the hideselection=true parameter.

However, administrators can enter a special mode that allows them to transition to any state in the workflow

This is particularly useful when developing and testing workflows!

In the browser URL bar, add the following to the end of the page or blog post URL: ?admin=true.

If the URL already contains a question mark, for example, the "?pageid=" type of URL, you'll have to use this instead: &admin=true.

For example, if the URL was something like

https://confluence.yourcompany.com/display/SPACEKEY/Some+Page

You'd change it to

https://confluence.yourcompany.com/display/SPACEKEY/Some+Page?admin=true

But if it was something like this

https://confluence.yourcompany.com/pages/viewpage.action?pageId=29263912

You'd change it to

https://confluence.yourcompany.com/pages/viewpage.action?pageId=29263912&admin=true

Now, when you open the workflow state dialog box, you'll see options to transition to any state, including any that would otherwise be unavailable.

Once you're done, just remove the "?admin=true" or "&admin=true" from the URL bar, and everything is back to normal.

Administrator state override

Overview

Who are the workflow administrator users?

Defining adminusers

State override

See also