Array Operations

The Array Operations node allows users to perform various functional transformations on an input array. Operations include filtering, projection, ordering, counting, and more. This node supports both primitive arrays and arrays of objects (dictionaries), making it a versatile tool for list manipulation.

Node Purpose

Use the Array Operations node to extract specific values, filter based on conditions, sort, or restructure array data within your workflow.

Input Fields

Label	Input Type	Description	Required	Visible When
Input Array	text	The array of values or objects to be manipulated. Example: [{ "Name": "Alice" }, { "Name": "Bob" }]	✅ Yes	Always
Operation	picklist	The operation to perform on the input array. See supported options below.	✅ Yes	Always
Property Name	text	The name of the property to be used for filtering, selecting, or ordering.	⚠️ Only required for: Where, Select, OrderBy, OrderByDescending, DistinctBy	Where, Select, OrderBy, OrderByDescending, DistinctBy
Value	text	The expected value of a property to use in a Where operation.	⚠️ Required for Where	Where
Skip Count	text	Number of items to skip from the beginning of the array.	⚠️ Required for Skip	Skip
Take Count	text	Number of items to take from the start of the array.	⚠️ Required for Take	Take
Output Variable Name	text	The name of the variable to store the result of the operation.	✅ Yes	Always

Supported Operations

Operation	Description
First	Returns the first item in the array.
Last	Returns the last item in the array.
Where	Filters the array where a specific property equals a given value.
Select	Projects a list of values from a specific property in each object.
Distinct	Removes duplicates from the array.
DistinctBy	Removes duplicates based on a specific property’s value.
Count	Returns the number of items in the array.
Skip	Skips a specified number of items from the beginning of the array.
Take	Takes a specified number of items from the start of the array.
OrderBy	Orders the array ascendingly based on a property’s value.
OrderByDescending	Orders the array descendingly based on a property’s value.

Output

The result of the selected operation is stored in the specified Output Variable Name. This can be referenced by downstream nodes using {VariableName} syntax.

Example

If you want to filter users where Role equals Admin, configure the node as follows:

• Input Array: {usersArray}
• Operation: Where
• Property Name: Role
• Value: Admin
• Output Variable Name: filteredAdmins

Error Handling

The node will fail if:

• Required fields for the chosen operation are missing (e.g., PropertyName or SkipCount)
• The input array is not in a valid format
• An unsupported operation name is specified

Remarks

• Arrays of objects must be in Dictionary<string, object> form to support property-based operations.
• Outputs are returned in the node's data["Result"] dictionary entry and automatically cleaned of input parameters.

---