电子邮件通知 › 如何使用电子邮件模板 › 自定义电子邮件模板 › 电子邮件模板 API › _util

_util

实用工具对象。

方法：

• getNotifiers(String [,String])

  基于通知规则返回电子邮件 ID。

  第一个参数支持以下预定义的通知规则（括在引号中）：

  • “ADMIN”。 将电子邮件发送给启动任务的管理员。
  • “USER”。 将电子邮件发送到当前上下文的用户。
  • “USER_MANAGER”。 将电子邮件发送到当前上下文的用户的管理员。

  您也能引用使用通知规则API 创建的自定义通知规则。  有关信息，请参阅《Programming Guide for Java》。

  第二个参数是可选的。 您可以使用它来将一个或多个用户定义的名称/值对传递到自定义通知规则中。 使用逗号分开每个名称/值对，格式如下：

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

示例：

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

通知用户的管理员

您可以使用 USER_MANAGER 通知规则来向任何用户的管理员发送电子邮件。 Identity Manager 在支持用户授权认证的电子邮件模板中使用此规则。

注意：USER_MANAGER 通知规则仅仅适用于创建或管理单一用户的事件或任务。

因为在用户目录中有多种不同方法可以指定用户－管理员关系，默认用户管理者通知适配器通过在 getNotifiers() 方法的第二个参数中指定一个属性表达式解析此关系。

示例：

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

用户管理者通知适配器支持两个查找选项：

• managerattribute = <Manager AttributeName>－其中用户对象保留表示该用户的管理员的 DN 或 UserID 的属性
• commonattribute = <AttributeName>－其中用户和用户的管理员共享通用属性值，如“department”

在 Identity Manager 管理控制台环境的“Miscellaneous Properties”（杂项属性）中，可以配置这些查找选项。

要配置 USER_MANAGER 通知规则，请按以下步骤操作：

1. 在 Identity Manager 管理控制台中，选择“Identity Manager Environments”（Identity Manager 环境）。 然后，选择您要配置电子邮件通知的环境。
2. 依次选择“Advanced Settings”（高级设置）、“Miscellaneous Properties”（杂项属性）。
3. 在“Miscellaneous Properties”（杂项属性）页面中，完成希望使用的查找选项的配置步骤：
   • 要使用 managerattribute=<Manager AttributeName> 查找选项：
     1. 在“Property”（属性）字段中，输入“managerattribute”。
     2. 在“Value”（值）字段中，输入存储管理员 DN 或用户 ID 的属性。
     3. 单击“Add”（添加）。
     4. 单击“Save”（保存）。
   • 要使用 commonattribute=<AttributeName> 查找选项：
     1. 在“Property”（属性）字段中，输入“commonattribute”。
     2. 在“Value”（值）字段中，输入用户和用户管理员共有的属性。
     3. 单击“Add”（添加）。
     4. 在“Property”（属性）字段中，输入：
        ismanagerfilter。
     5. 在“Value”（值）字段中，使用下列语法输入搜索表达式：

        <attribute> <operator> <filter>

        例如，标题 EQUALS 管理员

     6. 单击“Add”（添加）。
     7. 单击“Save”（保存）。

您也可以编写自定义适配器，并且创建自己的用户管理员通知规则。 请参阅《Programming Guide for Java》。