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

GET_ATT_SUBSTR

Script Function: Supplies part of the message text in a notification

Syntax

GET_ATT_SUBSTR(CALL_TEXT, Begin, Length)

Syntax

Description/Format

CALL_TEXT

Name of the attribute whose value should be partially read
Format: AE name and script variable
Allowed value: "CALL_TEXT"

Begin

Position where reading should be started
Format: Number or script variable

Length

Number of characters to be read
Format: Number or script variable.


Return codes

Part of the message text
" " - The specified area is not within the message text.

Comments

This script function can only be used in the Process tab of a notification. It supplies part of the message text in a notification.

If the statement :PUT_ATT_APPEND is written before this script function, the part is taken from the extended message text.

Example

The following example shows how to read the first 20 characters of the message text.

:SET &SECTION# = GET_ATT_SUBSTR(CALL_TEXT,1,20)

 

See also:

Script element Description

:ADD_ATT

Adds recipients to a notification at runtime
:REMOVE_ATT Removes recipients 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.

Script Elements - Read or Modify Objects

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by function