7.14 Finish Activity

The Finish activity marks the completion of a workflow. When the Finish activity executes, an e-mail message is sent to notify participants that the workflow has finished.

7.14.1 Properties

The Finish activity has the following properties:

Table 7-25 Finish Activity Properties

Property

Description

Activity Id

Specify a unique string value that identifies the activity. Activity Ids are written to the user application’s log file. Specifying a meaningful Activity Id makes it easier to understand the data written to the logs. You can specify letters, numbers, and the underscore (_) character.

If you do not specify a value, the Activity Id defaults to ActivityNN where the NN represents the order in which the activity was added to the workflow.

Name

Provides a name for the activity.

Notify by E-Mail

Provides a method of triggering an e-mail notification when the Finish activity is executed. When this property is set to True, an e-mail notification is sent. When this property is set to False, no e-mail notification is sent.

See Section 7.14.3, E-mail Notification for information about setting up the e-mail notification.

7.14.2 Data Item Mapping

Not supported with this activity.

7.14.3 E-mail Notification

To enable e-mail notification for the Finish 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-26 E-Mail Notification Settings for the Finish Activity

Setting

Description

E-Mail Template

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

You can edit an e-mail template in Designer. See Editing an e-mail template: for more information.

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 predefined tokens by building your own source expressions. At runtime, the source expressions are evaluated to determine the value of each token.

The available target tokens for the Provisioning Approval Completed Notification e-mail template are listed below:

  • TO

  • CC

  • BCC

  • REPLYTO

  • requestStatus

  • requestSubmissionTime

  • requestID

  • recipientFullName

  • initiatorFullName

  • requestTitle

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 _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.