How to Select Email Addresses and Telephone Numbers Dynamically

You can set email addresses or telephone numbers dynamically based on certain process variables. You can also look up contact information for a specific user using the built-in XPath functions for the identity service:

To get the email address or telephone number directly from the payload, use the following XPath expression:
```
bpws:getVariableData('<variable name>', '<part>','input_xpath_to_get_an_address')
```
For example, to get the email address from variable inputVariable and part payload based on XPath /client/BPELProcessRequest/client/mail:
```
<%bpws:getVariableData('inputVariable','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:getUserProperty(userName, 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 17-6 lists the property names that can be used with this XPath function.

Table 17-6 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.

The following example gets the email address of the user identified by the variable inputVariable, part payload, and queries /client:BPELProcessRequest/client:userID:

ids:getUserProperty(bpws:getVariableData(‘inputVariable',
‘payload',‘/client:BPELProcessRequest/client: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:getUserProperty('jcooper', '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:getUserProperty('jcooper', 'mail', 'jazn.com');