You are here: Configuration > Configuration Panes > Math Pane > ActivityArray

ActivityArray

The ActivityArray math variable is an arrangement of one or more Activity type math objects. Once field values are set using the Activity Math variable, the object is added to the ActivityArray Math variable to be used in the spawn section of the parent transaction.

$ActivityArray Math Variable in the Rules Palette$

ActivityArray Math Variable in Palette

Note: For a comprehensive explanation of the characteristics of this math variable, refer to the XML Configuration Guide in the Help menu.

Define the ActivityArray Math Variable

Drag and drop the ActivityArray Math variable from the Palette window onto the Math Pane. Enter the following information for the math variable.

Type a name in the Name field. This is required.
The data types must be Activity.
Make sure variable type is defined as ActivityArray. This is required.
The applicable Operation selections are: Create, Append, and Insert. You must Create the ActivityArray first before you can feed the array into the Spawn section of the parent transaction. Once the array is created, you can then Insert an object in to the array. Insert allows you to specify an Index or location where you want to place the object. The Index property must be populated when using the Insert Operation. Append will place the object at the end of the array.

Note: You may utilize Aggregate Function methods Count and Index with use of an ActivityArray.

Count: Returns the number of records in the array.

Index: Returns the value of the specific number element. Indexing allows the system to identify the value by the elements location, we can then use the value for storage, a subsequent calculation, or display purposes.

For example, creating a Disbursement spawn activity array will use a Count of the number of Payee records. Index will return an Activity math object from the referenced location of the array. You must designate the Index value as the numeric location of the object. If there is no object at the referenced index or the array is empty, no value will be returned. Defining a default value object may be required for system stability.

Math Loop with Activity and ActivityArray:In order to populate the array with more than one Activity math object, a standard loop can be used (optional).

Steps include: Create the ActivityArray, Begin the MathLoop, Create the Activity Object, Set Value of the Activity Object, Add the object to the ActivityArray, and Close the MathLoop.
Note: The ActivityArray variable must be instantiated outside of the loop and the Activity object math object inside the loop.

Check-in the transaction to save the information to the database.