STRINGARRAY

A set of methods determined by the OPERATION type that performs math operations on arrays of text values.

STRINGARRAY Elements and Attributes
TYPE=STRINGARRAY
Element	Attributes	Attribute Value	Element Value	Definition
<MathVariable>	TYPE	STRINGARRAY
	OPERATION	APPEND	A variable or string literal whose value is appended to array SOURCEARRAY.	Results in new array equal to array indicated by SOURCEARRAY attribute with element value appended. Note: If the SOURCEARRAY attribute is specified, the name must be the same as the name of the specified VARIABLENAME.
		COPY		Takes a SOURCEARRAY attribute and creates a separate but identical array.
		CREATE	A literal value or math variable whose value is the length of a newly created array.	A new array with the length equal to the element value and each value defaulting to the value of DEFAULT attribute.
		EXPAND	Use the MULTIPLIER attribute to indicate the number of times each element of the original array should be duplicated. The first and last elements may have a different number of duplicates than the other elements, so this attribute's value can be a comma delimited list of, at most, three values. If only one value is supplied, the others are defaulted to that value.	Creates an array by duplicating each element of the original array a given number of times. As a comma delimited list of three multiplier values: The first multiplier indicates the number of times that the first element of the array is repeated. The middle multiplier indicates the number of times that all elements other than the first and last elements are repeated. The last multiplier indicates the number of times that the last element of the array is repeated.
		FILLBY-DEPOSIT		Fill an array with deposit ValuationGUIDs related to a specific FundGUID.
		FILLBY-FUND		Fill an array with a list of FundGUIDs obtained from the valuation.
		FILLBY-ALLOCATIONFROM		Fill an array with a list of FundGUIDs having negative values obtained from the allocation.
		FILLBY-ALLOCATIONTO		Fill an array with a list of FundGUIDs having positive values obtained from the allocation.
		FILLBY-LIST	Comma separated list of string constants and/or variable names.	Fills the array with the values entered.
		FILLBY-SQL	A valid SQL statement that returns one or more string values.	Creates an array of the resulting data returned by a SQL statement. The SQL statement must return one column with any number of rows.
		FILLBY-STOREDPROCEDURE		Fills the math variable with an array returned from the named stored procedure. This attribute requires PROCEDURENAME and a list of parameters where applicable.
		INSERT	A variable or string literal whose value is to be inserted into the array at INDEX.	Results in the new array equal to the array indicated by SOURCEARRAY attribute with an element value inserted/placed into the array at the index indicated by the INDEX attribute.
		REMOVE		Results in an array identical to SOURCEARRAY with the element at INDEX removed.
		REPLACE	A variable or integer to replace one or more of the elements of the current array.	Replaces a value at the specified array position with the element’s value. The INDEX attribute will either have one index value or two index values separated by a comma. If INDEX contains only one value, the element at that index is replaced by the value provided by the math variable. If INDEX contains two values, the elements from the first index to and including the second index are replaced by the value provided by the math variable. Note: If the SOURCEARRAY attribute is specified, the name must be the same as the name of the specified VARIABLENAME.
		SETMAX	A variable or string literal.	Results in the new array where each element is the larger of the corresponding element from SOURCEARRAY and the string element value.
		SETMIN	A variable or string literal.	Results in the new array where each element is the smaller of the corresponding element from SOURCEARRAY and the string element value.
		STRIDE	A variable or integer literal.	Results in the new array containing every 'nth' element in the SOURCEARRAY where n is the element value.
		TRANSFORM	Any valid expression. If the array elements are to be updated by using their current value in the calculation, use the name of the array in place of that value. If the value is just the name of another array variable, then that array is copied.	Performs the indicated calculation to every element of the referenced array(s) and stores each result in the math variable which is also an array. When multiple arrays are used, they must have the same length.
		FILLBY-FINANCIALENTRY
		STARTDATE	Date value from MathVariable of type DATE	Optional: Allowed only with FILLBY-FINANCIALENTRY to filter records on and after a certain date. End Date is not a required attribute if using Start Date. If the attribute is present and value is NULL, the attribute will be ignored
		ENDDATE	Date value from MathVariable of type DATE	Optional: Allowed only with FILLBY-FINANCIALENTRY to filter records on and before a certain date ,StartDate attribute is not required if using end date. If the attribute is present the value is NULL, the attribute will be ignored.
	CONTEXT	MATH		Optional. Defines a valuation object from which to retrieve data. This indicates that data will NOT be retrieved from the activity valuation.
<Parameters>				Opening element that allows multiple parameters to be defined.
<Parameter>			Variable name defined in a prior math statement, literal value or expression that results in an appropriate data type.	Defines the values to be passed as input to the stored procedure.
	NAME	A literal value.		Defines the name of the parameter exactly as defined in the stored procedure.
	DATATYPE	A literal value. Values are limited to: BIGTEXT DATE TEXT INTEGER DECIMAL

XML Examples

<MathVariable VARIABLENAME="AllocationAllocationFundGUIDArray" TYPE="STRINGARRAY"

     OPERATION="FILLBY-ALLOCATIONTO" DATATYPE="TEXT">

</MathVariable>

<MathVariable VARIABLENAME="TypeCodeArray" TYPE="STRINGARRAY" OPERATION="CREATE" DATATYPE="TEXT">SegmentCount</MathVariable>

<MathVariable VARIABLENAME="Guids" TYPE="STRINGARRAY" OPERATION="FILLBY-STOREDPROCEDURE" DATATYPE="TEXT" PROCEDURENAME=" TestRatesProc ">

<Parameters>

<Parameter NAME="AGE" DATATYPE="INTEGER">VarAge</Parameter>

<Parameter NAME="SEX" DATATYPE="TEXT">01</Parameter>

</Parameters>

</MathVariable>

<MathVariable VARIABLENAME="FundGUIDArrayX" TYPE="STRINGARRAY"OPERATION="FILLBY-FUND" CONTEXT= "MATH" DATATYPE="TEXT"/>

<MathVariable VARIABLENAME="DepositGUIDArrayX" TYPE="STRINGARRAY" OPERATION="FILLBY-DEPOSIT" CONTEXT= "MATH" DATATYPE="TEXT">MyFundGUID</MathVariable>

STRINGARRAY OPERATION FILLBY-FINANCIALENTRY

<MathVariable VARIABLENAME="[MathVariable]" TYPE="STRINGARRAY"

     OPERATION="FILLBY-FINANCIALENTRY" DATATYPE="TEXT" STARTDATE="[MathVariable]" ENDDATE="[MathVariable]">

</MathVariable>