Recipients
Recipients include users and groups in the Informatica domain that receive the notification during the workflow. Select the recipients in the Notification tab.
You can select users and groups from native and LDAP security domains. The Developer tool displays selected users and groups using the following format:
<security domain name>\<user login name or group name>
When you configure a user to receive an email notification, the Notification task sends an email to the user at the email address that the user account properties specify. When you configure a group to receive an email notification, the Notification task sends an email to all users in the group at the email addresses that the user account properties specify.
If a user account email address is not valid, the Notification task runs and reports back to the domain that the email address is undeliverable. The Notification task sends an email to the address that the Email Service specifies to indicate the delivery failure.
You can use the Administrator tool to enter an email address for native user accounts. You cannot use the Administrator tool to enter an email address for LDAP user accounts. If the user account information imported from the LDAP directory service includes an email address, the Notification task can send an email to the user at that email address.
You can select a recipient multiple times by selecting a user and then selecting a group that the user belongs to. When the Notification task sends the email, the duplicated recipient receives multiple emails or a single email based on how the email server handles duplicate recipients.
When you configure the email properties for a Notification task, you can enter user and group names in the address fields and configure dynamic recipients. Dynamic recipients are users and groups that you define in workflow parameters or variables.
Selecting Recipients
Add users and groups to the recipient list when you want to send a notification to the users and groups.
You can add users and groups to the recipient list from the Notification task recipient list or from the email properties. Any users or groups that you add in one location also appear in the other location. You can type user and group names and configure dynamic recipients from the email properties only.
When you add users or groups, you can use a search filter. Enter a string to search for users or groups. You can use wildcard characters in the string. The Developer tool returns all names that contain the search string. The string is not case sensitive.
1. Select the Notification task in the editor.
2. In the Properties view, click the Notification tab.
3. Select Recipients.
4. Click Choose.
The Select Users and Groups dialog box appears.
5. Enter the filter conditions to search for users or groups.
To view the users within a group, select the group and click View Users in Group.
6. Select a user or group name.
Use the Ctrl or Shift key to select multiple names.
7. Click OK.
Configuring Notification Types for Recipients
To configure a recipient to receive an email notification, select the email address fields for the recipient.
1. Select the Notification task in the editor.
2. In the Properties view, click the Notification tab.
3. Select Recipients.
4. Select a user, group, or dynamic recipient in the recipients list.
5. In the Email column, select To, Cc, or Bcc.
Typing Recipient Names
When you configure the email properties for a Notification task, you can type user and group names in the address fields.
When you type user and group names in address fields, use the following format:
<security domain name>\<user login name or group name>
For example, type Native\adietrich to specify the user in the native security domain with an adietrich login name.
If you do not specify a security domain name, the Developer tool uses the native security domain.
1. Select the Notification task in the editor.
2. In the Properties view, click the Notification tab.
3. Select Email under Notification Types.
4. In one of the address fields, enter a user or group name using the required format.
Enter multiple recipient names separated by a semicolon.
Dynamic Email Recipients
Use workflow parameters and variables to dynamically define email recipients.
When you configure recipients in the email properties, use the Dynamic Recipients tab to select workflow parameters and variables that define user and group recipients. You cannot type a parameter or variable name in the address fields.
The following table describes the types of parameters and variables that you can use to define dynamic recipients:
Parameter or Variable Type | Description |
|---|
Workflow parameters | Use a string workflow parameter to define the user or group name in a parameter file when you run the workflow. |
System workflow variables | Use the UserName system workflow variable to send an email to the user that runs the workflow. |
User-defined workflow variables | Use a user-defined string workflow variable to dynamically assign a user or group name using an Assignment task in the workflow. |
When you define a user or group name in a parameter file or in an Assignment task, enter a single user or group name for the value. Use the following syntax for the value:
<security domain name>\<user login name or group name>
For example, enter Native\Developers to specify the Developers group in the native security domain.
If you do not specify a security domain name, the Data Integration Service uses the native security domain. The Data Integration Service first attempts to find the specified name in the list of groups. If the name is not a group, the service then attempts to find the name in the list of users.
Configuring Dynamic Email Recipients
Use workflow parameters and variables to configure dynamic email recipients.
1. Select the Notification task in the editor.
2. In the Properties view, click the Notification tab.
3. Select Email under Notification Types.
4. Click To.
The Email Properties dialog box appears.
5. Select Recipients, and then click Dynamic Recipients.
6. Click New.
The Developer tool adds an empty row to the recipients list.
7. Click in the Recipients column, and then select an existing parameter or variable, or a new parameter or variable.
- - Select a workflow parameter or variable name.
- - Click New Parameter or New Variable. In the Add Parameter or Add Variable dialog box, enter the name and type of the parameter or variable. Enter a default user or group name for a parameter. Or, enter an initial user or group name for a variable. The Developer tool creates the workflow parameter or variable and adds it to the dynamic recipient list.
8. In the Email column, select To, Cc, or Bcc.
9. Click OK.
The Notification task recipient list displays the workflow parameter or variable under Dynamic Recipients.