Working with the Email Task

The Email Task allows you to send an email within a BPMN Process. It is configured with the following properties. 

Sample Email Server Configuration

The Activiti engine sends e-mails using an external mail server. The following steps guide you through a sample email server configuration for the Email task. 

1. Set the following properties in the activiti.xml configuration file found in the <BPS_HOME>/repository/conf directory. The following code block provides a sample of these settings using the Gmail configuration settings. 

   <property name="mailServerHost" value="smtp.gmail.com"/>
   <property name="mailServerPort" value="456"/>
   <property name="mailServerDefaultFrom" value="mailtask@gmail.com"/>
   <property name="mailServerUseSSL" value="true"/>
   <property name="mailServerUsername" value="mailtask@gmail.com"/>
   <property name="mailServerPassword" value="mailtask123"/>

   Property	Description
   <property name="mailServerDefaultFrom" value=”email of the sender”>	This specifies the default address of the sender. If a sender is not specified in the sender field as a mail task property, the email address specified here will be used instead.
   <property name="mailServerUsername" value="mailtask@gmail.com"/> <property name="mailServerPassword" value="mailtask123"/>	Specifies the credentials of the sender for authentication purposes. Here, you should include the email addressandit'scorrespondingpasswordwhich you specified in the “From” field of the mail task.
   Port 456 (SSL required):<property name="mailServerUseSSL" value="true"/> Port 587 (TLS required):<property name="mailServerUseTLS" value="true"/>	Specifiy only one of these two properties in order to specify whether the mail server should use SSL or TLS.

2. Copy the following jar files into the <BPS_HOME>/repository/components/lib directory and restart the server. 

   • org.apache.commons:commons-email:jar:1.3

   • javax.mail:mail:jar:1.4.7

   • javax.activation:activation:jar:1.1