Group Editor

Editor for a group of filter conditions in the Filter Editor.

Remarks

The Group Editor is a UI component in the Filter Editor control, allowing users to visually build, organize, and manage groups of filter conditions for advanced search queries. It is used to combine multiple filter conditions using logical operators (AND/OR), enabling the creation of complex, nested search filters.

Purpose and Functionality

The Group Editor enables users to:

• Add, remove, and nest filter conditions and groups to construct complex logical expressions.
• Select the logical operator (AND/OR) that determines how the group's conditions are evaluated.
• Add specialized conditions, such as comparison, IN, ISMATCH, geo-distance, and geo-intersects filters.
• Organize conditions into parent/child groups for precise control over filter logic and precedence.

The editor provides a set of buttons for adding new conditions or groups, as well as for deleting existing ones. Each group can contain any number of child conditions or nested groups, supporting arbitrarily complex filter structures.

UI Components

• Operator Selector: Allows users to choose between AND (all conditions must be true) and OR (any condition may be true) for the group.
• Add Buttons: Buttons to add new comparison, IN, ISMATCH, geo-distance, geo-intersects, lambda, or child group conditions.
• Delete Buttons: Buttons to remove individual conditions or entire groups.
• Nested Groups: Support for creating groups within groups, enabling advanced logical expressions.

Example

The following diagram illustrates a typical layout of the Group Editor with nested groups and conditions:

┌───────────────────────────────────────────────────────────────────────────┐
│ {Operator Selector: AND/OR}                                               │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ {Comparison Condition}   {Delete}                                     │ │
│ │ {IN Condition}           {Delete}                                     │ │
│ │ ┌───────────────────────────────────────────────────────────────────┐ │ │
│ │ │ {Operator Selector: OR}                                           │ │ │
│ │ │ {Comparison Condition}   {Delete}                                 │ │ │
│ │ │ {Geo Distance Condition} {Delete}                                 │ │ │
│ │ └───────────────────────────────────────────────────────────────────┘ │ │
│ │ {Add Comparison} {Add IN} {Add Group} {Add Lambda} {Add Geo Distance} │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ {Add Comparison} {Add IN} {Add Group} {Add Lambda} {Add Geo Distance}     │
└───────────────────────────────────────────────────────────────────────────┘

• {Operator Selector}: Dropdown or toggle to select AND/OR logic for the group.
• {Comparison Condition}, {IN Condition}, {Geo Distance Condition}: Represent individual filter conditions.
• {Add ...}: Buttons to add new conditions or groups.
• {Delete}: Button to remove a condition or group.
• Nested boxes represent child groups, each with their own operator and conditions.

Usage Guidance

• Use the Group Editor to build complex search filters by combining multiple conditions and groups.
• Select the appropriate logical operator (AND/OR) for each group to control how conditions are evaluated.
• Add specialized conditions as needed to match your search requirements.
• Organize conditions into nested groups to reflect logical precedence and grouping.
• Remove conditions or groups using the {Delete} buttons.

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

Command Buttons

Button	Shortcut Key		Summary
equal add_comparison			Add a new comparison condition to this group.
library_add add_group			Add a new child group to this group.
data_array add_lambda			Add a new lambda expression to this group to compare against values inside a collection.
clarify add_in			Add a new IN condition to this group to test a field against a list of values.
regular_expression add_ismatch			Add a new MATCHES condition to test whether the text content of a field or the document contains a text pattern.
add_location add_geo_distance			Add a new MATCHES condition to test whether the text content of a field or the document contains a text pattern.
join_inner add_geo_intersects			Add a new MATCHES condition to test whether the text content of a field or the document contains a text pattern.
menu menu			Open the menu.
delete delete			Delete this condition.
open_jam add_parent_group			Add a new parent group above this condition.

Used By

Filter Editor