GET_ATT_PLAIN

Script function: Supplies the value of a task's attributes during its generation. Variables are not resolved.

Syntax

GET_ATT_PLAIN (Attribute)

Syntax

Description/Format

Attribute

Name of the attribute whose value should be read.
Format: AE name, script literal or script variable


Return code

Value of the specified attribute.

Comments 

This script function can be used to read an object's attributes during the generation process. Its behavior is similar to the behavior of the script element GET_ATT with the difference being that script, object and predefined variables are not replaced by values in the attribute. Therefore, the variable name is retrieved instead of its value. GET_ATT always resolves these variables.

Placeholders for Variable objects that are enclosed in curly brackets {} are supplied with values neither in GET_ATT nor in GET_ATT_PLAIN.

As of version 9.00A, the attribute dialog reads the attributes using the script function GET_ATT_PLAIN. The dialog now always displays the attributes' actual content instead of the replaced variable value.

For more detailed information, see GET_ATT.

Example

The following example writes a script variable's name to an attribute and assigns a value to it. The attribute's content is then retrieved with and without the replaced variable value. The corresponding information is written to the activation protocol.

:PUT_ATT INT_ACCOUNT = "&&test#"
:SET &test# = "test"
:SET &att# = GET_ATT(INT_ACCOUNT)
:SET &attplain# = GET_ATT_PLAIN(INT_ACCOUNT)
:PRINT "Variable name = &attplain#"
:PRINT "Variable value = &att#"

See also:

Script Element Description
:ADD_ATT Adds recipients to a Notification object at runtime.
:REMOVE_ATT Removes recipients from a Notification object at runtime.
:PUT_ATT Changes an attribute's value during the generation process.
:PUT_ATT_APPEND Extends the notification's message text at runtime.
GET_ATT Supplies the value of a task's attributes during the generation process.
GET_ATT_SUBSTR Supplies part of a notification's message text.