Business Process Designer > Business process modeling > Graphical elements / E-mail notification

E-mail notification

00.PNG

In a business process, e-mail notifications are used when it is necessary to inform someone about the work progress. For instance, you can set up automatic order shipment notifications or send your customer a contract right after it is approved by your legal department. Also, you can use it to let your staff know when they are assigned an important task.

Connection settings

начало внимание

Only users included in the Administrators group can set up e-mail notifications.

конец внимание

In order to enable e-mail notifications in a business process, you first have to configure connection settings. To do that, go to Administration > System settings > Email settings.

01.PNG

Select one of the available services:

  • gmail.com
  • yahoo.com
  • outlook.com
  • office365.com
  • other. In this case, you can specify your own SMTP server. Check the Send from Reply-to address option, if you want the sender's address to be replaced with the reply-to address.

Once you have specified the mail service, enter the login. The login is the email address that QuickBPM will use to send out emails. In the password field enter the password to this email.

02.PNG

Please note that these mailing services require additional verification if it is not yet enabled:

The table below lists possible errors that may appear when checking the connection if additional verification is disabled.

Possible errors

Do not forget to test the connection. When you do that, a message for confirming your details will be sent to your email specified in your user profile, not to the address that you have entered as the login.

If the connection was successful, you will see a notification.

06.PNG

If QuickBPM fails to establish the connection, you will also be notified.

Notification settings

When the connection is established, you can set up email notifications in business processes. To do that, drag the Email notification item to the process diagram. You will find it in the Integrations tab of the right menu.

Taking the Order fulfillment process as an example let's see how email notifications work. Once the order is packed and ready to be shipped, we have to notify the customer about it. Let's place the email notification element right after the Pick and pack task.

03.PNG

Double-click on the shape to open settings and fill out the form:

04.PNG

  • To: enter one or several emails of notification recipients. You can also use a context variable, for example, contractor's email. In this case, the system will send the notification to the address specified on the page of the contractor who placed the order. To add a variable, click on the plus symbol + in the right corner of the field.

  • Sender name: fill out this field, if you do not want the email address specified in system settings to appear in the notification as the sender's address. You can replace it, for instance, with the name QuickBPM or the name of your company.
  • Reply address: by default, replies are sent to the address specified in system settings. If you wish for them to be sent to a different email, enter this email here.
  • Subject: enter a short and informative subject, for instance, "Order is packed and awaiting shipment". Use a context variable to add the order's number if necessary. To add a variable, click on the plus symbol + in the right corner of the field.
  • Message: enter all the necessary details. With process variables, you can add a list of purchased products, the total cost, expected delivery date, and so on. To add a variable, click on the plus symbol + in the right corner of the field. If you want to apply formatting, use HTML tags.
  • File: add one or several documents used in the order fulfillment process, for example, the packing slip and the invoice. These documents will be then attached to the email notification.

Error handling

An error may occur when sending the notification, for example, if QuickBPM fails to determine the recipient's address. Decide how the system should behave in this case.

Go to the Error handling tab.

05.PNG

  • Retry: enable this option if you want QuickBPM to try sending the notification again.
    • Number of retries:  how many attempts should the system make.
    • Retry delay (sec): the amount of time QuickBPM should wait between attempts.
  • Notification: select this option to inform particular users about the error. You can select the current executor, context variable, for example, the initiator, as well as a group or an org chart item. Please note that the current user is the person who completed the task located prior to the email notification shape on the diagram.
  • Interrupt: in case of an error, QuickBPM will not attempt to send the notification again and will resume the process. You need to select a connector to specify which process branch should be activated.

After you specify all the settings, click Save and publish the process.

Once the order is packed and ready for shipment, a notification will be sent to the customer's email. Here is how it might look:

07.PNG