Conditions
Overview
Conditions allow you to specify additional prerequisite requirements for Triggers and some Transitions.
They are a set of optional parameters that can be added to the macros (listed below) to impose additional limits on when the macro is active.
In addition, due to support for Value References, you can even create custom conditions by comparing metadata values.
Basic example
{workflow:name=Conditions}
{state:Editing|approved=Done|rejected=Editing}
{approval:Review|group=confluence-administrators|assignable=true}
{state}
{state:Done|final=true|updated=Editing}
{state}
{workflow}
In the example above, only a user who is a member of the confluence-administrators group can review the content.
Compatible Macros
If a macro has a parameter with the same name as a condition, the parameter as defined in the macro takes precedence. For example, |
Conditions
Condition | Value | Notes | Ver |
---|---|---|---|
A specific value. This must be a valid datatype for the value reference.
| Does the value of a value reference match the specified value? For example, Conditions using value references can also be set when using a third-party app: |
| |
If used in a trigger macro that's listening for the | |||
One invalid parameter in a list of users in a condition disables the transition for the other listed users. The non-existent parameter value is a blocker for an approval or a state-selection transition. | |||
| A comma-separated list of group names
| Is the current user a member of one or more of the specified groups? |
|
When applied to the approval macro, it is a parameter of the approval macro - it is not used as a condition. For example, you can prefix the list (not items in the list) with | |||
| Name of an approval | Has an |
|
When applied to an approval macro in a state with multiple | |||
| A comma-separated list of content labels. | Does the content have one or more of the labels specified? |
|
|
| Is this action only for the initial occurrence of the named state for the content?
|
|
The use of The primary use of the | |||
| Title of required ancestor page.
| Does the current page have a parent or ancestor page of the specified page title? |
|
|
| Is this page set as the space home page? Filter by labelThere are no items with the selected labels at this time. See also: How to set space home page |
|
|
| Did the content editor uncheck the "Notify watchers" checkbox (indicating a "minor change") before updating the content? The |
|
This condition can only be used in a trigger macro when listening to either the | |||
|
| Is the page an orphan (no parent page)? |