Administrator state override
- Robert Alexander Marshall
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 one of
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!
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 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 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.