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 notificationAn Automation Engine object type used to send messages to users and user groups. [Formerly called "CallOperator."]

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 variableA placeholder for a value within a script.

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 scriptA particular Automation Engine object type. functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… 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 runtimeThe duration of a task's execution. It refers to the period between a task's start and end. It does not include its activation period (see also: activation and start).
: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 taskAn executable object that is running. Tasks are also referred to as activities.'s attributes during generation.

Script Elements - Read or Modify Objects

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH