Skip to content
Support
  • There are no suggestions because the search field is empty.

Input Widget

The Input Widget allows users to perform real-time searches across a dataset or workflow by entering free-text values. It is commonly used to power smart search interfaces within dashboards, supporting both static data (tables) and dynamic data (via workflows).

Modes of Operation

Mode Description
Custom Table Uses a static dataset (preloaded or local). Enables filtering and formatting.
Workflow Executes a backend workflow/API. Suitable for live, dynamic search results.

Each mode offers a different set of configuration panels:

Panel Custom Table Workflow
Data Yes Yes
Appearance Yes Yes
Details Yes No
Filter Yes No
Workflows No ✅

Panel-by-Panel Configuration

1. Data Panel

Common to both modes:

  • Widget Name: Title shown in the dashboard (e.g., Search Item)
  • Widget Description / Placeholder: Optional helper text
  • Datasource Options:
    • Custom Table: Select from loaded datasets
    • Workflow: Bind to a predefined backend process

2. Appearance Panel

  • Widget Name Font Size: Default is 24
  • Controls the font size of the widget title

3. Details Panel (Custom Table only)

Allows configuration of how search results are displayed.

Table Columns

  • Lists all fields in the selected table
  • Select which fields should be shown in the dropdown
  • Mark searchable fields using the magnifying glass icon

Divider Options

Customize how values are separated in the result display:

Option Symbol
Space " "
Comma ","
Hyphen "-"
Pipe `"
Slash "/"

Example output using Pipe:

Female | alice@email.com | true | 10 | Alice Smith | Engineer

4. Filter Panel (Custom Table only)

Lets you define rules that restrict what records appear in the dropdown.

Dynamic Conditions by Field Type

Field Type Supported Conditions
Text Field Is, Contains, Starts/Ends With, Is Empty
Numeric Field Equal, Greater Than, Is Between, Is Empty
Date Field Is, Relative, Before/After, Is Between, Is Empty
Compare Fields Field-to-field comparisons
Boolean Is / Is Not (true/false)
Tag From user selections
Constant Dropdown inputs or static values

Example Conditions

  • Text:
    • employee_name Contains "John"
  • Number:
    • employee_tenure_years Greater Than 5
  • Date:
    • birth_date Is Between 17.03.2025 and 24.03.2025
    • created_date Is Relative To Past Month 0
  • Compare:
    • salary Greater Than target_salary

Field-to-Field Compare Examples

Field 1 Field 2 Condition
Text A Text B Equal / Not Equal
Num A Num B >, <, =, etc.
Date A Date B Before / After

Advanced Logic – Filter Groups

You can group filter rules to apply AND/OR logic between them.

Example:

Show:

  • Female employees with tenure > 5

    OR

  • Male employees with tenure < 20

Group 1 – Female

  • employee_gender = Female
  • employee_tenure_years > 5 (AND)

Group 2 – Male

  • employee_gender = Male
  • employee_tenure_years < 20 (AND)
  • Combine both groups using OR

Filter UI Controls

  • Add Filter Rule: Add another condition within the group
  • Add Filter Group: Create a new group
  • AND/OR: Logical connector within the group
  • Delete: Remove group or rule

5. Workflows Panel (Workflow mode only)

Only visible when a workflow is selected as the data source.

Connected Workflow

  • Select one from available workflows, e.g., List items with CONO & DIVI

Trigger Expression

Defines the request payload sent to the workflow when the user types:

json
KopierRediger
{ "header": {}, "body": "$linked" }

  • $linked is replaced by the user input

Workflow Result Mapping

Define how to interpret the workflow’s response:

Expression Type Purpose
Data Expression Extracts array of results from the response
Description Expression Sets what is shown in the search dropdown
Details Data Expression Optional data for use in detail widgets
Details Text Expression Optional – a summary text on selection
Details URL Expression Optional – open a detail URL on selection

Accepts either JSONPath or JavaScript-style expressions

Summary of Use Cases

Feature Custom Table Workflow
Static dataset Yes No
Backend/API lookup No Yes
Visual column configuration Yes Yes, via expression
Manual filtering (e.g. by department) Yes No
Dynamic conditions / logic Yes Yes (expression-based)