│ Grooper Help - Version 25.0
25.0.0032 2,215

Comparison Editor

Field Filter Filter Part Editor GrooperReview.Pages.Search

Editor for a comparison filter condition in the Filter Editor.

Remarks

The Comparison Editor is a UI component in the Filter Editor control, allowing users to define and edit a single comparison condition for filtering search results.
It is typically used within advanced search interfaces where users need to specify criteria such as "Field equals Value", "Field is not null", or other comparison-based logic.

Purpose and Functionality

The Comparison Editor enables users to:

  • Select a field from the available filterable fields.
  • Choose a comparison operator (such as equals, not equals, less than, greater than, or null checks).
  • Enter or select a value to compare against, with support for type-appropriate input (e.g., text, number, date).
  • View tooltips and contextual help for each field, including field type and additional guidance.
  • Remove the condition using the {Delete} button.

The editor dynamically adapts to the selected field and operator, ensuring only valid comparisons and values are allowed.
It also provides visual cues and tooltips to assist users in constructing valid and effective search filters.

Available Operators

The following comparison operators are available for building filter conditions:

  • = (eq): Equal to
  • != (ne): Not equal to
  • < (lt): Less than
  • > (gt): Greater than
  • <= (le): Less than or equal to
  • >= (ge): Greater than or equal to
  • =∅: Equal to null (field is empty)
  • ≠∅: Not equal to null (field is not empty)
  • IN: Field value is in a list of specified values (for array/collection fields)

The operator list adapts based on the selected field's data type. For date fields, additional date functions (such as "now", "add", "sub") may be available.

Example

The following diagram illustrates the typical layout of the Comparison Editor:

┌──────────────────────────────────────────────────────────────────┐
│ {Field Selector}   {Operator Selector}   {Value Input} {Delete}  │
└──────────────────────────────────────────────────────────────────┘
  • {Field Selector}: Dropdown to choose the field.
  • {Operator Selector}: Dropdown to choose the comparison operator.
  • {Value Input}: Input for the comparison value (type adapts to field).
  • {Delete}: Button to remove this condition.

For more information on building search filters, see the documentation for Search Page and Filter Editor.

Command Buttons

ButtonShortcut KeySummary
menu menu

Open the menu.
delete delete

Delete this condition.
open_jam add_parent_group

Add a new parent group above this condition.

Child Controls

NameTypeSummary
Notification