/
Triggers



Triggers

Overview

You can use workflow triggers to help automate your documentation process and flexibly respond to workflow events.

For example, you can use a trigger to automatically send an email when a page is submitted for review.

Triggers can be added to

  • listen for when a single workflow event occurs

  • check if the required conditions are met for the event

  • if met, then undertake one or more actions

cdmc_graphic_trigger_events_conditions_actions_list.png
Workflow trigger events, conditions, and actions

Triggers

Workflow triggers consist of the following elements:

Multiple triggers can be added to a workflow. A trigger for an event must include at least one or more actions.

Workflow trigger events

Workflow trigger conditions

Workflow trigger actions

Workflow trigger events

Workflow trigger conditions

Workflow trigger actions

State actions

Approval actions

Notification actions

Page restrictions actions

Publishing actions

Requires the Comala Publishing app.

Label actions

The label-related actions are part of a gradual rollout of new features and might not be currently available in all instances.

Adding a trigger to a workflow

A space administrator can add one or more workflow triggers to a custom workflow using either the visual editor or the code editor.

cdmc_visualeditor_trigger_addtrigger_onstatechanged_statecondition_setmessageaction.png
Visual editor - Add trigger editor

The event and condition are chosen from a dropdown list of available options.

You can then include one or more Actions for the trigger using the Add Action option, such as the Set Message action.

cdmc_visualeditor_addaction_dialogbox_set_message_parametervaluesadded.png
Visual editor - Add Action dialog box in the trigger editor

The added trigger is automatically updated in the code editor.

cdmc_codeeditor_savedtrigger.png
Code editor - send email trigger

You can also add a workflow trigger in the code editor, which includes JSON schema to help you.

cdmc_code_editor_jsonschema_help_triggers_event.png

You can toggle between the code editor and the visual editor. Changes made in one editor are automatically updated in the other editor.

The workflow triggers added to a workflow are listed in the visual builder.

cdmc_visualeditor_workflowpanel_withtriggers.png

Related pages