| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Some initial prerequisites are necessary to implement the feature into your workflow. To activate this feature your process model must have at least one of the following:
Email Start Node
Email Start Event:
A transition needs to be drawn from the additional start event to an activity or gateway.
| Info |
|---|
The process model must still contain the normal start event for the manual start of the workflow. |
Task Boundary Event:
A transition needs to be drawn from the boundary event to the target activity or gateway.
Additionally, it is required to draw another transition from the activity where the boundary event is attached to another or the same target activity or gateway. See example below:
...
As seen in the thumbnails above 2 variants of the start and boundary events are supported (Signal and Message according to the BPMN Standard).
Configuration
To configure the Inbound Email feature, some initial configuration and a per workflow configuration is required.
...
For the TIM BPM Suite to receive inbound emails an IMAP Host needs to be configured. This is done outside the TIM BPMN Suite environment (e.g. Microsoft, Google, etc.).
| Note |
|---|
POP3 is not supported. |
TBD if a small setup guide should be shown here
Mailbox Connector
After completing the setup of the IMAP Host, you need to connect it to your TIM BPM environment. This is done via a new connector type the Mailbox Connector.
Like other Connectors it can be found in the Design section of the TIM BPM Suite, therefore it is required that the user that sets up the Mailbox Connector has the workflow-designer static role.
From there select the Connectors sub-section.
...
In the bottom-left corner the Plus-Button1 (
) is shown clicking it will show a sub-button-menu, there click the Mailbox-Button2 to create a new Mailbox Connector.
...
...
...
Reference | Attribute | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mailbox configuration | These are the required fields to create a connection between the IMAP mail server and the TIM BPM Suite:
| ||||||||||
| Authentication | There are 2 authentication Methods available:
Depending on the selection new required fields need to be filled. Optionally No Authentication can be selected. |
Workflow Design
The configuration regarding the Inbound Emails is done on the workflow level.
Connecting the workflow to a mailbox
If the prerequisites regarding the process model are met a new tab is shown in the workflow properties.
...
Reference | Attribute | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Mailbox Connector | Here the Mailbox Connector that is linked to the workflow must be selected.
| ||||||||
| Other Configuration |
Configuration of email start
Configuration of task completion by mail reply
Administration
Click here to see what's new in the administration regarding the inbound emails.