Show TOC

Background documentationDefine Data Dialog Box Locate this document in the navigation structure

 

You use the Define Data dialog box to choose the data service fields for an element, and specify their default values. For UI elements, the Define Data dialog box also enables you to choose the control to display for each field, or whether to hide the control (and thereby remove the field from the UI element).

You display the Define Data dialog box by right-clicking a view or connector element on the Design board or Layout board and choosing Define Data from the context menu.

The Define Data dialog box contains the following items:

Item

Description

Add Field

Opens a list from which you can choose the type of field to add.

Delete Field

Removes the currently selected field from the list.

Rename Field

Renames the currently selected field.

Note Note

Field names are case-insensitive and can contain only ASCII characters, digits, and underscores. They cannot contain spaces, cannot start with a digit, and must be unique within the same data structure level.

End of the note.

Find References

Searches the current component for any references to the selected field. Any references to the field are displayed in the Find Field References dialog box, so you can modify them as required.

More information: Finding References

Initialize Data

Opens the Initialize Data dialog box, in which you can define initialization values for each of the fields in the dataset. This option is available only when defining fields for clustered datasets and for connectors. More information: Initialize Data Dialog Box

Select All

Creates controls for all fields in the list, based on the field type. This is equivalent to clicking the Add/Remove Controls column and adding a checkmark for each field.

You can change the control by clicking it to display a list of controls of the same type, and choosing a new control from the dropdown list.

Deselect All

Hides controls for all fields in the list. This is equivalent to clicking the Add/Remove Controls column and removing the checkmark for each field.

Add/Remove Controls (Add/Remove Controls)

Shows or hides the control in the UI element for the selected field. When the control is shown, a checkmark appears in this column and the control type is indicated in the Control column.

Field Name

Displays the name of the field. You can change the name by clicking the Rename Field button.

Field Label

Displays the field label value, if it is defined in the back-end system.

This column is displayed only when the Show field labels checkbox is selected.

Control

The control to be displayed for this field in the UI element. You can change the control by clicking it to display a list of controls of the same type, and choosing a new control from the dropdown list.

You can also choose Hide from the dropdown list to remove the control from the UI element (the field and its data still remain). This is equivalent to clicking the Add/Remove Controls column and removing the checkmark for the field.

Default Value

Enables you to enter a default value for the field that is used at runtime. You can either enter a value in the field, or click the fx button to define a value using the Dynamic Expression Editor dialog box.

Show field labels

Displays the Field Label column in the Define Data dialog box, as described above.