Working with Triggers

Depending on the type of a trigger, different parameters have to be defined for each trigger.

Adding Triggers

To add a trigger you can either:

In both cases the new trigger appears under the process tree in the Outline view and in the diagram. Optionally, you can change the automatically generated ID and name in the properties dialog of the trigger. In the trigger type specific panel of the dialog you can edit the type specific properties.

 


Figure: Adding a Manual Trigger

Deleting Triggers

To delete a trigger, select it in the diagram or in the process tree from the Outline view and choose Delete from the pop-up menu. If you want to delete only the symbol from the diagram, choose Delete Symbol from its pop-up menu.

Modifying Triggers

To modify a trigger, double-click it in the Outline view or in the diagram to open the properties dialog, where you can edit its properties.

Trigger Types

Depending on the trigger type the trigger message may be parameterized with additional data. Such trigger parameters are provided at runtime in form of access points allowing for parameter mappings. Parameter mappings may be used to initialize workflow data of the triggered process instance and are configured in the Parameter Mapping panel of the triggers properties dialog. Please refer to the specific trigger type section in this chapter to obtain a detailed description on how to set up the parameter mappings accordingly.

Camel Trigger

A Camel Trigger allows to start a process by receiving messages from an arbitrary Camel endpoint and passing these into the process the Trigger is defined for.

Camel Trigger Properties
Figure: Camel Trigger Properties

In the Endpoint Settings section, you can specify the Camel Context ID and choose the Endpoint Type.

Camel Context ID

The CamelContextID defines the ID of the CamelContext object, which represents the Camel runtime system.

Endpoint Type

The following Endpoint types are available:

Route

In the Route section you can define additional Camel Route specifications.

JMS Trigger

An incoming message starts a process passing all the information contained in the body of the message as input data.

To change the specific properties of a JMS trigger, open its properties dialog, where you can - among other options -choose the type of message and add parameters of the JMS message.

 

JMS Trigger Properties
Figure: JMS Trigger Properties

In this example we receive a map message. Please refer to Integrating JMS for details on the different message types.

After this configuration we can map the defined parameters to data in our process definition. Select Parameter Mapping and push the Add button to set up a new parameter mapping. A new dialog appears, where you fill in the following parameters:

 


Figure: Parameter Mappings of a JMS Trigger

Mail Trigger

An incoming email starts a process passing all the information contained in the email as input data. To change the properties of the mail trigger, open its properties dialog.

 

Mail Trigger Configuration
Figure: Mail Trigger Configuration

Server Settings

The following server settings are provided:

Mail Settings

The following entry fields are provided to specify mail settings to filter for:

Parameter Mapping

Select Parameter Mapping on the left side of the Properties dialog to configure the Parameter Mapping. In this case you can map parameters of a mail object to a data modeled in the process. In the figure below you find an example on how to access the string content of a received mail.

 


Figure: Mail Parameter Mapping

Manual Trigger

Open the Properties dialog of a created Manual Trigger to change its properties. There you can choose a participant from the list of the Manual Trigger pane.

Properties of a Manual Trigger
Figure: Properties of a Manual Trigger

Another possibility to assign a participant to a manual trigger is to connect the participant via transition to the trigger in the diagram:

  1. In the diagram toolbar palette select Connect.
  2. Select the participant.
  3. Select the manual trigger.

Manual Trigger
Figure: Assign a Participant to a Manual Trigger.

Now the participant is entered in the Manual Trigger Participants section in the triggers model property page.

Assigning Scoped Participants

In case you assign a participant pertaining to a department, the manual trigger in the Stardust Portal opens open a dialog, where the user who started the manual trigger can select a department from a list of departments he belongs to.

Scan Trigger

The Scan Trigger can be used to manage the triggering and starting of Process Instances via a Scan tool. Scan Triggers are non-exclusive, which means that it is possible to have both in one process definition, a Manual Trigger and a Scan Trigger, to allow process instances to be started manually and via a Scan tool.

Via Scan triggers you can create a parameter and define a mapping of this parameter to an existing process variable of data type Document or Document List. For details on using DMS data types, refer to chapter DMS Data Types of the Document Service Integration Guide.

In the properties page of the Scan trigger, you have two specific sections:

Timer Based Trigger

A process can be started at some point in time (Start Timestamp), whereby multiple instances of the process can be created, depending on the defined periodicity. Additionally, a Stop Timestamp can be configured if the periodicity should end at a certain point in time.

In the Properties dialog of the timer based trigger you can change its specific properties.

 


Figure: Properties of a Timer Trigger