Array - Set

Declaration

<AMARRAY ACTIVITY="set" NAME="text"><SETTER VARIABLE="text" 
VALUE="text" /><SETTER /></AMARRAY>

Description: Sets the values of one or more elements in array.

Practical Usage

Changes the values of an array.

General Parameters

Property

Type

Required

Default

Markup

Description

Array name

Text

Yes

(Empty)

NAME="Array_Name"

The name of the array to set.

Variable

Text

Yes

(Empty)

SIZE="23"

The new size of the right-most boundary of the array.

Value

Text

Yes

(Empty)

VAUE="theValue"

The value to set the index to. As with all parameters, this value may be literal or an expression (if surrounded by percent % signs). To add a new index/value pair, click the Click here to add new row check box.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Example

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Create a double-dimensioned array of size 1 x 2 named "theArray."

<AMARRAY ACTIVITY="set" NAME="text" STARTINDEXZERO="YES">
<SETTER INDEX="sampleIndex1" VALUE="text1" />
<SETTER INDEX="sampleIndex2" VALUE="text2" />
</AMARRAY>