Send Email Notification

Users

(Array of Users). Users who are to receive the email.

Note:

You can specify the recipients of the email using the Users parameter, the Groups parameter, or both.

Groups

(Array of Groups). Groups whose users are to receive the email.

Note:

CentraSite will only send the email to those users in the group whose CentraSite user account includes an email address.

Subject

(String). The text that you want to appear in the email's subject line. This text can include substitution tokens to insert run-time data into the subject line.

Use Email Template

(Email Template). Specifies the template that is to be used to generate the body of the email message.

Note:

You can use the predefined template, ChangeNotification.html, as your email template if you do not want to create an email template of your own.

If you use an email template to generate the body of the message, you cannot specify the body of the message using the Custom Message parameter. (In other words, you specify the body of the message using either the Use Email Template or the Custom Message parameter.)

Custom Message

(TextArea). The text of the email message. This text can include substitution tokens to insert run-time data into the message.

Note:

If you use the Custom Message parameter to specify the body of the email message, you cannot generate the body of the message using an email template. (In other words, you specify the body of the message using either the Custom Message or the Use Email Template parameter.)

Format

(String). Specifies whether the custom mail message is formatted as HTML or plain text.

Include owner in notification

(Boolean). When enabled, this parameter sends the email notification to the owner of the object on which the policy is acting in addition to the users specified by the Users and Groups parameters.

This token...

Inserts the following information into the parameter value at execution time...

${api.usage}

This token is replaced with the value specified in the API Usage attribute of API.

${entity.approver}

The name of the user who approved or rejected the approval request.

Note:

This token is only meaningful in email messages that are issued by the Initiate Approval or Initiate Group-dependent Approval actions. If it is used in a context where there is no approver or approval request, the token is simply replaced with a space.

${entity.approvercomments}

The comment provided by the approver when he or she approved or rejected the approval request.

Note:

This token is only meaningful in email messages that are issued by the Initiate Approval or Initiate Group-dependent Approval actions. If it is used in a context where there is no approval request, the token is simply replaced with a space.

${entity.attribute.

attributeName}

The value of the attribute specified in attributeName. You can use this token with all attribute types (including computed types) except Classification, File, and Relationship types.

Important:

You must specify the attribute's schema name in attributeName, not its display name. .

${entity.BUIAssetURL}

A link to the URL of the asset details page in CentraSite Business UI.

${entity.BUIBaseURL}

A link to the URL of the CentraSite Business UI.

${entity.description}

The object's description.

Note:

Users do not have a Description attribute.

${user.displayname}

The display name of the user who triggered the policy.

${entity.key}

The object's key (that is, the UUID that uniquely identifies the object within the registry).

${entity.name}

The object's name (in the user's locale).

${entity.owner}

The name of the user who owns the object against which the policy is acting.

${entity.type}

The type of object against which the policy acting.

${entity.state}

The state of the object against which the policy is acting.

If the object is an Asset, Policy, or Lifecycle Model, this action inserts the object's current lifecycle state. For all other object types, this token is ignored.

${entity.URL}

The URL for the object on which the policy is acting. (This is the URL that opens the object in CentraSite Control.)

${entity.version}

The object's user-assigned version identifier.

${event.type}

The type of event that triggered the policy.

${from.state}

The state from which the object is being switched (if the policy is executing on a Pre-State Change or Post-State Change event).

${target.state}

The state to which the object is being switched (if the policy is executing on a Pre-State Change or Post-State Change event).

${user.locale}

The locale of the user who triggered the policy.

${user.name}

The name of the user who triggered the policy.

${user.organization}

The name of the organization to which the user who triggered the policy belongs.