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