Skip Headers
Oracle® Fusion Middleware Modeling and Implementation Guide for Oracle Business Process Management
11g Release 1 (11.1.1.6.3)

Part Number E15176-11
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

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:

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:

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:

  1. Open your BPMN business process.

  2. Add a Mail Notification task.

  3. Right-click the Mail Notification task.

  4. Select Properties.

  5. Click the Implementation tab.

  6. In the General tab configure the properties described in Section 17.2.2, "How to Configure E-Mail Notification General Properties"

  7. Click the Content tab to configure the properties described in Section 17.2.3, "How to Configure E-Mail Notification Content Properties".

  8. Click the Attachments tab to configure the properties described in Section 17.2.4, "How to Configure E-Mail Notification Attachment Properties".

  9. Click the Headers tab to configure the properties described in Section 17.2.5, "How to Configure E-Mail Notification Header Properties".

  10. 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:

  1. Click the Add button.

    The Create Header dialog appears.

  2. 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.


  3. 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:

  1. Open your BPMN business process.

  2. Add a User Notification task.

  3. Right-click the User Notification task.

  4. Select Properties.

  5. Click the Implementation tab.

  6. In the General tab configure the properties described in Section 17.3.2, "How to Configure User Notification General Properties".

  7. Click the Properties tab to configure the properties described in Section 17.3.3, "How to Configure User Notification Properties".

  8. 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:

  1. Click the Add button.

    The Create Property dialog appears.

  2. 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.


  3. 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:

  1. Open your BPMN business process.

  2. Add a SMS Notification task.

  3. Right-click the Mail Notification task.

  4. Select Properties.

  5. Click the Implementation tab.

  6. Configure the General Properties described in Section 17.4.2, "How to Configure SMS Notification General Properties".

  7. 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:

  1. Open your BPMN business process.

  2. Add a Voice Notification task.

  3. Right-click the Mail Notification task.

  4. Select Properties.

  5. Click the Implementation tab.

  6. Configure the General Properties described in Section 17.5.2, "How to Configure Voice Notification General Properties".

  7. 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:

  1. Open your BPMN business process.

  2. Add a IM Notification task.

  3. Right-click the Mail Notification task.

  4. Select Properties.

  5. Click the Implementation tab.

  6. Configure the General Properties described in Section 17.6.2, "How to Configure IM Notification General Properties".

  7. 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.