Check if item exists in collection

The Check if item exists in collection action A tool for building the processes, logic, and direction within workflows. determines if an item value exists in 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, check query results for expired contract dates before running later actions in the workflow.

Add and configure the Check if item exists in collection action

In the Designer page:

1. 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.

2. Drag the Check if item exists in collection action to the point in the workflow when you want to check for the item.
3. Click the Check if item exists in collection action.

4. Complete the fields. For more information on the fields, see Check if item exists in collection fields.

   Example 1: Exists

   Field	Example configuration	Example returned contents
   Target collection	collProduce	apple; carrot; romaine
   Value	carrot
   Store check result	boolExists	Yes
   Store matching index	intIndex	1

   Example 2: Does not exist

   Field	Example configuration	Example returned contents
   Target collection	collProduce	apple; carrot; romaine
   Value	orange
   Store check result	boolExists	No
   Store matching index	intIndex	-1*

   * When a match index is not found, the integer variable is set to an invalid index value of '-1'.