Design the User Interface > Configuring components > Configuring a Fields component
  

Configuring a Fields component

When you add the Fields component to a custom page, you can add fields and field groups. You can configure properties for the fields or field groups that you add.
    1On the Page Components tab of a custom page, drag the Fields component to a section.
    2On the Properties tab, configure the following properties:
    Property
    Description
    Title
    Name of the section.
    Show border
    Specifies whether to display the section border. To display the section border, select the property.
    Validate root fields in this section
    Specifies whether to validate data in the root fields added to a section instead of validating data in the root fields added to all the sections. To validate data on the root fields of this section, select the property.
    By default, all the root fields added to the page are validated for each section.
    For example, create a custom page that contains two sections, section 1 and section 2. Enable root field validation in section 1. When users update the root field values in section 1 and apply the changes, MDM SaaS validates the root fields added to section 1. When you update the root field values in section 2 and apply the changes, MDM SaaS validates the root fields added to section 1 and section 2.
    3Click Apply.
    4On the canvas, click Add Fields and select the fields or field groups. For a field group, you can select a maximum of 20 picklist fields.
    Note: When users create or update a record in a business application, all the sections that contain root fields open in the edit mode. To avoid opening multiple sections in the edit mode, add the root fields in one section.
    5Click Done.
    Ensure that you add all the required root fields and the required fields of the field groups that you select. To avoid validation errors across sections, add the dependent root fields in one section.
    The selected fields and field groups appear in the panel.
    6Select a field or field group, and configure the properties on the Properties tab.
    For more information about field properties, see Field properties. For more information about field group properties, see Field group properties.
    7Click Apply, and then click Save.
The following image shows the fields and field groups that you configure for a record:
The image shows the General Information section with the fields, such as First Name, Title, and Gender. The image also shows field groups, such as Address and Phone.

Field properties

You can configure properties for each field that you add to a custom page.
The following table lists the field properties:
Property
Description
Label
Display name of the field.
Label Position
Optional. Position for the display name to appear.
The following label positions are available:
  • - Top. The display name appears above the field.
  • - Side. The display name and the field appear side by side.
Default is Top.
Hide label
Optional. Indicates whether to hide the field label. To hide the field label, select the property.
Description
Displays the description of the field.
Default Value
Optional. Default value of the field.
Tip Text
Optional. Additional information about the field.
Width (%)
The width of the field. Default is 100%.
Required field
Optional. Indicates whether the field is a required field. To configure the field as a required field, select the property.
Read only
Optional. Indicates whether you can edit the field. To configure the field as a non-editable field, select the property.
Render As
User interface element that you want to use for the field. The options vary depending on the selected field.
The following options are available:
  • - Text
  • - Image
  • - URL
  • - Date
  • - Date and Time
  • - Multiline Text Area
  • - Drop-down List
  • - Radio Button
  • - Check Box
Ghost Text
Optional. A text that provides guidance for input. This text appears in the text fields, and the user input replaces it.
For example, the placeholder text for the First Name field can be Enter a first name.
Placeholder Text
Optional. A text that provides guidance for input. This text appears in drop-down lists, and the user input replaces it.
For example, the placeholder text for the Country drop-down list can be Select a country.
Date Format
Indicates the format of a date for the date fields. Default is Browser Locale. You can select another date format, such as MM/DD/YYYY or YYYY-MM-DD.
When the date format is set to the Browser Locale, the date and time fields use the date, time, and clock formats that the browser locale uses. The browser locale format overrides the values of the Time Format and Clock Format properties.
Time Format
Indicates the format of time for the date and time fields. Default is HH:MM. If the Date Format property is set to Browser Locale, then the browser locale format overrides the value of the Time Format property.
Clock Format
Indicates the format of a clock for the date and time fields. Default is 24 Hrs. If the Date Format property is set to Browser Locale, then the browser locale format overrides the value of the Clock Format property.

Field group properties

For each field group that you add to a custom page, you can configure properties. Ensure that you add a field group only once to a page tab. If you add a field group multiple times to a page tab, the field group entries that users add in one section propagate to all sections that use the field group.
The following table lists the field group properties in the Selection: <Field Group Name> section:
Property
Description
Label
Display name of the field group.
Description
Displays the description of the field group.
Path
Hierarchy path of the field group.
Tip Text
Optional. Additional information about the field group.
Read only
Optional. Indicates whether you can edit the field. To configure the field as a non-editable field, select the property.
The following table lists the field group properties in the Display Options section:
Property
Description
Render As
Display style of the fields.
The following options are available:
  • - Card. The fields appear in a card layout.
  • - List. The fields appear in a list format.
  • - Table. The fields appear in a table.
    • Note: To display a field group in a table effectively, ensure that the panel containing the field group uses at least 50% of the page to enhance user experience.
  • - Form. The fields display in a form layout.
Note: For nested field groups, the List and Form options are available. For dynamic field values attributes, the Table and Form options are available. If the associated dynamic field definition contains nested field groups, the dynamic field values render as a form in a business application.
Title Field
Field to display as the title of the field group. Appears when you select the Render As option as form or card.
Navigation Style
Navigation style of the section.
The following navigation style is available:
  • - Pagination. Each section displays the specified number of records.
Maximum Records Per Page
Maximum number of entries to display in a section.
For example, the address section contains multiple entries. If you set the value to 6, the section displays a maximum of six entries. The next six entries display in the next section, and so on.
The following table lists the field group properties in the Card Layout section:
Property
Description
Title Field
Field to display as the title of the card.
Highlight Field
Optional. Field to display as a highlighted field of the card.
Cards Per Row
Maximum number of cards to display per row. You can display up to 12 cards per row. Default is 3.
Note: The number of cards also depends on how you split a panel. Based on the space that a section of a panel gets, the section can display one or two cards.
The following table lists the field group properties in the Line 1 Fields and Line 2 Fields sections:
Property
Description
Fields
Fields to display in line 1 or line 2 of the card.
Display As
Optional. Indicates the arrangement style of the fields.
The following field arrangement options are available:
  • - Stacked. The fields are stacked vertically as columns.
  • - Concatenated. The fields are arranged in a series. For example, Name | Age | Gender.
Show field label
Optional. Indicates whether to show the field labels. To display the field labels, select the property.

Nested field groups in custom pages

Business entities can contain field groups nested within field groups. Use the fields component to add nested field groups to a custom page. You can render a nested field group as a form or a list.
If you add nested field groups to custom pages, you can configure properties for each field group level. For more information about configuring field group properties, see Field group properties.
Based on how you split a panel in a custom page, the number of nested field group levels appears in each section of the panel.
The following table lists the panel split ratios and the corresponding number of nested field group levels that you can view for these panels:
Panel Split Ratio
Number of Nested Field Group Levels
1:1:1
Three levels in each section.
1:1
Five levels in each section.
2:1
Eight levels in the first section, and three levels in the second section.
1:2
Three levels in the first section, and eight levels in the second section.
1:2:1
Two levels in the first and third section, and five levels in the second section.