Filter Editor

Provides an interactive environment for building, editing, and executing AI Search filters with advanced code editing features.

Remarks

The Filter Editor is the primary UI component for constructing, visualizing, and managing advanced search filters in Grooper's Search Page. It enables users to create complex, nested filter expressions using a combination of logical groups, comparison conditions, pattern matches, and geographic filters.

Purpose and Functionality

The Filter Editor enables users to:

• Build and edit search filters using a visual, interactive interface.
• Organize filter conditions into logical groups (AND/OR) for precise control over query logic.
• Add, remove, and nest a variety of filter types, including comparison, IN, ISMATCH, geo-distance, geo-intersects, and lambda expressions.
• Preview and modify the filter structure before executing a search.
• Leverage contextual tooltips and UI cues to assist in filter construction.

The editor parses and validates filter expressions, ensuring that only valid, executable queries are constructed. It supports both simple and highly complex filter scenarios, adapting to the user's needs.

UI Components

• Group Editor: Displays the root group of the filter, allowing for the addition and organization of all filter conditions.
• Condition Editors: Embedded editors for each filter type (comparison, IN, ISMATCH, geo-distance, geo-intersects, lambda), each with their own specialized UI.
• Toolbar/Buttons: Controls for adding, removing, and nesting filter conditions and groups.
• Code/Expression View: (If enabled) Allows advanced users to view or edit the underlying filter expression as text.

Example

The following diagram illustrates a typical layout of the Filter Editor with a root group and nested conditions:

┌─────────────────────────────────────────────────────────────────────────────┐
│ {Group Editor} (AND)                                                        │
│   ├─ {Comparison Condition}   {Delete}                                      │
│   ├─ {IN Condition}           {Delete}                                      │
│   ├─ {IsMatch Condition}      {Delete}                                      │
│   ├─ {Geo Distance Condition} {Delete}                                      │
│   └─ {Group Editor} (OR)                                                    │
│         ├─ {Comparison Condition}   {Delete}                                │
│         └─ {Geo Intersects Condition} {Delete}                              │
│   {Add Comparison} {Add IN} {Add IsMatch} {Add Geo Distance} {Add Group}    │
└─────────────────────────────────────────────────────────────────────────────┘

• {Group Editor}: Visual container for organizing filter conditions using AND/OR logic.
• {Comparison Condition}, {IN Condition}, etc.: 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 Filter Editor to visually construct and refine search filters before executing a query.
• Organize conditions into groups to control logical precedence and evaluation order.
• Add specialized conditions as needed to match your search requirements.
• Remove or rearrange conditions and groups using the provided controls.

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

Child Controls

Name	Type		Summary
Group Editor	Group Editor		Displays the root group of the filter.