Administration Guide › Email Notifications › How to Use Email Templates › Custom Email Templates › Email Template API › util

util

Utility object.

Method:

• getNotifiers(String [,String])

  Returns email IDs based on a notification rule.

  The first argument supports the following predefined notification rules, enclosed in quotes:

  • "ADMIN". Sends the email to the administrator who initiated the task.
  • "USER". Sends the email to the user in the current context.
  • "USER_MANAGER". Sends the email to the manager of the user in the current context.

  You can also reference a custom notification rule that you create with the Notification Rule API. For information, see the Programming Guide for Java.

  The second argument is optional. You can use it to pass one or more user-defined name/value pairs into a custom notification rule. Separate each name/value pair with a comma, in the following format:

  "name1=value1,name2=value2,..."
  

Examples:

<% 
_to = _util.getNotifiers("ADMIN");
_cc = "";
%>
<% 
_to = _util.getNotifiers("MYRULE","type=loan,district=3");
_cc = "";
%>

Notifying a User’s Manager

You can use the USER_MANAGER notification rule to send email to any user’s manager. CA IdentityMinder uses this rule in the email templates supporting user entitlement certification.

Note: The USER_MANAGER Notification Rule only applies to events or tasks that create or manage a single user.

Because there are a number of different ways a user-to-manager relationship can be specified within a user directory, the default User Manager Notification Adapter resolves this relationship based on an attribute expression specified in the second parameter of the getNotifiers() method.

Example:

<% 
_to = _util.getNotifiers("USER_MANAGER","ManagerLookup=managerattribute");
_cc = "";
%>

The User Manager Notification Adapter supports two look-up options:

• managerattribute = <Manager AttributeName>- where the User object maintains an attribute that indicates the DN or UserID of that user’s manager
• commonattribute = <AttributeName> - where the user and the user’s manager share a common attribute value, such as "department"

You configure these lookup options in the Miscellaneous Properties for an environment in the CA IdentityMinder Management Console.

To configure the USER_MANAGER notification rule:

1. In the CA IdentityMinder Management Console, select CA IdentityMinder Environments. Then, select the environment for which you are configuring email notification.
2. Select Advanced Settings>Miscellaneous Properties.
3. In the Miscellaneous Properties page, complete the configuration steps for the lookup option that you want to use:
   • To use the managerattribute=<Manager AttributeName> lookup option:
     1. In the Property field, enter managerattribute.
     2. In the Value field, enter the attribute that stores the manager’s DN or user ID.
     3. Click Add.
     4. Click Save.
   • To use the commonattribute=<AttributeName> lookup option:
     1. In the Property field, enter commonattribute.
     2. In the Value field, enter the attribute that the user and the user’s manager have in common.
     3. Click Add.
     4. In the Property field, enter
        ismanagerfilter.
     5. In the Value field, enter a search expression using the following syntax:

        <attribute> <operator> <filter>

        For example, title EQUALS manager

     6. Click Add.
     7. Click Save.

You can also write a custom adapter and create your own rules for notifying a user’s manager. See the Programming Guide for Java.