Click OK. How to Configure the SMS Notification Channel

Using the Notification Service 16-13 ■ To get the email address or telephone number directly from the payload, use the following XPath expression: bpws:getVariableDatavariable name, part,input_xpath_to_get_an_ address For example, to get the email address from variable inputVariable and part payload based on XPath clientBPELProcessRequestclientmail: bpws:getVariableDatainputVariable,payload,client:BPELProcessRequest client:email You can use the XPath Expression Builder to select the function and enter the XPath expression to get an address from the input variable. ■ To get the email address or telephone number dynamically from the underlying identity store LDAP use the following XPath expression: ids:getUserPropertyuserName, attributeName[, realmName] The first argument evaluates to the user ID. The second argument is the property name. The third argument is the realm name. Table 16–7 lists the property names that can be used in this XPath function. The following example gets the email address of the user identified by the variable inputVariable, part payload, and queries client:BPELProcessRequestclient:userID: ids:getUserPropertybpws:getVariableData‘inputVariable’, ‘payload’,‘client:BPELProcessRequestclient:userid’, ‘mail’ If realmName is not specified, then the default realm name is used. For example, if the default realm name is jazn.com, the following XPath expression searches for the user in the jazn.com realm: ids:getUserPropertyjcooper, mail; The following XPath expression provides the same functionality as the one above. In this case, however, the realm name of jazn.com is explicitly specified: ids:getUserPropertyjcooper, mail, jazn.com;

16.3.6 How to Select Notification Recipients by Browsing the User Directory

You can select users or groups in Oracle JDeveloper to whom you want to send notifications by browsing the user directory for example, Oracle Internet Directory that is configured for use with Oracle BPEL Process Manager. Click the Search icon to the right of the following fields to open the Identity Lookup dialog: ■ To field on the Email and IM dialogs Table 16–7 Properties for the Dynamic User XPath Function Property Name Description mail Look up a user’s email address. telephoneNumber Look up a user’s telephone number. mobile Look up a user’s mobile telephone number. homephone Look up a user’s home telephone number. 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.