Automation Engine Script Guide > Ordered by Function > Read or Modify Objects > :ADD_ATT

:ADD_ATT

Script statement: Adds recipients to a notification at runtime.

Syntax

:ADD_ATT RECIPIENT, Recipient, [Calendar, Calendar Keyword]

Syntax

Description/Format

RECIPIENT

Name of the attribute that should be added.
Format: AE name, script literal or script variable
Allowed value: "RECIPIENT"

Recipient

Name of a user, user group or email address.
Format: script literal or script variable

Calendar

Name of a Calendar object.
Format: script literal or script variable

Calendar Keyword

Calendar keyword within this calendar.
Format: script literal or script variable

Comments

This script statement can only be used in the Process tab of a notification. It adds the specified user, user group or email address to the list of recipients that should be notified. Calendars can also be specified. In this case, the recipient is only notified if a defined calendar keyword applies.

Recipients that have already been specified are overwritten because this script statement does not change the Notification object. The modified recipient list only applies for the particular execution.

Refer to the report to see the recipients that have been added by this script statement.

Note that the user must be indicated in the format User name/Department which complies with the name of the User object.

Example

The following example adds the user "BU/AE" to the list of responsible recipients in a notification. This user is only notified if a valid calendar day exists in the calendar "READINESS".

:ADD_ATT RECIPIENT, "BU/AE", "READINESS","WEEKDAYS"

The second example informs all members of the user group "ADMIN".

:ADD_ATT RECIPIENT, "ADMIN"

 

See also:

Script element Description

:REMOVE_ATT

Removes recipients s in a notification at runtime.
:PUT_ATT This is used to change the value of an attribute during generation.
:PUT_ATT_APPEND Extends the notification's message text at runtime.
GET_ATT This function returns the values of a task's attributes during generation.
GET_ATT_SUBSTR

Supplies part of the message text in a notification.

Script Elements - Read or Modify Objects

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function