The Email Task allows you to send an email within a BPMN Process. It is configured with the following properties.
| Field Name | Mandatory | Description |
|---|---|---|
| To | Yes | The email address of the intended recipient of the email. Multiple recipients can be specified as comma-separated email addresses. |
| From | No | The email address of the sender. If this field is not specified, the default email address specified in the activiti.xml file will be used. |
| Subject | No | Subject of the email. |
| CC | No | The email addresses of the carbon copy receivers of the email. Multiple recipients are separated by commas. |
| Bcc | No | The email addresses of the blind carbon copy receivers of the e-mail. Multiple recipients are separated by commas. |
| Charset | No | Charset of the email can be changed. |
| Html | No | The content of email is in HTML format. |
| Text | No | Content is in non-HTML format. |
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.
Set the following properties in the
activiti.xmlconfiguration file found in the<BPS_HOME>/repository/confdirectory. 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. If you are using Gmail to try out this scenario, enable IMAP access for Gmail. See Enable IMAP settings in Gmail for more information.
If you receive an authentication error, you may have to adjust your account access settings in Gmail as well. See Allowing less secure apps to access your account for more information.
Copy the following jar files into the
<BPS_HOME>/repository/components/libdirectory and restart the server.org.apache.commons:commons-email:jar:1.3javax.mail:mail:jar:1.4.7javax.activation:activation:jar:1.1