17 Sending Notifications

This chapter describes how to use the notification task to communicate with end users of the business process. It describes the different types of notifications tasks and how to configure each of them.

This chapter includes the following sections:

Section 17.1, "Introduction to Notifications"
Section 17.2, "Sending E-Mail Notifications"
Section 17.3, "Sending a User Notification"
Section 17.4, "Sending an SMS Notification"
Section 17.5, "Sending a Voice Notification"
Section 17.6, "Sending an IM Notification"

17.1 Introduction to Notifications

The notification task allows you to send different types of notifications to the users of the application.

It supports the following types of notifications:

E-Mail
User
SMS
Voice
IM

This tasks uses the Oracle Notification Service.

To configure this task you must provide expressions for the different fields of the notification and in some cases you can use the Identity Lookup browser to select one or more users. When you write the expressions you can use any variables accessible from the notification task context such as process data objects or predifined data objects.

17.2 Sending E-Mail Notifications

You can send an e-mail to send a message to users in a certain point of the business process.

17.2.1 How to Send an E-Mail Notification

To send an e-mail notification:

Open your BPMN business process.
Add a Mail Notification task.
Right-click the Mail Notification task.
Select Properties.
Click the Implementation tab.
In the General tab configure the properties described in Section 17.2.2, "How to Configure E-Mail Notification General Properties"
Click the Content tab to configure the properties described in Section 17.2.3, "How to Configure E-Mail Notification Content Properties".
Click the Attachments tab to configure the properties described in Section 17.2.4, "How to Configure E-Mail Notification Attachment Properties".
Click the Headers tab to configure the properties described in Section 17.2.5, "How to Configure E-Mail Notification Header Properties".
Click OK.

17.2.2 How to Configure E-Mail Notification General Properties

Use the following table to configure the general properties of an e-mail notification. Note that some of the properties are optional.

Table 17-1 E-Mail Notification General Properties

Property	Data Type	Optional	Description
From	String	No	Specifies the e-mail address used to send the e-mail notification.
To	String	No	Specifies the e-mail addresses of the receivers of the e-mail notification. You can specifiy these e-mail addresses using expressions or using the Identity Lookup browser.
Bc	String	Yes	Specifies the e-mail addresses of the additional receivers of the e-mail notification. You can specifiy these e-mail addresses using expressions or using the Identity Lookup browser.
Bcc	String	Yes	Specifies the e-mail addresses of the hidden additional receivers of the e-mail notification.ou can specifiy these e-mail addresses using expressions or using the Identity Lookup browser
Reply	String	Yes	Specifies the e-mail addresses to use when replying the e-mail notification. You can specifiy this e-mail address using expressions or using the Identity Lookup browser

17.2.3 How to Configure E-Mail Notification Content Properties

Use the following table to configure the content properties of an e-mail notification.

Table 17-2 E-Mail Notification Content Properties

Property	Data Type	Optional	Description
Subject	String	No	Specifies the subject of the e-mail notification. You must specify this value using expressions.
Body	String	No	Specifies the body of the e-mail notification. You must specify this value using expressions.

17.2.4 How to Configure E-Mail Notification Attachment Properties

Use the following table to configure the attachment properties of an e-mail notification. Note that some of the properties are optional.

Table 17-3 E-Mail Notification Attachment Properties

Property	Data Type	Optional	Description
Name	String	No	Specifies the name of the attachment. You must specify this value using expressions. The default value is "attachment" followed by a number.
Mime Type	String	No	Specifies the attachment content type. You must specify this value using expressions. The default value is "text/html".
Encoding	String	Yes	Specifies the encoding of the e-mail notification. You must specify this value using expressions.
Value	Any	No	Specifies the attachment file. You must specify this value using expressions.

17.2.5 How to Configure E-Mail Notification Header Properties

To configure the header properties you can add one or more headers. Note that configuring header properties is optional.

To add a header:

Click the Add button.

The Create Header dialog appears.

Provide the name and value properties.

Table 17-4 Header Properties

Property	Data Type	Description
Name	String	Specifies the name of the header. You must specify this value using expressions.
Value	String	Specifies the value of the header. You must specify this value using expressions.

Click OK.

17.3 Sending a User Notification

User notification allows you to send a message to the users in a certain point of the process, using the communication media defined for that user.

