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:
The notification task allows you to send different types of notifications to the users of the application.
It supports the following types of notifications:
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 predefined data objects.
Using the notification service, you can send an email message to users at a certain point in the business process.
You can use the Identity Lookup browser to select one or more users.
To send an email notification:
Use the following table to configure the general properties of an email notification. Note that some of the properties are optional.
Table 14-1 Email Notification General Properties
| Property | Data Type | Optional | Description |
|---|---|---|---|
|
From |
string |
No |
Specifies the email address used to send the email notification. |
|
To |
string |
No |
Specifies the email addresses of the receivers of the email notification. You can specify these email addresses using expressions or using the Identity Lookup browser. |
|
Bc |
string |
Yes |
Specifies the email addresses of the additional receivers of the email notification. You can specify these email addresses using expressions or using the Identity Lookup browser. |
|
Bcc |
string |
Yes |
Specifies the email addresses of the hidden additional receivers of the email notification.ou can specify these email addresses using expressions or using the Identity Lookup browser |
|
Reply |
string |
Yes |
Specifies the email addresses to use when replying the email notification. You can specify this email address using expressions or using the Identity Lookup browser |
Use the following table to configure the content properties of an email notification.
Table 14-2 Email Notification Content Properties
| Property | Data Type | Optional | Description |
|---|---|---|---|
|
Subject |
string |
No |
Specifies the subject of the email notification. You must specify this value using expressions. If you are creating an actionable email, avoid using '&' in the subject. It can cause truncated subject lines in some email clients including some versions of Outlook. |
|
Body |
string |
No |
Specifies the body of the email notification. You must specify this value using expressions. |
Use the following table to configure the attachment properties of an email notification. Note that some of the properties are optional.
Table 14-3 Email 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 email notification. You must specify this value using expressions. |
|
Value |
Any |
No |
Specifies the attachment file. You must specify this value using expressions. |
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 box appears.
Provide the name and value properties.
Table 14-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.
User notification allows you to send a message to the users in a certain point of the process.
You must use the communication media defined for that user.
To send an email notification:
Use the following table to configure the general properties of a user notification. Note that some of the properties are optional.
Table 14-5 Email Notification General Properties
| Property | Data Type | Optional | Description |
|---|---|---|---|
|
To |
string |
No |
Specifies the email addresses of the receivers of the user notification. You can specify these email 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 notification. You must specify this using expressions. |
Using the notification service, you can send an SMS a message to users in a certain point of the business process.
You can use the Identity Lookup browser to select one or more users.
To send an email notification:
Use the following table to configure the general properties of an SMS notification. Note that some of the properties are optional.
Table 14-7 Email 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 specify these cellphone numbers using expressions or using the Identity Lookup browser. |
|
Subject |
string |
Yes |
Specifies the subject of the SMS notification. You must specify this using expressions. |
|
Body |
string |
Yes |
Specifies the body of the SMS notification. You must specify this using expressions. |
Using the notification service, you can send a voice notification to users in a certain point of the business process.
You can use the Identity Lookup browser to select one or more users.
To send a voice notification:
Use the following table to configure the general properties of a voice notification. Note that some of the properties are optional.
Table 14-8 Email Notification General Properties
| Property | Data Type | Optional | Description |
|---|---|---|---|
|
To # |
string |
No |
Specifies the telephone numbers of the receivers of the voice notification. You can specify 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 specify this using expressions. |
Using the notification service, you can send an Instant Message to users in a certain point of the business process.
You can use the Identity Lookup browser to select one or more users.
To send an email notification:
Use the following table to configure the general properties of an IM notification. Note that some of the properties are optional.
Table 14-9 Email Notification General Properties
| Property | Data Type | Optional | Description |
|---|---|---|---|
|
To |
string |
No |
Specifies the user IDs of the receivers of the IM notification. You can specify these user IDs using expressions or using the Identity Lookup browser. |
|
Body |
string |
Yes |
Specifies the body of the IM notification. You must specify this using expressions. |