Send Email from Template
Generates an e-mail notification by using a SMTP notification configuration object, e-mail template object, and replacement tokens. It reads the target SMTP server along with the credentials for authentication (except for the password, which when needed is specified by <arg-password>) and the originating address from the SMTP notification configuration object. If e-mail sender’s address is specified, the action overrides the originator's address specified in the e-mail server configuration. The subject and e-mail message are created using the template object and template replacement tokens. Replacement tokens are declared within an <arg-string> element and tag name attribute. The value of <arg-string>'s tag attribute is interpreted as html, if the attribute is enclosed within <use-html>...</use-html> tags. Reserved replacement tokens specify the various recipient addresses. If a policy containing this action encounters an error, Designer generates this error as a local variable: error.do-send-email-from-template. For more information about local error variables, see Local Variable Selector.
Fields
- Disabled
-
Specify whether the action is enabled or disabled, where true indicates enabled and false indicates disabled. The default value is false.
- Notification DN
-
Specify the slash form DN of the SMTP notification configuration object. Supports variable expansion. For more information, see Variable Selector.
- No Trace
-
Specify whether this action should be traced during the execution of the policy. The default value is false, which disables the trace.
- Template DN
-
Specify the slash form DN of the e-mail template object. Supports variable expansion. For more information, see Variable Selector.
- Password
-
(Optional) Specify the SMTP server account password. Select the icon
to open the Argument Builder and specify the password argument.IMPORTANT:You can store the SMTP server account password as a Named Password on the driver object. This allows the password to be encrypted; otherwise, you enter the password and it is stored in clear text. For more information on Named Passwords, see
Downloading Identity Manager Policies
in the NetIQ Identity Manager Understanding Policies Guide. - Strings
-
Specify additional string arguments for the e-mail message. You can enter the strings manually, or select the icon
to open the Named String Builder and specify the strings. For more information about the Named String Builder, see Named String Builder.Send Email from Template supports the following string arguments that you can use to specify the various e-mail addresses.
String Name
Description
from
Specifies the address of the sender of the e-mail.
NOTE:This string argument is not available in the Policy Builder user interface of this version.
to
Adds the address to the list of e-mail recipients. Multiple instances are allowed. Can contain a comma-separated list of recipients.
cc
Adds the address to the list of CC e-mail recipients; multiple instances are allowed. Can contain a comma-separated list of recipients.
bcc
Adds the address to the list of BCC e-mail recipients; multiple instances are allowed. Can contain a comma-separated list of recipients.
attachment
Adds an attachment to the e-mail. Multiple attachments to a single e-mail are allowed.
NOTE:This string argument is not available in the Policy Builder user interface of this version.
reply-to
Specifies the address to be used as the e-mail message reply address.
encoding
Specifies the character encoding to use for the e-mail message.
custom-smtp-header
Specifies a custom SMTP header to add to the e-mail message.
In addition to the reserved field names listed above, Send Email from Template supports Global Configuration Values (GCVs) for creating the desired string.
NOTE:To include HTML in a string argument, you can enclose the HTML in the <use-html></use-html> tags within the string. The HTML enclosed by the tags must comply with the XHTML standard.
Each template can also define fields that can be replaced in the subject and body of the e-mail message.
Example
