Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

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
minLevel3
maxLevel3
outlinefalse
styledisc
typelist
printablefalse

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
languagetext
{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 isminorchange parameter is a workflow condition that can be used in a pageupdated  or newsupdated workflow trigger with the Stiltsoft Handy Status macro app.

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.

See also

...