set-state macro
Overview
The {set-state} macro is used to immediately transition to a designated state – either on the current page, parent page or child pages – regardless of how transition to that state would normally occur.
Where to use it?
Optional.
One {set-state} macro can be put in a {trigger} macro.
Parameters
Parameter | Required | Default | Notes | Ver |
|---|---|---|---|---|
unnamed first parameter | The state to transition to. Note: It must be defined in the workflow. | |||
| Comment to associate with the state change:
| |||
| current page | If specified, the state will be changed on the parent page or child pages, not the current page:
Obviously, this parameter only works on pages, not blog posts. |
The set-state macro will not work if the page is using also using the K15t Scroll Versions app.
Events
The following Events are associated with state transitions:
statechangedpagestatechangednewsstatechanged
Example
In this example, entering state B causes an immediate transition to state C.
{workflow:Instant transition}
{state:A|submit=B}
{state}
{state:B}
{state}
{state:C}
{state}
{trigger:statechanged|state=B}
{set-state:C}
{trigger}
{workflow}All examples
-
How can I fast-track a single rejection or a single approval decision — How to require everyone to approve, but only need one person to reject
-
-
-
Stiltsoft Handy Status Macro for Confluence — A user changes the Stiltsoft Handy Status macro value for a page, and this automatically changes the Comala Document Management applied workflow state.
-
-
Use attachment events in workflow triggers — Triggering events when attachments are created, updated, or removed.
See also
Need support? Create a request with our support team.