...
...
...
...
...
...
Overview
The Stiltsoft Handy Status macro adds and removes the labels on the page.
...
When you use the Stiltsoft Handy Status Macro for Confluence app along with a Comala Document Management workflow, configured with a trigger to monitor label addition and page update events, the value of the Stiltsoft Handy Status macro and the workflow status can “synchronize”.
| Info |
|---|
You need the Stiltsoft Handy Status macro v3.8.0 or above. |
The scenario
A user changes the Stiltsoft Handy Status macro value for a page and this automatically changes the Comala Document Management applied workflow state.
...
| Info |
|---|
For further information refer to the Stiltsoft Handy Status Macro product documentation - How to use Stiltsoft Handy Status macro. |
The solution
In a simple example
the Stiltsoft Handy Status macro is synchronized to change the label for the content
the Stiltsoft Handy Status macro is either no or yes
...
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Workflow trigger one - Stiltsoft Handy Status macro changed to “no”
This trigger manages the response to a labeladded event.
...
| Code Block |
|---|
{trigger:labeladded|label=no}
{set-state:In Progress}
{trigger} |
Workflow trigger two - Stiltsoft Handy Status macro changed to “yes”
This trigger manages the response to a labeladded event.
Stiltsoft Handy status macro is changed to yes
the label yes is added to the page
a workflow trigger listening for the addition of the label yes sets the state to the Approved state
Workflow trigger three - page update in the Approved state changes page label
This trigger manages the response to a pageupdated event in the Approved state.
...
To prevent large numbers of notifications to page watchers, the Stiltsoft Handy macro app marks its content updates as "Minor change" (the same as if you clear the "Notify Watchers" checkbox while editing a page). With triggers and conditions, we can filter out "Minor Change" events and then use an action macro in the trigger to transition the state.
Workflow triggers
| Code Block | ||
|---|---|---|
| ||
{trigger:labeladded|label=no}
{set-state:In Progress}
{trigger}
{trigger:labeladded|label=yes}
{set-state:Approved}
{trigger}
{trigger:pageupdated|state=Approved|isminorchange=true}
{set-state:In Progress}
{set-label:no}
{remove-label:yes}
{trigger} |
| Info |
|---|
The |
App configuration
There is also a Document Management app setting which may be affected by the Stiltsoft Handy Status macro updating content...
Setting | Where | Notes |
|---|---|---|
Page Update Reset Approval | If enabled, content updates will reset any approvals in an active content review. |