UI Element Data

Uncontrolled node

Overview

The UI Element Data node reads and outputs the current value of a form element in the Intellectible UI system. Use this node to capture user input from text fields, dropdowns, checkboxes, and other interactive elements within your workflow's user interface.

When working with list-based elements (such as tables or repeating groups), enable the In List option to specify which row index to read from.

Inputs

Input	Type	Description	Default
Page	DropDown	The display name of the UI page containing the target element.	-
Element	DropDown	The display name of the specific UI element to read data from.	-
List Index	Number / Text	(Conditional) Required when In List is enabled. Specifies the row index to read from. Can be a number, comma-separated string (e.g., "0,1"), or array for nested lists.	-

Outputs

Output	Type	Description
Output	Data	Contains the current value of the form element. Returns strings, numbers, booleans, or objects depending on the element type.

Properties

Property	Type	Description	Default
In List	Boolean	Enables reading from list elements (tables, repeating groups). When checked, adds the List Index input to specify which row to access.	false

Runtime Behavior and Defaults

• Uncontrolled Execution: This node runs automatically when its inputs change or when triggered by upstream controlled nodes. It does not require a run event input.
• Data Resolution: At runtime, the node resolves the page and element display names to their internal IDs and reads from the form's runtime data store at formData/{pageId}/{elementId}.
• List Handling: When In List is enabled, the node appends the list index to the data path (e.g., formData/{pageId}/{elementId}_{index}). For nested lists, provide multiple indices as a comma-separated string or array.
• EditableData Support: If the element stores data in EditableData format, the node automatically converts it to a standard JavaScript object.
• Empty Values: Returns undefined if the element is not found or has no value set.

Example Usage

Reading a Simple Text Input

1. Add a UI Element Data node to your workflow.
2. Set the Page input to the name of your UI page (e.g., "Customer Form").
3. Set the Element input to the name of your text field (e.g., "Customer Name").
4. Connect the Output to downstream nodes (e.g., an AI Write node to process the input).

Reading from a Table Row

1. Enable the In List property.
2. Connect a Number node or variable to the List Index input to specify which row to read (0-indexed).
3. Set Page and Element to your table element's names.
4. The Output will contain the data for the specified row.

Accessing Nested List Data

For nested lists (lists within lists), provide the indices as a comma-separated string:

• Set List Index to "0,2" to access the 3rd item in the 1st row's sub-list.