Workflow Trigger Reference for Saltbox Core Connector

Workflow Triggers initiate workflows and are used to define the data supplied to a workflow.

Basic details are shown in the table below.

Trigger Source Description Version
Event Workflow Trigger This triggers when the specified event occurs. ex: a route-based action. This is an alternative to scheduled Workflow Triggers. 10.0+
Generate an Empty Message Generate a blank message. This trigger message source may be used to schedule a workflow that doesn’t require starter data. 11.9+

Trigger Sources

Event Workflow Trigger

Trigger Source Description Version
Event Workflow Trigger This triggers when the specified event occurs. ex: a route-based action. This is an alternative to scheduled Workflow Triggers. 10.0+

Event triggers allow for workflows to be triggered from other workflows, or using Saltbox API Gateway places.

  • Trigger an event-based workflow from other workflows using the Route Message or Route Message Synchronously actions.

  • Trigger an event-based workflow from a third-party system synchronously using API Gateway.

General setup

Basic workflow setup for Event-based triggers is as follows.

Go to the Workflow Trigger section and define the following:

  • Connector: Connector.Integration.Core

  • Connection Config: (leave blank)

  • Source: Event Workflow Trigger

  • Source Settings

    • ID Path: (leave blank or set the desired value)
  • Raw Message Contents

    • Message Format: Select the expected message format, such as XML.

    • other settings may be left as default

Once settings are configured, *Save the Workflow Trigger. Restart the project engine if it was already started.

Action-triggered example

After the trigger has been set up as described in the General setup section above, another workflow may use the Route Message or Route Message Synchronously actions to trigger this workflow.

Edit the workflow that will route messages to this previously-configured workflow.

In Workflow Designer, edit or add a Route Message or Route Message Synchronously action to the workflow. Configure this action to point to the event-based workflow name that was set up in General setup section above.

For example, if a workflow called “My Event Workflow” has been configured as an event-based trigger, and another workflow called “Traffic Director Workflow” needs to send messages to that event workflow, a Route Message action will be added to the “Traffic Director Workflow” designer page, and will contain the following

See Saltbox Core Connector Actions - Route Message or Saltbox Core Connector Actions - Route Message Synchronously for more action setup examples.

API Gateway example

See Setting Up Saltbox API Gateway for a tutorial on getting started with API Gateway.

Step 3.1: Workflow Trigger setup outlines how to set up this trigger to accept calls from Saltbox API Gateway.

Generate an Empty Message

Trigger Source Description Version
Generate an Empty Message Generate a blank message. This trigger message source may be used to schedule a workflow that doesn’t require starter data. 11.9+