Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

IN Predicate

Where Predicate Grooper.CMIS

Specifies search criteria for an individual property in a CMISQL Query, using a list of allowed values.

Remarks

The IN Predicate is used in the WHERE clause of a CMISQL Query to filter results based on whether a property's value matches any value in a specified list. This predicate is useful for matching against multiple possible values without writing multiple OR conditions. The general form is:

PropertyName IN (Value1, Value2, Value3)
  • PropertyName is the query name of the property to compare.
  • The values in the list must be valid for the property type.

Quoting Rules

  • For properties of type String, DateTime, URI, or ID, values must be enclosed in single quotes:
    • WHERE FileExtension IN ('.pdf', '.docx', '.xlsx')
    • WHERE ReceivedDate IN ('12/01/2018', '12/02/2018', '12/03/2018')
  • For Integer and Decimal properties, values should be unquoted:
    • WHERE GLCode IN (10100, 10200, 10400)

> Note: The IN Predicate is not valid for Boolean properties.

Usage Guidance

  • Use the IN Predicate to simplify queries that need to match any of several values for a property.
  • Ensure that the values provided are appropriate for the property's data type and are formatted correctly (quoted or unquoted as required).
  • This predicate is commonly used for filtering by file extensions, status codes, dates, or other fields with a known set of possible values.

The IN Predicate streamlines query construction and improves readability when working with lists of allowed values in CMISQL Query objects.

Properties

NameTypeDescription

Used By

Notification