How to Select Email Addresses and Telephone Numbers Dynamically

16-14 Oracle Fusion Middleware Developers Guide for Oracle SOA Suite ■ Telephone Number field on the SMS and Voice dialogs For more information about using the Identity Lookup dialog, see Chapter 31, Introduction to Human Workflow Services

16.4 Allowing the End User to Select Notification Channels

You can design a BPEL process in which you do not explicitly select a notification channel during design time, but simply indicate that a notification must be sent. The channel to use for sending notifications is resolved at runtime based on preferences defined by the end user in the User Messaging Preferences user interface of the Oracle User Messaging Service. This moves the responsibility of notification channel selection from the BPEL process designer in Oracle BPEL Designer to the end user. If the end user does not select a preferred channel or rule, email is used by default for sending notifications to that user. Regardless of who selects the channel to use, channel use is still based on the driver installation and configuration performed in the Oracle User Messaging Service section of Oracle Enterprise Manager Fusion Middleware Control by the administrator. For example, an end user may set their preferences as follows: ■ If an expense report amount is less than 153, they receive an email notification. ■ If an expense report amount is between 153 and 3678, they receive an SMS notification. ■ If an expense report amount is more than 3678, they receive a voice notification. For more information about the User Messaging Preferences user interface, see Chapter 64, User Messaging Preferences.

16.4.1 How to Allow the End User to Select Notification Channels

To allow the end user to select notification channels: 1. From the Component Palette list, select BPEL. 2. Expand BPEL Activities and Components. 3. From the Component Palette, drag the User Notification activity into the designer. Figure 16–8 shows the required user notification parameters. Note: You can also set user preferences for sending notifications in human workflows in the Human Task Editor. Set these preferences in the Notification Filters part of the Notification Settings section. These preferences are used to evaluate rules in the task. For more information, see Section 27.3.10.8, Sending Task Attachments with Email Notifications. Using the Notification Service 16-15 Figure 16–8 User Notification Dialog 4. Enter information for each field as described in Table 16–8 .

5. Click Apply.

16.4.1.1 How to Create and Send Headers for Notifications

The Advanced tab of the User Notification dialog enables you to create and send header and name information that may be useful to an end user in creating their own preference rules for receiving notifications. For example: ■ The BPEL designer creates specifies the users named jcooper and jstein in the General tab. Table 16–8 User Notification Parameters Name Description To Enter a valid user for the recipient of this notification message through one of the following methods: ■ Enter the user manually ■ Click the Search icon to display a dialog for selecting a user configured through the identity service. The identity service enables the lookup of user properties, roles, and group memberships. ■ Click the XPath Expression Builder icon to display the Expression Builder dialog to dynamically enter a user. Note: You must specify a user name for example, jcooper instead of an address. Subject Enter a message name or click the XPath Expression Builder icon to display the Expression Builder dialog to dynamically enter a subject. If notification is sent through email, this field is used during runtime. This field is ignored if notifications are sent through the voice, SMS, or IM channels. Notification Message Enter the notification message or click the XPath Expression Builder icon to display the Expression Builder dialog to dynamically enter a message to send.