The Email Task allows us you to send an email within a BPMN Process. Email Task It is configured with the following properties.
| Filed Field Name | Is mandatory propertyMandatory | 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 sender email address of the sender. If this field is not specified, the default email address specified in the activiti.xml is 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 bcc's 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 HTML format. |
| Text | No | Content is in non html -HTML format. |
Sample Email Server Configuration
The Activiti engine sends e-mails using an external mail server. Following properties should be set in the The following steps guide you through a sample email server configuration for the Email task.
Set the following properties in the
activiti.xml
...
configuration file
...
found in the
<BPS_HOME>/repository/confdirectory. The following code block provides a sample of these settings using the Gmail configuration settings.Code Block language xml <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.
1. You should specify only one from following properties.
...
Port 456 (SSL required):<property name="
...
mailServerUseSSL" value="true"/>Port 587 (TLS required):<property name="mailServerUseTLS" value="true"/>
2. Copy dependency jar files.
Specifiy only one of these two properties in order to specify whether the mail server should use SSL or TLS. Copy the following jar files into
...
the
<BPS_HOME>/repository/components/lib
...
directory and restart the server.
org.apache.commons:commons-email:jar:1.
...
...
...