This article describes configurations possible against modeling elements of the type Event.
An event is a modeling element that is used to indicate that something “happens” during the course of a process. Events affect the flow and usually have a cause or an impact on the application.
In processes, there are three archetypes of events:
1. Start events, which indicate where a process will start.
2. End events, which indicate where a path of a process will end.
3. Intermediate events, which indicate where something happens somewhere between the start and end of a process.
Within these three types, events come in two types:
1. Events that catch a trigger. All start events and some intermediate events are catching events.
2. Events that throw a trigger or a result. All end events and some intermediate events are throwing events. Typically the throwing trigger carries information into the catching event.
The markers are unfilled for triggers that catch, and the markers are filled for triggers and results that throw.
The article below will go through the possible configurations for message event, timer event, signal event and link event.
Message event
In the BPMN standard, Start, End, and Intermediate Events can have the type "Message".
When to use message events
Message events are useful as they enable processes to send emails to Process Automation users in different roles or groups as well as send emails to external users based on form data. They can also be used to send process messages which can be used to trigger connected workflows and start other process applications. For example, messages can be used to notify a user that the process has progressed to a certain phase, to send an automatic response that a registered case has been received, to inform an interested party that the process has passed a milestone, or to inform one or more interested parties that the process has ended.
Throwing message events
Throwing message events are used to send messages. They are represented by a darker email symbol. The event is configured either as an Email message or as a Process Message which will be thrown/sent when the event is triggered.
Catching message events
Catching message events are used to receive messages. They are represented by a lighter email symbol. The event is configured to receive a specific process message and when this message is sent, the event will be triggered.
You can only have one condition connected to an event at a time. If you connect more than one, only the first will be executed.
Configure a throwing message event
- Double-click on the intermediate event and select Add new event trigger.
- Select a Throwing event.
- Select Configure message.
- From the Configure message window, you can choose to send either an Email message or a Process message from the tabs at the top of the window.
- If you want to configure an email message the interface lets you:
- Add recipients from four quick categories
- Compose your email subject and body
- Add a Reply to address
- Add a From name
- Add attachments
Add recipients
Message events have the capability of sending e-mails to the role members set in the process model, to groups within a workspace, to an e-mail address that has been filled out in a form field, or to custom email addresses.
If you want to add multiple e-mail addresses via a form field, they need to be separated with a comma (,).
Select multiple categories to add them. It is possible to combine several email addresses from roles, groups, form fields, and custom addresses. If an email address is present in two places, for example in a role and in a group, only one email will be sent to that person.
Compose an email
The email body text editor has some basic formatting functionality as well as the ability to edit HTML.
It is possible to add variables in the e-mail text that reference information from the process instance or from form fields. For example, in a process, you may have a form with a field for reviewer's comments allowing the reviewer to document the outcome of a review. The text entered in the reviewer's comments field can be inserted into the e-mail text through a variable and sent to the recipient of your choice.
Read more about how to reference variables in the article, Variables.
Add a reply-to address
This sets a reply-to address that will show up in the recipient's address field if they want to respond to the message sent by Process Automation. This allows users to configure a reply to an address of their own instead of noreply@bariumlive.com
Add from name
This sets a sender name that will show up in the email header.
The default From name will be the name of the application.
Attach files
Files up to 20MB can be attached to an email thrown by a message event. It is possible to attach files to emails sent from message events in three different ways:
-
Option 1
You can send files taken from attachment form fields by selecting the form field. These files can be of any format.
-
Option 2
You can send an entire data object form as a PDF file by modeling the data object as an input to the send message event.
Doing this will cause it to show up in the attachment field automatically and sending the message will convert the form to PDF and make it available as an attachment to the email.
-
Option 3
You can send generated documents as either a PDF or a docx file by modeling them as inputs to the send message event.
If you want the document to be converted to PDF instead of the default docx format, simply double-click on the document template modeled as an input and choose PDF generation.
Generated Documents modeled as inputs to the send message event will show up in the attachment field automatically and sending the message will make it available as an attachment to the email.
If the total size of a message exceeds 25 MB, the message will not be sent and an error will be generated in the Event log.
Show and edit HTML
It is possible to create a custom and styled e-mail message by clicking on the Show and edit HTML button.
This will present the HTML mode of the editor and allow you to add or edit the e-mails HTML code and attributes.
You can use standard HTML tags (preferably <Tables>) and add CSS style attributes to set the color, size, and formatting of text and more.
Example:
Configure a catching message event
It is possible to use a process message to start a process, to learn how to configure that, read the article Start process with process message.
Catching message events allow you to await a signal from another system before the process moves forward. The signal will need to contain the instance Id and the message name. More information is available in API Documentation - Instances.
- Double-click on the intermediate event and select Add new event trigger.
- Choose a Catching event trigger.
- Click on Configure message.
- From this window, you can set the Message name.
- There are options to add Message Fields and Roles to the message.
This is not yet a supported feature in intermediate-catching message events. Message fields mapped to a form will not be updated.
If you leave the key in a message field empty, you will not be able to deploy the application.
Comments
0 comments
Article is closed for comments.