Common field properties

Applies to Dynamics 365 for Customer Engagement apps version 9.x (on-premises)

Fields in a form display controls people use to view or edit data in an entity record. Fields can be formatted to occupy up to four columns within a section.

You can access Common field properties in solution explorer. Under Components, expand Entities, expand the entity you want, and then select Forms. In the list of forms, open the form of type Main. Then double-click one of the fields to view Common field properties.

common-field-properties

The following table describes properties that all fields have. Certain types of fields have special properties. These are described in Special field properties.

Tab Property Description
Display Label Required: By default the label will match the display name of the field. You can override that name for the form by entering a different label here.
Display label on the form You can choose not to display the label at all.
Field Behavior Specify the field level behavior using the check boxes.
Locking This will prevent the field from being removed from the form accidentally. This will prevent any configuration you have applied to the field, such as event handlers, from being cleared if the field were removed. To remove this field a customizer would need to clear this setting first.
Visibility Showing the field is optional and can be controlled using scripts. More information: Visibility options
Availability Choose if you want the tab to be available on the phone.
Formatting Select the number of columns the control occupies When the section containing the fields has more than one column you can set the field to occupy up to the number of columns that the section has.
Details Display Name, Name, and Description These read-only fields are for reference. Click the Edit button for convenient access to the field definition if you want to edit it.

Each instance of a field in the form has a name property so that they can be referenced in form scripts, but this name is managed by the application. The first instance of the field is the name of the field specified when it was created. More information: Create and edit fields

For each additional time that a field is included in a form, the name appends a number starting with 1 to the end. So if the field name is ‘new_cost’, the first instance is ‘new_cost’, the second is ‘new_cost1’, and so on for each instance of the field in the form.

Note: The field Description value provides tooltip text for the field when people place their cursor over it.
Events Form Libraries Specify any JavaScript web resources that will be used in the field OnChange event handler.

Event Handlers Configure the functions from the form libraries that should be called for the field OnChange event. More information: Configure Event Handlers
Business Rules Business Rules View and manage any business rules that reference this field. More information: Create business rules and recommendations
Controls Controls Add controls and specify their availability on Web, Phone and Tablet .

See also

Use the Main form and its components