array Functions

Use array functions in rules to manipulate arrays in asset JSON at runtime.

Array functions can use the answer to a configuration wizard question to set runtime conditions. For example, array functions can check all selected values and set a condition to true or false. They can also take multiple values from an answer and iterate over a JSON array to put those values into the runtime JSON correctly.

Or, say that your wizard contains multiple questions with limited values to choose from, such as Yes/No, or a time frame in days or months. An array function can replace them with one question that asks the user to select multiple features to include in dashboards. In this case, the array function loops over the one question to check for values and set the features that the user picked via a conditional.

Parameters: Collection<Object> array, String returnValue

Returns: Collection<Object>

Recursive: Not supported>

Description: Evaluates returnValue as an EL expression for each item in the given array and collects each eval result in an array and returns it.

JSON template:

Produces:

Parameters: Int start, Int end, String returnValue

Returns: Collection<Object>

Recursive: Not supported

Description: Evaluates returnValue as an EL expression for the index number(s) int the array where the string is found.

Parameters: Collection<Object> array1, Collection<Object> array2

Returns: Collection<Object>

Recursive: Not supported

Description: Returns an array after concatenating the given array1 and array2.

Parameters: Collection<String> array

Returns: Collection<String>

Recursive: Not supported

Description: Returns an array of unique items. Uniqueness determined by the underlying objects contained in the array. For example, if the collection is an array of strings, all strings with identical values (case sensitive) are removed.

Parameters: String byFieldName, Collection<Object> array

Returns: Collection<Object>

Recursive: Not supported

Description: Returns an array of unique items. Expects an array of complex objects of similar shape. Uniqueness determined by comparing the value of a field identified by the given byFieldName.

Parameters: Collection<Object> array1, Collection<Object> array2

Returns: Collection<Object>

Recursive: Not supported

Description: Returns a unique union between array1 and array2. Uniqueness determined by the underlying objects contained in the array.

Parameters: String byFieldName, Collection<Object> array1, Collection<Object> array2

Returns: Collection<Object>

Recursive: Not supported

Description: Returns an array which is a union of array1 and array2 items. Expects an array of complex objects of similar shape. Uniqueness determined by comparing the value of a field identified by the given byFieldName.

Parameters: Collection <Object> array, Object item

Returns: Boolean

Recursive: Not supported

Description: Returns true if the given item is in the given array, otherwise false.

Parameters: Collection <Object> array

Returns: Integer

Recursive: Not supported

Description: Return the size of the array.

Parameters: Collection <Object> array

Returns: Object

Recursive: Not supported

Description: Return the last item of the array.