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

MATCHES Predicate

Where Predicate Grooper.CMIS

Defines filtering criteria for a string property, where the property value must match a regular expression.

Remarks

The MATCHES Predicate allows you to filter items based on whether the value of a string property matches a specified regular expression pattern. This predicate is especially useful for advanced filtering scenarios where simple comparison or LIKE operators are insufficient.

The general form of a MATCHES predicate is:

PropertyName MATCHES 'Expression'
  • PropertyName is the query name of the property to compare.
  • Expression is a regular expression pattern that the property value must match.

The regular expression syntax follows the .NET regular expression language. For details, see the Regular Expression Language - Quick Reference.

> Note: The MATCHES Predicate is only valid when used with an import filter (see Import Descendants). It is not valid for use in standard CMISQL queries.

Usage Guidance

  • Use the MATCHES Predicate to implement complex pattern-based filtering on string properties during import operations.
  • The pattern must be a valid .NET regular expression. Invalid patterns will result in validation errors.
  • This predicate is only applicable to properties of type string.
  • The pattern is evaluated case-insensitively by default.

Example

cmis:name MATCHES '^[A-Z]{3}-\d{4}$'

This example matches property values that start with three uppercase letters, followed by a dash and four digits (e.g., "ABC-1234").

The MATCHES Predicate provides a powerful mechanism for advanced filtering scenarios in Grooper import filters, enabling precise control over which items are included based on string pattern matching.

Properties

NameTypeDescription

Used By

CMISQL Query

Notification