AppendItemToCollection

This activity helps to adds one or more items to the end of a specific collection, supporting multiple data types via the Collection Builder.

Properties

INPUT

Collection*: Specifies the collection variable to which the new items will be appended. This field accepts an ICollection<Object> type.

MISC

DisplayName: Displays the name of the activity. The name can be customized for better readability and troubleshooting.

SkipOnError: Specifies the Boolean value as True or False.

True: Continue executing the workflow regardless of any errors thrown.
False: Halt the workflow if it encounters any errors.
None: If this field is left blank, the activity will behave as if False were chosen by default.

Version: Displays the version of the activity being used. This field is auto-populated and read-only.

OUTPUT

New Collection: Stores the resulting collection of type List<Object> after the new items have been appended.

Result: Indicates the execution status of the activity. Returns a Boolean value.
True: Indicates that the activity has been executed successfully without any errors.
False: Indicates that the activity has been unsuccessful due to an unexpected error being thrown.

How to Add a Collection Builder?

The Append Item to Collection activity appears on the canvas with the following options:

1. Collection – Enter the collection item directly or a hardcoded variable.
2. Collection Builder – Click the button to open the Collection Builder window, which allows you to add multiple items to the collection at once.

Collection Builder Window

The Collection Builder dialog provides a structured way to manage multiple collection values. Once opened, you can:

1. Add multiple InArgument<Object> values at once, with each row accepting any object type as an input argument.
2. Click (+) to add a new row for an additional value.
3. Click (X) to remove an existing row.
4. Click (≡) to open the Expression Editor, where you can write expressions for a specific InArgument<Object> value.
5. Click Save to apply all entered values or Cancel to discard changes.