7.9 Email Activity

The Email activity provides a way to send an email to interested parties outside of an approval process.

7.9.1 Properties

The Email activity has the following properties:

Table 7-19 Email Activity Properties

Property Name

Description

Name

Provides a name for the activity.

Notify by E-Mail

Specifies whether this activity should send email notifications. Set to True to notify by email; otherwise, set to False.

You specify the email to send by using the E-Mail Notification tab (see Email Notification).

To use this feature, the Notify participants by E-Mail parameter for the provisioning request definition must be set to true (see Table 4-3, Overview Properties).

7.9.2 Data Item Mapping

Not supported with this activity.

7.9.3 Email Notification

To enable email notification for this activity, you need to specify the email template to use, as well as source expressions for target tokens in the email body.

Table 7-20 E-Mail Notification Settings for the E-Mail Activity

Setting

Description

E-Mail Template

Specifies the name of the email template to use. By default, the Approval activity uses the Provisioning Notification template.

You can edit an email template in Designer. For more information, see Editing an email template:.

Source/Target

Specifies the source expressions for target tokens in the email body.

The list of target tokens is determined by the selected email template. You cannot add new tokens, but you can assign values to the tokens by building your own source expressions. At runtime, source expressions are evaluated to determine the value of each token.

The available target tokens are listed below:

  • TO

    To specify multiple recipients, use the following syntax:

    'mail1@domain1.com||mail2@domain1.com'

  • CC

  • BCC

  • REPLYTO

  • TO_DN

  • CC_DN

  • BCC_DN

  • recipientFullName

  • initiatorFullName

  • requestTitle

  • userFirstName

If you use a provisioning request definition template to create your workflow, each token has a default source expression. The default expressions retrieve values from the workflow process (the process object) or from the data abstraction layer (IDVault object). You can modify these expressions to suit your application requirements.

For details on building ECMA expressions, see Section 9.0, Working with ECMA Expressions.

NOTE:

  • Email notification is supported only when the Notify participants by E-Mail check box is selected on the Overview tab, and the Notify by E-Mail property for the activity is set to True.

  • When you create a workflow for use with the Resource Request portlet, and you use the “_default_” as the expression for the TO token, the addressee expression must be an IDVault expression.

  • If you create an activity using any of the target tokens TO_DN, CC_DN, or BCC_DN, you must specify a user’s DN or an expression that resolves to a user’s DN as the source expression for the token.

  • If you create an activity using both the target tokens TO and TO_DN, the workflow sends out duplicate notification emails to the target users.