Input Widget

🔀 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	✅	✅
Appearance	✅	✅
Details	✅	❌
Filter	✅	❌
Workflows	❌	✅

---

⚙️ 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	✅	❌
Backend/API lookup	❌	✅
Visual column configuration	✅	🔄 via expression
Manual filtering (e.g. by department)	✅	❌
Dynamic conditions / logic	✅	✅ (expression-based)