Skip to main content

What are Criteria?

Criteria define which records a Query retrieves from a Datasource. For example, if an Orders table holds historical details of orders over several years and you only want 2019's orders, you would add that restriction to the Query's Criteria.

A single criteria row matching Order Date between 1/1/2019 and 12/31/2019 under Match all of
A single Criteria.

Types of Criteria

Because Criteria are part of the Query definition, they are the more concrete way to filter a result set. If Users with different data needs share the same Query, a post-query Filter may be preferable. In the earlier example, if more than one User pulls data from the Orders table, it may make more sense to select all the records and let each User set up filters for different date ranges.

There are five types of Criteria: Field, Value, Saved List, Variable, and Input.

The criteria-type dropdown showing Field, Value, Saved List, Variable, and Inputs
The Criteria type options.

Field

Field Criteria compare one Field's value to another Field's value. For example, selecting all of a student's enrolled courses that match their declared major.

Value

Value Criteria are the most common type and compare a Field's value to a predefined value. For example, selecting orders where the ship country is France, USA, or Mexico.

A Ship Country exactly matches dialog listing the values France, USA, and Mexico
Multiple Value Criteria.

Saved List

Saved List Criteria select records that match the values in a Saved List on a U2 Datasource.

A Saved List dialog prompting for a U2 Datasource and a List Name
Saved List Criteria.

Variable

Variable Criteria compare one Field's value to an existing User Field's value.

A variable picker showing a Department Code User Field
Variable Criteria.

Input

Input Criteria compare one Field's value to a user-defined Input value. See Inputs for more on Inputs.

A run-time Query Inputs prompt asking for ship country values
Input Criteria.
Also available through the REST API
Everything on this page is built on Informer's public REST API, the same one the product uses, so your scripts and integrations can do it too. Developer reference: Queries.