A data field is a binding of a field to a data controller view. Only one binding of a field can exist in each view. Data fields in form views are organized in categories. The data controller will automatically bind primary key fields and alias fields to a data view if the corresponding data fields are not explicitly defined.
If the value of a field is required for a business rule implementation but should not be displayed to the user, then the data field binding must be created and marked as hidden.
If the field has read roles specified and the user is not matched to the roles, then the data field will become invisible. If the field has write roles specified and the user is not matched to the roles, then the data field will be rendered as read-only.
Data fields can be dynamically rearranged with the help of data controller virtualization.
Data Field Properties:
| Property | Description |
| Aggregate Function | Specifies a function that will be performed on the rows in grid view. The value will be displayed at the bottom of the grid. |
| Alias | Specifies an alias for the field. The alias will be used to display values. The header text of the alias will be used. |
| Auto Complete Minimum Prefix Length | Specifies the number of letters required for auto-complete to be displayed. If less than 1, auto-complete will be disabled. |
| Category | Displays the category Id that the data field belongs to. |
| Chart | Specifies the role the data field will play in the chart. |
| Code Filter | Specifies the behavior of the filter expression. |
| Columns | Specifies the width of the data field. |
| Controller | Displays the controller that the data field belongs to. |
| Data Format String | Specifies a string that will be used to format the field before presentation. |
| Data Type | Displays the type of the field. |
| Field Name | Specifies the field that the data field will reflect. |
| Filter Expression | Specifies when records will be displayed based on field values. |
| Footer Text | Specifies the text displayed under the field in the user interface. |
| Format On Client | When disabled, the server will format the field using the specified data format string. |
| Header Text | Specifies the text displayed as a label in the user interface. |
| Hyperlink Format String | Specifies a format string that will be rendered as a link. Field names surrounded by brackets can be used to dynamically populate values. |
| Read Only | When enabled, users will not be able to edit the value. The value will not be passed to the server. |
| Read-Only When | Specifies a JavaScript expression that will allow editing on the field when the expression evaluates to true. |
| Rows | Specifies the height of the data field. |
| Search Mode | Specifies the behavior in the advanced search bar. |
| Search Options | Specifies the options available in the advanced search bar. From here, you can also Disable Auto Complete, Disable Multiple Values, Disable Samples, Enable Auto Complete Anywhere. |
| Text Mode | Specifies the method used to display text values. Available options are: Password, Rich Text, Note, Static. |
| The field is hidden | When enabled, the data field will not be displayed in the user interface. |
| Tool Tip | Specifies text to display when the user mouses over the field. |
| View | Displays the view that the data field belongs to. |
| Visible When | Specifies a JavaScript expression that will display the field when the expression evaluates to true. |
Learn how to work with data fields in the Designer.
Learn to drag and drop data fields in the Project Explorer.
Common Tasks:
| Task | Description |
| Configure a Password Field | Learn how to configure a password data field. |
| Enable Rich Text Editor | Learn how to enable rich text editing on a data field. |