|
GET_ATT |
Read or Modify Objects |
GET_ATT_SUBSTR |
|
Script function: Supplies the value of a task's attributes during its generation. Variables are not resolved.
GET_ATT_PLAIN(Attribute)
|
Syntax |
Description/Format |
|---|---|
|
Attribute |
Name of the attribute whose value should be read. |
|
Return code |
|---|
|
Value of the specified attribute. |
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.
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. |
Script Elements - Read or Modify Objects
Sample Collection
Notification with Variable Message Text
About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function