Remove value from collection
The Remove value from collection action A tool for building the processes, logic, and direction within workflows. removes all items of the specified value from the specified collection A variable containing multiple items, such as email addresses. Collection variables are useful for storing and operating on query results. For example, you can set up collection variables for names, email addresses, and index values to store results from querying a list. You can then loop through items in a particular collection variable (names, emails, or index values)..
For example, remove all items that have null values as the workflow does not need to process them.
Before you begin:
-
Understand Variables
-
Understand the Start a loop and Loop for each actions
Jump to:
Add and configure the Remove value from collection action
Tip: Use this action within the Loop for each action.
In the Designer page:
-
Click the Collection operations action group in the action toolbox.
or
Find actions by browsing action groups, or by typing an action name or function in the Search field at the top of the action toolbox.
- Drag the Remove value from collection action to the point in the workflow when you want to remove a value from a collection variable.
- Click the Remove value from collection action.
-
Complete the fields. For more information on the fields, see Remove value from collection fields.
Field
Example configuration
Example returned contents
Target collection collProduce romaine; apple; carrot; romaine
Value
romaine
Output
collProduceCleaned
apple; carrot
Field |
Description |
Variable types |
---|---|---|
Target collection | Collection variable that you want to remove the value from. Accepts an inserted variable. |
Collection |
Value |
Value that you want to remove. Accepts any combination of typed text and inserted variables. |
Boolean, DateTime, Decimal, File, Integer, Text |
Output |
Collection variable to store updated items after value is removed. Accepts an inserted variable. |
Collection |