Versions Compared

Key

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

...

In the 4 state workflow shown below, you might want the workflow to move from a Rejected state  state to a more proactively named Triage state state.  

...

You can use a trigger to listen for the state change event to the the Rejected state  state and set this trigger action to immediately transition to the Triage state.

The workflow document activity report will include the transition to the Rejected state and then the

...

Triage

...

state where your editors undertake any required updates.

Code Block
"triggers":
[
   {
 
    "event":"on-change-state",

     "conditions":[
      {
        "state":"Rejected"
      }
    ],
    "actions":[
      {
         "action":"change-state",
         "state":"Triage"
      }
    ]
  }
]
Info

If adding the JSON trigger using workflow builder visual editor there is no need to include the opening "triggers": JSON markup notation, it will be automatically added by workflow builder.

event

"on-change-state"

  • trigger will only listen for a state change

event  -
  • event

  • condition added to constrain the event to the state change to the  Rejected state

condition

"state": "Rejected"

  • state condition for the trigger event

. Condition is
  • condition is met if the current state is the Rejected state

action

"change-state"

  • on state change event to the Rejected state, the workflow immediately transitions to the specified state in the change-state action (Triage state)

This can be added to the workflow using workflow builder.

Image Removed

...

titleJSON format to add to workflow builder
Code Block
[{"event":"on-change-state","conditions":[{"state":"Rejected"}],"actions":[{"action":"change-state","state":"Triage"}]}]

For audit purposes, both the rejected decision transition to the Rejected state and the subsequent trigger transition to Triage are recorded in the page workflow history 

...

(info) It is mandatory in the change-state trigger action to add the state parameter with a value for the destination state name.

A range of JSON trigger actions is available including the set-expiration trigger action to set an expiration date for a state.

List of trigger actions

...

Related pages

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "jsontriggerexample" and space = currentSpace ( )