Field editor

The field editor allows users to define fields for objects managed by Xperience (content types, system classes, object types). Each field matches a column in the database table belonging to the corresponding object.

A field’s main attributes are its:

name – a unique identifier.
data type – the type of data stored by the field in the underlying database column (string, integer, binary, etc.).
assigned value editor – the input interface used to edit the field. Dictated by the UI form component selected to manage the field (a drop-down list, check box, etc.).

Together, fields defined for an object comprise a form used to edit the corresponding field values. Forms created in this fashion appear in various places throughout the administration interface, depending on the object (e.g., in the Content of pages in a website channel application when creating new pages based on content types).

Field editor interface

You can use the field editor to:

Create new fields
Move fields
Delete fields

Create new fields

Select New field to add new fields.

General
Field name	Sets the name used for the database column (or XML field) that stores the values of the field. Also serves as the field’s unique identifier.
Data type	Sets the data type of the field’s value (also determines the data type used by the field’s representation in the database). Note: You may encounter an error when attempting to change the data type for fields that already store values of the original type. Most types of values cannot automatically be converted to a different data type (for example text values to date and time). In these cases, you either need to write and run custom code that changes the field type and correctly converts all values, or delete the existing field (and discard all current values) and then create a new field of the required type.
Size	Sets the maximum amount of characters that can be entered into the field. Only available if the Data type is set to Text.
Required	If checked, the form can only be saved if this field has a value specified. Disable to make the field optional.
Default value	Default value of the field pre-filled when the form is loaded.
Display field in the editing form	Indicates if the given field should be shown in the form to users. This can be disabled for fields that store internal or system values.
Field appearance
Field caption	Sets the text displayed next to the field in the form.
Tooltip text	Tooltip which is displayed if a user hovers over the field.
Text below the input	Text displayed directly below the field in the form.
Form component	Selects the form control through which users interact with the field in the editing form.
Form component configuration
The settings in this section provide a way to configure the parameters defined for the selected UI form component. The available options depend on the parameters defined for the given form component. See the tooltips of individual parameters for more information.
Validation
Validation rules	Specifies the input which the user is allowed to submit in the field. To add a validation rule, select Add rule. You can add multiple validation rules for one field, but be careful not to create contradictory rules. See UI form component validation rules for more information about field validation rules.
Visibility
Visibility conditions	Visibility conditions are only available for: Fields of content types and reusable field schemas (not in UI forms for module classes) Fields that are not set as Required The settings in this section allow you to dynamically display or hide the field based on a condition. Each field can only have one visibility condition. By default, the system provides a set of conditions that assess the value of another field. Select Depends on another field as the Condition type. Choose a Target field. Note: The target field must be placed above the currently edited field. The visibility condition will stop working if the target field is reordered under the conditioned field. Select a Condition (Equal to, Contains, Empty, etc.). The available conditions depend on the data type of the target field. Specify parameters for the condition, such as the Value against which the target field will be evaluated. Save the field. Developers can create and register custom visibility conditions based on project requirements. See UI form component visibility conditions for more information.

Field operations

Move fields

You can change the position of a field using the drag handle ().

Moving fields also changes their positions in the resulting form.

Delete fields

You can delete existing fields by selecting the Delete () icon. This operation is irreversible and you will lose all data stored under the field.

UI form components

Form components define the editing interface for fields that comprise editing forms in the Xperience administration interface. Each field is assigned a single form component that serves as its editing interface, such as a text box for user input, a group of radio buttons, or a drop-down selector.

All editing forms in the Xperience administration are based on UI form components:

Content type editing forms (Content view mode)
Configuration dialogs of admin UI editing forms (Page Builder components, Form Builder components, other editing dialogs). See Editing components.
Editing forms of object types (UI forms)

Form components are implemented as conventional C# objects with their interface provided by a React component. See UI form components for more information.