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" from the URL bar and everything is back to normal.
