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>