Versions Compared

Key

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

...

This page describes how to avoid unwanted workflow transitions (if using updated parameter on the {state} macro) when using the StiltSoft Talk app.

Image RemovedImage Added

You will need Talk app version 2.6.0 or above.

The problem

In many cases, workflow {state} macros  macros marked as final=true (published) also use the updated parameter to automatically transition back to a draft state should the page be edited.

...

The solution is to not use the updated parameter on the {state} macro macro, but instead use a {trigger}.

In order to prevent large numbers of notifications to page watchers, the Talk 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 to do the state transition.

...

  1. We removed the updated=Draft from the Published { Published state}
  2. We replaced it with a pageupdated trigger filtered to non-minor updates ( isminorchange=false ) and, when applicable, invoke the {set-state} macro to transition the workflow to the Draft state.

With the updated workflow, minor changes are ignored, but normal changes will still trigger the transition.

(blue star) The isminorchange parameter is a workflow condition that can only be used in a pageupdated  or newsupdated trigger with the StiltSoft Talk app.

App configuration

There is also a Document Management app setting which may be affected by the Talk app updating content...

...