Use a mail action if there is a reason not to show the e. mail as a node in the process graph.

<mail actors="#{president}" subject="readmylips" text="nomoretaxes" />

Specify the subject and text attributes as an element like this:

<mail actors="#{president}" >

    <subject>readmylips</subject>

    <text>nomoretaxes</text>

</mail>

Each of the fields can contain JSF-like expressions:

<mail

    to='#{initiator}'

    subject='websale'

    text='your websale of #{quantity} #{item} was approved' />

As with mail actions, the action of sending an e. mail can be modeled as a node. In this case, the run-time behavior will be identical identical but the e. mail will display as a node in the process graph.

A notification e. mail can be sent when a task is assigned to an actor. To configure this feature, add the notify="yes" attribute to a task in the following manner:

<task-node name='a'>

    <task name='laundry' swimlane="grandma" notify='yes' />

    <transition to='b' />

</task-node>

Set notify to yes, true or on to make the Business Process Manager send an e. mail to the actor being assigned to the task. (Note that this e. mail is based on a template and contains a link to the web application's task page.)

Emails can be sent as task reminders. JPDL's reminder element utilizes the timer. The most commonly used attributes are duedate and repeat. Note that actions do not have to be specified.

<task-node name='a'>

    <task name='laundry' swimlane="grandma" notify='yes'>

        <reminder duedate="2 business days" repeat="2 business hours"/>

    </task>

    <transition to='b' />

</task-node>

Multiple recipients can be listed in the actors and to fields. Separate items in the list with either a colon or a semi-colon.

In order to send messages to a Blind Carbon Copy (BCC) recipient, use either the bccActors or the bcc attribute in the process definition.

<mail to='#{initiator}' 

      bcc='bcc@mycompany.com' 

      subject='websale' 

      text='your websale of #{quantity} #{item} was approved' />

An alternative approach is to always send BCC messages to some location that has been centrally configured in jbpm.cfg.xml. This example demonstrates how to do so:

<jbpm-configuration>

    ...

    <string name="jbpm.mail.bcc.address" value="bcc@mycompany.com" />

</jbpm-configuration>

Throughout the Business Process Manager, actors are referenced by actorIds. These are strings that serves to identify process participants. An address resolver translates actorIds into e. mail addresses.

Use the attribute actors to apply address resolving. Conversely, use the to attribute if adding addresses directly as it will not run apply address resolving.

Make sure the address resolver implements the following interface:

public interface AddressResolver extends Serializable {

    Object resolveAddress(String actorId);

}

An address resolver will return one of the following three types: a string, a collection of strings or an array of strings. (Strings must always represent e. mail addresses for the given actorId.)

Ensure that the address resolver implementation is a bean. This bean must be configured in the jbpm.cfg.xml file with name jbpm.mail.address.resolver, as per this example:

<jbpm-configuration>

    <bean name='jbpm.mail.address.resolver' 

        class='org.jbpm.identity.mail.IdentityAddressResolver' 

        singleton='true' />

</jbpm-configuration>

The Business Process Manager's identity component includes an address resolver. This address resolver will look for the given actorId's user. If the user exists, his or her e. mail address will be returned. If not, null will be returned.

The following settings can be used to enable (SMTP) authentication when sending email.

The following logic is applied with regards to the above properties:

If neither the jbpm.mail.user nor the jbpm.mail.password property is set, authentication is not used regardless of other settings set.

If the jbpm.mail.user property is set, then the following is done:

If the jbpm.mail.user property and the jbpm.mail.password property are set, then the following is done: