Reference: Filter Operators
Text Operators
Operator | Description |
|---|---|
is blank
| Field value is empty. |
is not blank
| Field value isn’t empty. |
equal to
| Field value is equal to comparison value.
Case insensitive. Example: Cat is equal to cat. |
not equal to
| Field value isn't equal to comparison value.
Case insensitive. Example: Dog is not equal to cat. |
contains
| Comparison value is a subset of field value.
Case insensitive. Example: Cat contains AT. |
contains (case sensitive)
| Comparison value is a subset of field value.
Example: Cat contains at. |
does not contain
| Comparison value isn't a subset of field value.
Case insensitive. Example: Cat does not contain dog. |
does not contain (case sensitive)
| Comparison value isn't a subset of field value.
Example: Cat does not contain AT. |
starts with
| Comparison value is a subset of field value, and the first character of the field value matches the first character of the comparison value.
Case insensitive. Example: Cat starts with ca. |
starts with (case sensitive)
| Comparison value is a subset of field value, and the first character of the field value matches first character of comparison value.
Example: Cat starts with Ca. |
ends with
| Comparison value is a subset of field value, and the last character of the field value matches the last character of comparison value.
Case insensitive. Example: Cat ends with AT. |
ends with (case sensitive)
| Comparison value is a subset of field value, and the last character of the field value matches the last character of the comparison value.
Example: Cat ends with at. |
greater than
| Field value comes before the comparison value in alphabetical order.
This operator compares alphabetic sort order, not length. Case insensitive. Example: Cat is greater than dog. |
greater than or equal to
| Field value is the same as or comes before the comparison value in alphabetical order.
This operator compares alphabetic sort order, not length. Case insensitive. Examples:
|
less than
| Field value comes after comparison value in alphabetical order.
This operator compares alphabetic sort order, not length. Case insensitive. Example: Dog is less than cat. |
less than or equal to
| Field value is the same as or comes after the comparison value in alphabetical order.
This operator compares alphabetic sort order, not length. Case insensitive. Examples:
|
Currency and Numeric Operators
Operator | Description |
|---|---|
equal to
| Field value is equal to comparison value.
Example: 123 is equal to 123. |
not equal to
| Field value isn't equal to comparison value.
Example: 12 is not equal to 123. |
greater than
| Field value is greater than comparison value.
Example: 321 is greater than 123. |
greater than or equal to
| Field value is greater than or equal to comparison value.
Examples:
|
less than
| Field value is less than comparison value.
Example: 12 is less than 123. |
less than or equal to
| Field value is less than or equal to comparison value.
Examples:
|
Date Operators
Operator | Description |
|---|---|
is blank
| Field value is empty. |
is not blank
| Field value isn't empty. |
equal to
| Date value is equal to comparison value. |
not equal to
| Date value isn't equal to comparison value. |
greater than
| Date value is later than comparison value.
Example: 10/20/2016 is greater than 05/20/2016. |
greater than or equal to
| Date value is later than or equal to comparison value.
Examples:
|
less than
| Date value is before comparison value.
Example: 05/20/2016 is less than 10/20/2016. |
less than or equal to
| Date value is before or equal to comparison value.
Examples:
|
Boolean Operators
Operator | Description |
|---|---|
is blank
|
Field value is empty. Represents False. |
is not blank
| Field value isn't empty. Represents True. |
equal to
| Field value is equal to the comparison value.
For True, select the Comparison Value check box. For False, clear the Comparison Value check box. |
not equal to
| Field value isn't equal to the comparison value.
For True, clear the Comparison Value check box. For False, select the Comparison Value check box. |
Single Instance and Multi-Instance Operators
Field Type | Operator | Usage |
|---|---|---|
Single Instance
Multi-instance | exact match with the selection list
| Field value matches exactly with comparison value.
For single instance fields, this operator restricts a prompt so that it accepts a single value only. To enable a prompt for a single instance field to accept multiple values, use in the selection list . |
Single Instance
Multi-instance | NOT exact match with the selection
| Field value doesn’t exactly match the comparison value. |
Single Instance
Multi-instance | subset of the selection list
| Field value is a subset of the comparison value. Blank field values are a subset of the comparison values. |
Single Instance
Multi-instance | NOT subset of the selection list
| Field value isn’t a subset of the comparison value. Blank field values are a subset of the comparison values. |
Single Instance
Multi-instance | superset of the selection list
| Comparison value is a subset of the field value. Blank comparison values are a subset of the field values. |
Single Instance
Multi-instance | NOT superset of the selection list
| Comparison value isn’t a subset of the field value. Blank comparison values are a subset of the field values. |
Single Instance
Multi-instance | count is equal to
| The number of field values is equal to the comparison value.
Example: To view workers with 2 dependents, set a filter for Dependents where count is equal to a Comparison Value of 2. |
Single Instance
Multi-instance | count is not equal to
| The number of field values isn't equal to the comparison value.
Example: To view workers with dependents, set a filter for Dependents where count is not equal to a Comparison Value of zero. |
Single Instance
Multi-instance | count is greater than
| The number of field values is greater than the comparison value.
Example: To view workers with more than 1 dependent, set a filter for Dependents where count is greater than a Comparison Value of 1. |
Single Instance
Multi-instance | count is greater than or equal to
| The number of field values is greater than or equal to the comparison value.
Example: To view workers with 1 or more dependent, set a filter for Dependents where count is greater than or equal to a Comparison Value of 1. |
Single Instance
Multi-instance | count is less than
| The number of field values is less than the comparison value.
Example: To view workers with fewer than 2 dependents, set a filter for Dependents where count is less than a Comparison Value of 2. |
Single Instance
Multi-instance | count is less than or equal to
| The number of field values is less than or equal to the comparison value.
Example: To view workers with 2 or fewer dependents, set a filter for Dependents where count is less than or equal to a Comparison Value of 2. |
Single Instance | in the selection list
| Comparison value is 1 of the possible field values.
Example: A is in the selection list A, B, C. |
Single Instance | not in the selection list
| Comparison value isn't 1 of the possible field values.
Example: D is not in the selection list A, B, C. |
Multi-Instance | any in the selection list
| Field value is 1 of the possible comparison values. |
Multi-Instance | none in the selection list
| Field value isn't 1 of the possible comparison values. |
Single Instance
Multi-instance | is empty
| Field value is blank. |
Single Instance
Multi-instance | is not empty
| Field value isn't blank. |
A field value is a subset of the comparison value if all instances of the field are instances of the comparison. Inversely, the comparison value is a superset of the field value if it contains all instances of the field. Example: The field value is
1, 2, 3
and the comparison value is:
- 1, 2, 3, 4, 5. The comparison value contains all instances of the field value. Therefore, the field value is a subset and the comparison value is a superset.
- 4, 5, 6, 7. The comparison value doesn't contain any instances of the field value. Therefore, the field value isn't a subset and the comparison value isn't a superset.
Single Instance Examples
This table contains examples of expected results for the logical operators that compare single instance field values against a selection list.
Single Instance Field Value | Selection List | in the selection list
| not in the selection list
| exact match with the selection list
| subset of the selection list
| superset of the selection list
|
|---|---|---|---|---|---|---|
Atlanta | Chicago | False | True | False | False | False |
Chicago | Chicago | True | False | True | True | True |
Atlanta | Chicago
Sacramento | False | True | False | False | False |
Chicago | Chicago
Sacramento | True | False | False | True | False |
<blank> | Chicago
Sacramento | False | True | False | True | False |
<blank> | Chicago | False | True | False | True | False |
Chicago | <blank> | False | True | False | False | True |
<blank> | <blank> | False | True | True | True | True |
These operators provide specialized logic that might not be appropriate when comparing a single instance field value against a selection list:
- exact match with the selection list
- subset of the selection list
- superset of the selection list
In most cases, you should use either the
in the selection list
or not in the selection list
operator.Multi-Instance Examples
This table contains examples of expected results for the logical operators that compare multi-instance field values against a selection list.
Multi-Instance Field Value | Selection List | any in the selection list
| none in the selection list
| exact match with the selection list
| subset of the selection list
| superset of the selection list
|
|---|---|---|---|---|---|---|
Atlanta | Chicago
Sacramento | False | True | False | False | False |
Chicago | Chicago
Sacramento | True | False | False | True | False |
Chicago
Atlanta | Chicago
Sacramento | True | False | False | False | False |
Chicago
Sacramento | Chicago
Sacramento | True | False | True | True | True |
Chicago
Sacramento Dallas | Chicago
Sacramento | True | False | False | False | True |
<blank> | Chicago
Sacramento | False | True | False | True | False |
<blank> | Chicago | False | True | False | True | False |
Chicago | <blank> | False | True | False | False | True |
<blank> | <blank> | False | True | True | True | True |
Optional Prompts
If you want to evaluate blank values as True, you must include an
Or
statement as part of the filter. The Or
statement prompts the user for a superset of the selection list
. If the user doesn't select a prompt value when running the report, the superset of the selection list
filter condition evaluates as True. In this case, an empty prompt value is the equivalent of selecting all possible values.Example: To prompt for a location and ignore the prompt if the user doesn't enter a location, enter these values in the
Filter on Instances
grid.And/Or | Field | Operator | Comparison Type |
|---|---|---|---|
And
| Location
| in the selection list
| Prompt the user for the value
|
Or
| Location
| superset of the selection list
| Prompt the user for the value
|