Collection Operations

Creates, modifies, and queries in-memory list and dictionary collections during workflow execution.

Purpose

Use this task to manage runtime collections that accumulate or transform data as the workflow progresses. It supports both ordered lists and keyed dictionaries, covering common operations such as adding items, removing items, counting, querying, joining to a string, and serialising to JSON. The result of each operation is either stored back into the named collection or written to a separate output variable for use in downstream tasks.

Inputs

Field	Type	Required	Description
Collection Name	Text	Yes	The workflow variable name of the collection to operate on.
Operation	Dropdown	Yes	The operation to perform. See Operations table below.
Collection Type	Dropdown	No	The type of collection to create. Options: List<object>, List<string>, List<int>, List<double>, Dictionary<string,string>, Dictionary<string,object>, Dictionary<int,string>, Dictionary<int,object>.
Value	Text	No	The value to add, remove, or check for.
Values	Text	No	An array of values to add at once. Accepts a variable reference or JSON array.
Index	Text	No	The zero-based index position for retrieval or removal.
Separator	Text	No	The delimiter used when joining collection items into a string. Defaults to , .
Key	Text	No	The key for dictionary set, retrieval, removal, or existence checks.
Key-Value Pairs	Key-Value Pairs	No	A set of key-value pairs to add to a dictionary collection.
Output Variable Name	Text	No	The name of the workflow variable in which to store the operation result.

Visibility Rules

Collection Type is only shown when Operation is set to Initialize.

Value is only shown when Operation is set to Add, Remove, or Contains.

Values is only shown when Operation is set to AddRange.

Index is only shown when Operation is set to RemoveAt or Get.

Separator is only shown when Operation is set to Join.

Key is only shown when Operation is set to Set, GetByKey, RemoveKey, or ContainsKey.

Key-Value Pairs is only shown when Operation is set to Set or AddRange.

Output Variable Name is only shown when Operation is set to Count, Contains, Get, GetAll, Join, ToJson, GetByKey, ContainsKey, GetKeys, or GetValues.

Operations

Operation	Description
Initialize	Creates a new empty collection of the specified type.
Add	Appends a single value to a list.
AddRange	Appends multiple values to a list, or merges key-value pairs into a dictionary.
Remove	Removes the first matching value from a list.
RemoveAt	Removes the item at the specified index from a list.
Clear	Removes all items from a list or dictionary.
Count	Returns the number of items in the collection.
Contains	Returns true if the specified value exists in a list.
Get	Returns the item at the specified index from a list.
GetAll	Returns the entire collection.
Join	Concatenates all list items into a single string using the specified separator.
ToJson	Serialises the collection to a JSON string.
Set	Adds or updates a key-value entry in a dictionary.
GetByKey	Retrieves the value for a specified key from a dictionary.
RemoveKey	Removes a key-value entry from a dictionary.
ContainsKey	Returns true if the specified key exists in a dictionary.
GetKeys	Returns all keys from a dictionary as a list.
GetValues	Returns all values from a dictionary as a list.

Outputs

The result is stored in the variable named by Output Variable Name when provided. For operations that modify the collection (Initialize, Add, AddRange, Remove, RemoveAt, Clear, Set, RemoveKey), the collection itself is updated in-place under its Collection Name variable.

Name	Description
	The result of the operation: a count (integer), boolean, string, JSON string, single item, or full collection, depending on the operation performed.