Administrator state override

Overview

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

Who are admin users?

To be a workflow admin, you must be either:

• Space Admin
• Confluence Admin
• 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 will be 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).

Add the following to the end of the page or blog post URL in the browser URL bar: ?admin=true

If the URL already contains a question mark, for example the "?pageid=" type of URLs, 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 popup, 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.

See also

Workflow Authoring Guide:

• Confused States - Grey Circle
• Roles and Permissions
• Transitions
• States

Space Admin:

• Initialize States

User Guide:

• State Status Indicator Circles