10.2 Finish Activity

The Finish activity marks the completion of a workflow. When the Finish activity executes, Workflow Builder sends an email message to notify participants that the workflow has finished.

10.2.1 Properties

The Finish activity includes the following properties:

Table 10-3 Finish Activity Properties




A unique string value that identifies the activity. Workflow Builder generates this value automatically in the <Activity>_<N> format, where <Activity> represents the name of the activity and <N> represents an alphanumeric value that contains seven characters.


Provides a name for the activity.

Notify by E-Mail

Provides a method of triggering an email notification when you execute the Finish activity. Set the property to “True”, to send email notifications.

See Email Template for information about setting up the email notification.

10.2.2 Data Items

Data items are not supported with this activity.

10.2.3 Email Template

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

Table 10-4 E-Mail Notification Settings for the Finish Activity



E-Mail Template

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

You can edit an email template from the console. See Editing an email template: for more information.


Specifies that this email message is a notification email.

Show Default Tokens

Displays the following default tokens:

  • TO

  • CC

  • BCC


  • TO_DN

  • CC_DN

  • BCC_DN


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 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” email template are listed below:

  • TO

  • CC

  • BCC


  • TO_DN

  • CC_DN

  • BCC_DN

  • 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). You can modify these expressions to suit your application requirements.

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


  • 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 Approval activity is set to “True”.

  • 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 duplicate notification emails to the target users.

10.2.4 Problems

The Problems tab provides details of the errors and warnings associated with the activity in a workflow. For more information about validating workflow activities, see Validating a Workflow.