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. Starting with v11, if you specify a length greater than the actual length of the message text, you will get an error message.

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.

Starting with v11, if you specify a length greater than the actual length of the message text, you will get an error message.

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.