Novell Doc: User Application: Design Guide

7.9 E-Mail Activity

The E-Mail activity provides a way to send an e-mail to interested parties outside of an approval process.

7.9.1 Properties

The E-Mail activity has the following properties:

Table 7-18 E-Mail Activity Properties

Property Name	Description
Name	Provides a name for the activity.
Notify by E-Mail	Specifies whether this activity should send e-mail notifications. Set to True to notify by e-mail; otherwise, set to False. You specify the e-mail to send by using the E-Mail Notification tab (see Section 7.9.3, E-Mail 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).

Property Name

Description

Name

Provides a name for the activity.

Notify by E-Mail

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

You specify the e-mail to send by using the E-Mail Notification tab (see Section 7.9.3, E-Mail 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 E-Mail Notification

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

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

Setting	Description
E-Mail Template	Specifies the name of the e-mail template to use. By default, the Approval activity uses the Provisioning Notification template. You can edit an e-mail template in Designer. For more information, see Editing an e-mail template:.
Source/Target	Specifies the source expressions for target tokens in the e-mail body. The list of target tokens is determined by the selected e-mail 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 CC BCC REPLYTO 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. NOTE: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. For details on building ECMA expressions, see Section 9.0, Working with ECMA Expressions.

Setting

Description

E-Mail Template

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

You can edit an e-mail template in Designer. For more information, see Editing an e-mail template:.

Source/Target

Specifies the source expressions for target tokens in the e-mail body.

The list of target tokens is determined by the selected e-mail 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
CC
BCC
REPLYTO
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.

NOTE: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.

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

NOTE:E-mail 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.