17.3.1 How to Send a User Notification

To send an e-mail notification:

Open your BPMN business process.
Add a User Notification task.
Right-click the User Notification task.
Select Properties.
Click the Implementation tab.
In the General tab configure the properties described in Section 17.3.2, "How to Configure User Notification General Properties".
Click the Properties tab to configure the properties described in Section 17.3.3, "How to Configure User Notification Properties".
Click OK.

17.3.2 How to Configure User Notification General Properties

Use the following table to configure the general properties of a user notification. Note that some of the properties are optional.

Table 17-5 E-Mail Notification General Properties

Property	Data Type	Optional	Description
To	String	No	Specifies the e-mail addresses of the receivers of the user notification. You can specifiy these e-mail addresses using expressions or using the Identity Lookup browser.
Subject	String	Yes	Specifies the subject of the user notification. You must specify this using expressions.
Message	String	Yes	Specifies the message to send using the user notfication. You must specify this using expressions.

17.3.3 How to Configure User Notification Properties

You can add one or more properties. Note that configuring properties is optional.

To add a header:

Click the Add button.

The Create Property dialog appears.

Provide the name and value properties.

Table 17-6 Properties

Property	Data Type	Description
Name	String	Specifies the name of the property. You must specify this value using expressions.
Value	String	Specifies the value of the property. You must specify this value using expressions.

Click OK.

17.4 Sending an SMS Notification

You can send an SMS a message to users in a certain point of the business process.

17.4.1 How to Send an SMS Notification

To send an e-mail notification:

Open your BPMN business process.
Add a SMS Notification task.
Right-click the Mail Notification task.
Select Properties.
Click the Implementation tab.
Configure the General Properties described in Section 17.4.2, "How to Configure SMS Notification General Properties".
Click OK.

17.4.2 How to Configure SMS Notification General Properties

Use the following table to configure the general properties of an SMS notification. Note that some of the properties are optional.

Table 17-7 E-Mail Notification General Properties

Property	Data Type	Optional	Description
From #	String	No	Specifies the cellphone number used to send the SMS notification.
To #	String	No	Specifies the cellphone numbers of the receivers of the SMS notification. You can specifiy these cellphone numbers using expressions or using the Identity Lookup browser.
Subject	String	Yes	Specifies the subject of the SMS notification. You must specifiy this using expressions.
Body	String	Yes	Specifies the body of the SMS notification. You must specifiy this using expressions.

17.5 Sending a Voice Notification

You can send a voice message to users in a certain point of the business process.

17.5.1 How to Send an Voice Notification

To send an e-mail notification:

Open your BPMN business process.
Add a Voice Notification task.
Right-click the Mail Notification task.
Select Properties.
Click the Implementation tab.
Configure the General Properties described in Section 17.5.2, "How to Configure Voice Notification General Properties".
Click OK.

17.5.2 How to Configure Voice Notification General Properties

Use the following table to configure the general properties of avoice notification. Note that some of the properties are optional.

Table 17-8 E-Mail Notification General Properties

Property	Data Type	Optional	Description
To #	String	No	Specifies the telephone numbers of the receivers of the voice notification. You can specifiy these telephone numbers using expressions or using the Identity Lookup browser.
Mime Type	String	Yes	Specifies the content type. You must specify this value using expressions. The default value is "text/html"
Body	String	Yes	Specifies the body of the voice notification. You must specifiy this using expressions.

17.6 Sending an IM Notification

You can send an Instant Message to users in a certain point of the business process.

17.6.1 How to Send an IM Notification

To send an e-mail notification:

Open your BPMN business process.
Add a IM Notification task.
Right-click the Mail Notification task.
Select Properties.
Click the Implementation tab.
Configure the General Properties described in Section 17.6.2, "How to Configure IM Notification General Properties".
Click OK.

17.6.2 How to Configure IM Notification General Properties

Use the following table to configure the general properties of an IM notification. Note that some of the properties are optional.

Table 17-9 E-Mail Notification General Properties

Property	Data Type	Optional	Description
To	String	No	Specifies the user IDs of the receivers of the IM notification. You can specifiy these user IDs using expressions or using the Identity Lookup browser.
Body	String	Yes	Specifies the body of the IM notification. You must specifiy this using expressions.