Binding Fields to Model Properties
Connect UI controls to your data model using dot-notation paths. Learn how to use the field picker and bind to projection target entities.
The power of UI projections comes from binding each control to a real property in your data model. Bindings use dot-notation paths that trace from a projection entity down to a specific field, giving you full data lineage from the screen back to the canonical model.
Dot-Notation Paths
Field bindings use dot-notation to reference nested properties. For example:
| Path | Meaning |
|---|---|
| customer.name | The name property of the customer entity |
| customer.address.city | The city field within the address property of customer |
| order.items[].productName | The productName field in each item of the order's items array |
| order.status | The status property of the order entity |
Using the Field Picker
You do not need to type paths manually. The field picker provides a searchable tree of all available fields.
Binding to Projection Target Entities
UI projections bind to the projection's target entities, not the raw model. This is an important distinction:
If a projection renames firstName to given_name, the field picker shows given_name. If a projection excludes a property, it does not appear in the picker. This ensures the UI accurately reflects the data shape that the consuming application will work with.