Table Rows

The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

For design information see the table guidelines, starting with Table Overview, and the links below.

Feature Availability

   
 

Actions

 

Availability

Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

You can turn it off for edit mode.

Editable Multi-Input Fields Available in an object page in edit mode for all tables.
Inline Actions Available
Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
Conditional Enablement of Navigation Buttons For list report and object pages:

  • Available with SAP Fiori elements for OData V4
  • Requires an extension with SAP Fiori elements for OData V2
Single Item Selection Default
Multiple Item Selection Available
Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
Delete Available in responsive tables only
Custom Actions Available
Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
 

Display

 

Availability

Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
Rating Indicator Available
Progress Indicator Available
Quick Contact View Available
Avatar Available
Avatar Tooltip Available
Other Images Available with live box mode only
Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

In edit mode, the multiple values fields are editable in object page tables.

The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

Highlighting New Line Items Available with SAP Fiori elements for OData V2

Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

Highlighting Line Items Based on Criticality Available
 

Responsive Table Only

 

Availability

Multiple Fields in a Single Column Available
Smart Micro Chart Available

Actions


Empty Row for Data Entry in Create and Edit Modes

With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

The empty row:

  • Is displayed at the top of the responsive table.
    The toolbar has no Create button.
  • Is displayed at the end of a grid table.
    The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
  • Has no inline navigation action to the item via the chevron.
  • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

An empty row is displayed in the responsive table in create or edit mode
An empty row is displayed in the responsive table in create or edit mode

Automatic Creation of a New Empty Row

After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

The row with data in one field:

  • Is highlighted with a blue line to its left to show it’s a newly created draft
  • Displays the navigation chevron
  • Can also display an inline delete action
  • Displays error messages for mandatory fields without a value.

If users do not enter data in a new empty row, it is removed when the users save.

After the user starts entering data in the empty row, a new one is displayed
After the user starts entering data in the empty row, a new one is displayed

Drafts Saved for Rows

A draft for a once empty row is saved after the users:

  • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
  • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

Enablement Options

In draft-enabled applications, with both versions of SAP Fiori elements, you can enable or disable this feature for:

  • An application so the setting applies to all grid tables and responsive tables in all object pages
  • A table so it applies only to the table

When settings are made at both application and table levels, the table setting takes priority.

Additionally, with SAP Fiori elements for OData V2, you can enable or disable the feature at the object page level. When the settings are made at application, object page, and table levels, the setting at the most granular level takes priority, as follows: table, object page, application.

User-Enabled Creation of Empty Rows in Edit Mode

In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

Additional Settings

When you enable the empty row creation, for the empty row, you can also set:

  • Mandatory fields
  • Default values to populate fields
  • Fields to be read-only at creation time and become editable only after the row is saved

Mandatory Fields

In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

  • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
  • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
    • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
    • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
Guidelines
Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

You can do this in the i18n file for the application.

For more information see: Replacing Placeholder Text (SAP Fiori Elements).

Inline Actions

You can define actions for table rows or inline items. The action types can be:

  • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
  • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


Direct Edit

You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


Conditional Enablement of Navigation Buttons

In list reports and object pages:

  • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
  • With SAP Fiori elements for OData V2, this feature requires extensions.

For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

Guidelines
Implement this feature only when the way to enable the button is obvious to end users.

Item Selection

Both versions of SAP Fiori elements allow you to determine whether users can select:

  • One table row for a toolbar action, using a radio button.
  • Multiple table rows for a toolbar action, using checkboxes.
    For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
    For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

  • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
    For complete information, see: Select All / Clear All.
  • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
    You can change the limit. We recommend you consult the application team on how a change would impact performance.

SAP Fiori elements for OData V2

By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

SAP Fiori elements for OData V4

With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

  • In display mode, item selection is not possible.
  • In edit mode, when the delete action is enabled, multiple selection is also enabled.

Instead, you can enable one of the following selection modes:

  • None:
    • Display mode allows no item selection.
    • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
  • Single: Both display and edit modes allow single item selection.
  • Multi: Both display and edit modes allow multiple item selection.
Warning
When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

For more information, see:

Developer Hint
For more information, refer the development team to:


Delete

In responsive tables only, you can:

  • Display an inline delete action.
  • Prevent the deletion of certain rows.

In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

For more information, see Delete Single Item Rows.


Custom Actions

You can define custom inline actions.

Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


Messages for Critical Actions

For actions that you set as critical, you can display one of the following after the user triggers the action:

  • A message toast confirmation
  • A confirmation message box to check the users want to proceed with specific critical actions

Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

Guidelines
Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

Ask the development team whether or not the backend requires confirmations for your use case.

Example


SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
Default Text “Do you really want to execute the action <Action Label>?”

<Action Label> is the label shown on the button.

“Do you really want to perform this action?
Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

For more information, see UI Text Guidelines for SAP Fiori Apps.


Display

You can include the display features described below in a table row or inline item.


Read-Only Field

With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


Editing Status

By default, for draft-enabled applications, in a list report, the editing status is displayed:

  • In the first column of a responsive table
  • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

You can also add the semantic key to the status.

The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

  • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
  • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

For more information, see Tables.


Rating Indicator

You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

With extensions, you can enable editing of the rating indicator

For more information, see Rating Indicator.


Progress Indicator

You can:

  • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
  • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
  • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

For more information, see Progress Indicator.


Quick Contact View

You can add a quick view to a contact to display key contact details in a popover.

For applications with Microsoft Team integration, the contact quick view card displays options for starting an audio call, video call, or chat in with the contact in Microsoft Teams.

For more information, see Quickview.


Avatar and Other Images

You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

Warning
Other images are not displayed correctly within the table borders. Only use them with live box mode.

For more information, see Avatar.


Highlighting Line Items

By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

You can also define highlighting and icons for line items based on their criticality.

After a newly created item is saved, it is highlighted according to the criticality, as follows:

  • Green for success (criticality value 3)
  • Yellow for warning (criticality value 2)
  • Red for error (criticality value 1)
  • No highlighting for no criticality (criticality value 0)

Responsive Table Only

In a responsive table, you can include the display features described below in a table row or inline item.


Multiple Fields in a Single Column

You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

For example, you can display the following in a single column:

  • Company name
  • Company ID
  • Items in Stock
  • Progress Indicator for Items in Stock
  • Overall value of the Items
  • Multiple Action buttons that allow the user to both:
    • Execute an action while staying on the list report page
    • Navigate to other objects and applications

The visibility and position in the table of a column that combines multiple fields can be changed.

Field Labels

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

Limitation on Export to Spreadsheet

When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

Related Links

Table Rows

The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

For design information see the table guidelines, starting with Table Overview, and the links below.

Feature Availability

   
 

Actions

 

Availability

Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

You can turn it off for edit mode.

Editable Multi-Input Fields Available in an object page in edit mode for all tables.
Inline Actions Available
Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
Conditional Enablement of Navigation Buttons For list report and object pages:

  • Available with SAP Fiori elements for OData V4
  • Requires an extension with SAP Fiori elements for OData V2
Single Item Selection Default
Multiple Item Selection Available
Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
Delete Available in responsive tables only
Custom Actions Available
Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
 

Display

 

Availability

Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
Rating Indicator Available
Progress Indicator Available
Quick Contact View Available
Avatar Available
Avatar Tooltip Available
Other Images Available with live box mode only
Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

In edit mode, the multiple values fields are editable in object page tables.

The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

Highlighting New Line Items Available with SAP Fiori elements for OData V2

Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

Highlighting Line Items Based on Criticality Available
 

Responsive Table Only

 

Availability

Multiple Fields in a Single Column Available
Smart Micro Chart Available

Actions


Empty Row for Data Entry in Create and Edit Modes

With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

The empty row:

  • Is displayed at the top of the responsive table.
    The toolbar has no Create button.
  • Is displayed at the end of a grid table.
    The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
  • Has no inline navigation action to the item via the chevron.
  • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

An empty row is displayed in the responsive table in create or edit mode
An empty row is displayed in the responsive table in create or edit mode

Automatic Creation of a New Empty Row

After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

The row with data in one field:

  • Is highlighted with a blue line to its left to show it’s a newly created draft
  • Displays the navigation chevron
  • Can also display an inline delete action
  • Displays error messages for mandatory fields without a value.

If users do not enter data in a new empty row, it is removed when the users save.

After the user starts entering data in the empty row, a new one is displayed
After the user starts entering data in the empty row, a new one is displayed

In draft-enabled applications, you can enable the feature for a table with both versions of SAP Fiori elements. You can also:

  • Enable the feature for an application so it is the default for all grid and responsive tables in all object pages with SAP Fiori elements for OData V2. The setting for the table control overrides the one at application level.
  • Set default values to populate fields in the empty rows
  • Set mandatory fields
  • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

User-Enabled Creation of Empty Rows in Edit Mode

In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

Mandatory Fields

In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

  • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
  • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
    • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
    • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
Guidelines
Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

You can do this in the i18n file for the application.

For more information see: Replacing Placeholder Text (SAP Fiori Elements).

Drafts Saved for Rows

A draft for a once empty row is saved after the users:

  • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
  • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

Inline Actions

You can define actions for table rows or inline items. The action types can be:

  • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
  • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


Direct Edit

You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


Conditional Enablement of Navigation Buttons

In list reports and object pages:

  • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
  • With SAP Fiori elements for OData V2, this feature requires extensions.

For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

Guidelines
Implement this feature only when the way to enable the button is obvious to end users.

Item Selection

Both versions of SAP Fiori elements allow you to determine whether users can select:

  • One table row for a toolbar action, using a radio button.
  • Multiple table rows for a toolbar action, using checkboxes.
    For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
    For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

  • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
    For complete information, see: Select All / Clear All.
  • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
    You can change the limit. We recommend you consult the application team on how a change would impact performance.

SAP Fiori elements for OData V2

By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

SAP Fiori elements for OData V4

With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

  • In display mode, item selection is not possible.
  • In edit mode, when the delete action is enabled, multiple selection is also enabled.

Instead, you can enable one of the following selection modes:

  • None:
    • Display mode allows no item selection.
    • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
  • Single: Both display and edit modes allow single item selection.
  • Multi: Both display and edit modes allow multiple item selection.
Warning
When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

For more information, see:

Developer Hint
For more information, refer the development team to:


Delete

In responsive tables only, you can:

  • Display an inline delete action.
  • Prevent the deletion of certain rows.

In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

For more information, see Delete Single Item Rows.


Custom Actions

You can define custom inline actions.

Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


Messages for Critical Actions

For actions that you set as critical, you can display one of the following after the user triggers the action:

  • A message toast confirmation
  • A confirmation message box to check the users want to proceed with specific critical actions

Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

Guidelines
Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

Ask the development team whether or not the backend requires confirmations for your use case.

Example


SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
Default Text “Do you really want to execute the action <Action Label>?”

<Action Label> is the label shown on the button.

“Do you really want to perform this action?
Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

For more information, see UI Text Guidelines for SAP Fiori Apps.


Display

You can include the display features described below in a table row or inline item.


Read-Only Field

With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


Editing Status

By default, for draft-enabled applications, in a list report, the editing status is displayed:

  • In the first column of a responsive table
  • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

You can also add the semantic key to the status.

The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

  • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
  • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

For more information, see Tables.


Rating Indicator

You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

With extensions, you can enable editing of the rating indicator

For more information, see Rating Indicator.


Progress Indicator

You can:

  • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
  • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
  • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

For more information, see Progress Indicator.


Quick Contact View

You can add a quick view to a contact to display key contact details in a popover.

For applications with Microsoft Team integration, the contact quick view card displays options for starting an audio call, video call, or chat in with the contact in Microsoft Teams.

For more information, see Quickview.


Avatar and Other Images

You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

Warning
Other images are not displayed correctly within the table borders. Only use them with live box mode.

For more information, see Avatar.


Highlighting Line Items

By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

You can also define highlighting and icons for line items based on their criticality.

After a newly created item is saved, it is highlighted according to the criticality, as follows:

  • Green for success (criticality value 3)
  • Yellow for warning (criticality value 2)
  • Red for error (criticality value 1)
  • No highlighting for no criticality (criticality value 0)

Responsive Table Only

In a responsive table, you can include the display features described below in a table row or inline item.


Multiple Fields in a Single Column

You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

For example, you can display the following in a single column:

  • Company name
  • Company ID
  • Items in Stock
  • Progress Indicator for Items in Stock
  • Overall value of the Items
  • Multiple Action buttons that allow the user to both:
    • Execute an action while staying on the list report page
    • Navigate to other objects and applications

The visibility and position in the table of a column that combines multiple fields can be changed.

Field Labels

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

Limitation on Export to Spreadsheet

When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

Related Links

Table Rows

The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

For design information see the table guidelines, starting with Table Overview, and the links below.

Feature Availability

   
 

Actions

 

Availability

Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

You can turn it off for edit mode.

Editable Multi-Input Fields Available in an object page in edit mode for all tables.
Inline Actions Available
Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
Conditional Enablement of Navigation Buttons For list report and object pages:

  • Available with SAP Fiori elements for OData V4
  • Requires an extension with SAP Fiori elements for OData V2
Single Item Selection Default
Multiple Item Selection Available
Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
Delete Available in responsive tables only
Custom Actions Available
Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
 

Display

 

Availability

Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
Rating Indicator Available
Progress Indicator Available
Quick Contact View Available
Avatar Available
Avatar Tooltip Available
Other Images Available with live box mode only
Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

In edit mode, the multiple values fields are editable in object page tables.

The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

Highlighting New Line Items Available with SAP Fiori elements for OData V2

Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

Highlighting Line Items Based on Criticality Available
 

Responsive Table Only

 

Availability

Multiple Fields in a Single Column Available
Smart Micro Chart Available

Actions


Empty Row for Data Entry in Create and Edit Modes

With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

The empty row:

  • Is displayed at the top of the responsive table.
    The toolbar has no Create button.
  • Is displayed at the end of a grid table.
    The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
  • Has no inline navigation action to the item via the chevron.
  • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

An empty row is displayed in the responsive table in create or edit mode
An empty row is displayed in the responsive table in create or edit mode

Automatic Creation of a New Empty Row

After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

The row with data in one field:

  • Is highlighted with a blue line to its left to show it’s a newly created draft
  • Displays the navigation chevron
  • Can also display an inline delete action
  • Displays error messages for mandatory fields without a value.

If users do not enter data in a new empty row, it is removed when the users save.

After the user starts entering data in the empty row, a new one is displayed
After the user starts entering data in the empty row, a new one is displayed

In draft-enabled applications, you can enable the feature for a table with both versions of SAP Fiori elements. You can also:

  • Enable the feature for an application so it is the default for all grid and responsive tables in all object pages with SAP Fiori elements for OData V2. The setting for the table control overrides the one at application level.
  • Set default values to populate fields in the empty rows
  • Set mandatory fields
  • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

User-Enabled Creation of Empty Rows in Edit Mode

In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

Mandatory Fields

In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

  • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
  • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
    • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
    • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
Guidelines
Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

You can do this in the i18n file for the application.

For more information see: Replacing Placeholder Text (SAP Fiori Elements).

Drafts Saved for Rows

A draft for a once empty row is saved after the users:

  • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
  • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

Inline Actions

You can define actions for table rows or inline items. The action types can be:

  • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
  • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


Direct Edit

You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


Conditional Enablement of Navigation Buttons

In list reports and object pages:

  • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
  • With SAP Fiori elements for OData V2, this feature requires extensions.

For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

Guidelines
Implement this feature only when the way to enable the button is obvious to end users.

Item Selection

Both versions of SAP Fiori elements allow you to determine whether users can select:

  • One table row for a toolbar action, using a radio button.
  • Multiple table rows for a toolbar action, using checkboxes.
    For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
    For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

  • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
    For complete information, see: Select All / Clear All.
  • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
    You can change the limit. We recommend you consult the application team on how a change would impact performance.

SAP Fiori elements for OData V2

By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

SAP Fiori elements for OData V4

With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

  • In display mode, item selection is not possible.
  • In edit mode, when the delete action is enabled, multiple selection is also enabled.

Instead, you can enable one of the following selection modes:

  • None:
    • Display mode allows no item selection.
    • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
  • Single: Both display and edit modes allow single item selection.
  • Multi: Both display and edit modes allow multiple item selection.
Warning
When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

For more information, see:

Developer Hint
For more information, refer the development team to:


Delete

In responsive tables only, you can:

  • Display an inline delete action.
  • Prevent the deletion of certain rows.

In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

For more information, see Delete Single Item Rows.


Custom Actions

You can define custom inline actions.

Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


Messages for Critical Actions

For actions that you set as critical, you can display one of the following after the user triggers the action:

  • A message toast confirmation
  • A confirmation message box to check the users want to proceed with specific critical actions

Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

Guidelines
Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

Ask the development team whether or not the backend requires confirmations for your use case.

Example


SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
Default Text “Do you really want to execute the action <Action Label>?”

<Action Label> is the label shown on the button.

“Do you really want to perform this action?
Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

For more information, see UI Text Guidelines for SAP Fiori Apps.


Display

You can include the display features described below in a table row or inline item.


Read-Only Field

With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


Editing Status

By default, for draft-enabled applications, in a list report, the editing status is displayed:

  • In the first column of a responsive table
  • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

You can also add the semantic key to the status.

The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

  • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
  • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

For more information, see Tables.


Rating Indicator

You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

With extensions, you can enable editing of the rating indicator

For more information, see Rating Indicator.


Progress Indicator

You can:

  • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
  • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
  • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

For more information, see Progress Indicator.


Quick Contact View

You can add a quick view to a contact to display key contact details in a popover.

For applications with Microsoft Team integration, the contact quick view card displays options for starting an audio call, video call, or chat in with the contact in Microsoft Teams.

For more information, see Quickview.


Avatar and Other Images

You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

Warning
Other images are not displayed correctly within the table borders. Only use them with live box mode.

For more information, see Avatar.


Highlighting Line Items

By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

You can also define highlighting and icons for line items based on their criticality.

After a newly created item is saved, it is highlighted according to the criticality, as follows:

  • Green for success (criticality value 3)
  • Yellow for warning (criticality value 2)
  • Red for error (criticality value 1)
  • No highlighting for no criticality (criticality value 0)

Responsive Table Only

In a responsive table, you can include the display features described below in a table row or inline item.


Multiple Fields in a Single Column

You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

For example, you can display the following in a single column:

  • Company name
  • Company ID
  • Items in Stock
  • Progress Indicator for Items in Stock
  • Overall value of the Items
  • Multiple Action buttons that allow the user to both:
    • Execute an action while staying on the list report page
    • Navigate to other objects and applications

The visibility and position in the table of a column that combines multiple fields can be changed.

Field Labels

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

Limitation on Export to Spreadsheet

When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

Related Links

Table Rows

The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

For design information see the table guidelines, starting with Table Overview, and the links below.

Feature Availability

   
 

Actions

 

Availability

Empty Row for Data Entry in Create and Edit Modes Available in an object page in edit mode for responsive and grid tables: the table displays an empty row for data entry.

You can turn it off.

Editable Multi-Input Fields Available in an object page in edit mode for all tables.
Inline Actions Available
Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
Conditional Enablement of Navigation Buttons For list report and object pages:

  • Available with SAP Fiori elements for OData V4
  • Requires an extension with SAP Fiori elements for OData V2
Single Item Selection Default
Multiple Item Selection Available
Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
Delete Available in responsive tables only
Custom Actions Available
Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
 

Display

 

Availability

Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
Rating Indicator Available
Progress Indicator Available
Quick Contact View Available
Avatar Available
Avatar Tooltip Available
Other Images Available with live box mode only
Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

In edit mode, the multiple values fields are editable in object page tables.

The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

Highlighting New Line Items Available with SAP Fiori elements for OData V2

Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

Highlighting Line Items Based on Criticality Available
 

Responsive Table Only

 

Availability

Multiple Fields in a Single Column Available
Smart Micro Chart Available

Actions


Empty Row for Data Entry in Create and Edit Modes

With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

The empty row:

  • Is displayed at the top of the responsive table.
    The toolbar has no Create button.
  • Is displayed at the end of a grid table.
    The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
  • Has no inline navigation action to the item via the chevron.
  • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

An empty row is displayed in the responsive table in create or edit mode
An empty row is displayed in the responsive table in create or edit mode

Automatic Creation of a New Empty Row

After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

The row with data in one field:

  • Is highlighted with a blue line to its left to show it’s a newly created draft
  • Displays the navigation chevron
  • Can also display an inline delete action
  • Displays error messages for mandatory fields without a value.

If users do not enter data in a new empty row, it is removed when the users save.

After the user starts entering data in the empty row, a new one is displayed
After the user starts entering data in the empty row, a new one is displayed

Enablement of Empty Row Creation

In draft-enabled applications, with both version of SAP Fiori elements for OData, you can enable the feature for:

  • A specific table
  • An application so the feature applies to all grid and responsive tables in all object pages.
  • With SAP Fiori elements for OData V2 you can also define the setting at the object page level.

The setting for the table takes priority over the others. With SAP Fiori elements for OData V2, the object page setting takes priority over the application setting.


Additional Settings for Empty Rows

You can also set the following for empty rows:

  • Default values to populate fields in the empty rows
  • Mandatory fields
  • Read-only at creation time, the empty rows become editable after the users saves, for use cases where certain fields become relevant only after the save.

User-Enabled Creation of Empty Rows in Edit Mode

In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

Mandatory Fields

In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

  • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
  • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
    • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
    • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
Guidelines
Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

You can do this in the i18n file for the application.

For more information see: Replacing Placeholder Text (SAP Fiori Elements).

Drafts Saved for Rows

A draft for a once empty row is saved after the users:

  • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
  • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

Inline Actions

You can define actions for table rows or inline items. The action types can be:

  • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
  • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


Direct Edit

You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


Conditional Enablement of Navigation Buttons

In list reports and object pages:

  • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
  • With SAP Fiori elements for OData V2, this feature requires extensions.

For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

Guidelines
Implement this feature only when the way to enable the button is obvious to end users.

Item Selection

Both versions of SAP Fiori elements allow you to determine whether users can select:

  • One table row for a toolbar action, using a radio button.
  • Multiple table rows for a toolbar action, using checkboxes.
    For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
    For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

  • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
    For complete information, see: Select All / Clear All.
  • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
    You can change the limit. We recommend you consult the application team on how a change would impact performance.

SAP Fiori elements for OData V2

By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

SAP Fiori elements for OData V4

With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

  • In display mode, item selection is not possible.
  • In edit mode, when the delete action is enabled, multiple selection is also enabled.

Instead, you can enable one of the following selection modes:

  • None:
    • Display mode allows no item selection.
    • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
  • Single: Both display and edit modes allow single item selection.
  • Multi: Both display and edit modes allow multiple item selection.
Warning
When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

For more information, see:

Developer Hint
For more information, refer the development team to:


Delete

In responsive tables only, you can:

  • Display an inline delete action.
  • Prevent the deletion of certain rows.

In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

For more information, see Delete Single Item Rows.


Custom Actions

You can define custom inline actions.

Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


Messages for Critical Actions

For actions that you set as critical, you can display one of the following after the user triggers the action:

  • A message toast confirmation
  • A confirmation message box to check the users want to proceed with specific critical actions

Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

Guidelines
Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

Ask the development team whether or not the backend requires confirmations for your use case.

Example


SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
Default Text “Do you really want to execute the action <Action Label>?”

<Action Label> is the label shown on the button.

“Do you really want to perform this action?
Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

For more information, see UI Text Guidelines for SAP Fiori Apps.


Display

You can include the display features described below in a table row or inline item.


Read-Only Field

With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


Editing Status

By default, for draft-enabled applications, in a list report, the editing status is displayed:

  • In the first column of a responsive table
  • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

You can also add the semantic key to the status.

The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

  • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
  • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

For more information, see Tables.


Rating Indicator

You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

With extensions, you can enable editing of the rating indicator

For more information, see Rating Indicator.


Progress Indicator

You can:

  • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
  • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
  • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

For more information, see Progress Indicator.


Quick Contact View

You can add a quick view to a contact to display key contact details in a popover.

For more information, see Quickview.


Avatar and Other Images

You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

Warning
Other images are not displayed correctly within the table borders. Only use them with live box mode.

For more information, see Avatar.


Highlighting Line Items

By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

You can also define highlighting and icons for line items based on their criticality.

After a newly created item is saved, it is highlighted according to the criticality, as follows:

  • Green for success (criticality value 3)
  • Yellow for warning (criticality value 2)
  • Red for error (criticality value 1)
  • No highlighting for no criticality (criticality value 0)

Responsive Table Only

In a responsive table, you can include the display features described below in a table row or inline item.


Multiple Fields in a Single Column

You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

For example, you can display the following in a single column:

  • Company name
  • Company ID
  • Items in Stock
  • Progress Indicator for Items in Stock
  • Overall value of the Items
  • Multiple Action buttons that allow the user to both:
    • Execute an action while staying on the list report page
    • Navigate to other objects and applications

The visibility and position in the table of a column that combines multiple fields can be changed.

Field Labels

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

Limitation on Export to Spreadsheet

When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.


Smart Micro Chart

You can:

  • Add an inline micro chart.
  • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

You can choose among the following micro chart types:

  • Area micro chart
  • Bullet micro chart
  • Line micro chart
  • Micro chart/smart micro chart
  • Radial micro chart
  • Stacked bar micro chart
Warning
The user cannot navigate to another page from the chart.

For more information on chart types, see: Choosing the Correct Chart Type.

Related Links

Table Types

The SAP Fiori elements templates support the features and settings for the different table types detailed below.

For design information, see the guidelines starting with Table Overview, and see the links below.

Feature Availability

Table Type

Responsive Table (Default)

Analytical

Grid

Tree

SAP Fiori Elements for OData Version

V2 & V4

 V2 & V4

 V2 & V4

 V2 & V4

Devices
Desktop         
Tablet         
Phone          
Responsive
(hide column, popin support)
         
Density Mode

See Content Density.

See Analytical Table: Compact, Cozy, Condensed. See Grid Table: Compact, Cozy, Condensed. See Tree Table: Types.
Compact density            
Condensed density         
Cozy density         
Summarized cell          
Hierarchical data           
Large number of rows (> 200)         
Grouping         
Freeze columns         
Horizontal scrolling         
Merge duplicates          
Supported Inline Controls All Limited 
See Inline Controls for Non-Responsive Tables below.
Limited
See Inline Controls for Non-Responsive Tables below.
Limited
See Inline Controls for Non-Responsive Tables below.
Row-based         
Column-based         

Inline Controls for Non-Responsive Tables

These inline controls are supported for grid, analytical, and tree tables:

  • Text
  • Label
  • ObjectStatus
  • Icon
  • Button
  • Input
  • DatePicker
  • Select
  • ComboBox
  • MultiComboBox
  • CheckBox
  • Link
  • Currency
  • RatingIndicator
  • ProgressIndicator

Also, the following when they are of a responsive or very small size:

  • StackedBarMicroChart
  • ComparisonMicroChart
  • BulletMicroChart

Related Links

Elements and Controls

Table Features

The SAP Fiori elements templates support the features and settings for a table detailed below.

For design information see the table guidelines, starting with Table Overview, and the links within this article.

Feature Availability

 

Table Settings

 

Availability

Column Header Labels You set these.
Asterisk in Labels for Mandatory Fields In the object page, by default, a red asterisk (*) displays in the column header label for mandatory table fields with SAP Fiori elements for OData V4.
Tooltips on Column Headers Default
Clear All The Clear All  checkbox is displayed by default in both the list report and object page when the selection of multiple rows is enabled for:

  • Grid tables
  • Analytical tables
  • Tree tables

You can change the default.

Select All The Select All  checkbox is displayed by default when the selection of multiple rows is enabled for a responsive table.

You can change the default.

Sticky Column Header Behavior Default, you can turn it off.
Column Width The default width depends on the column contents. You can change it.
Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

You can change the level of importance.

 Freezing Columns

Available in analytical tables, grid tables, and tree tables for the number of columns that you decide.

Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
Ascending Sort Order on a Column Default, you can change it.
Quick Sort on a Column Available
Grouping Available in responsive and analytical tables, not in grid tables
Grouped Totals in Analytical Tables For now, an asterisk (*) is displayed instead of a figure for grouped totals of items with different units of measure in the same group.
Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
Message Strip above the Table You can display a custom message above the table in the:

  • List report, object page, and analytical page with SAP Fiori elements for OData V2
  • List report with SAP Fiori elements for OData V4

In the object page, by default, a message strip is displayed when there are errors in the table.

When there are multiple messages, the one with the highest severity is displayed.

Generic Context Menu Activated by default for all table types.
Order of Nodes in the Tree Table

With SAP Fiori elements for OData V4, by default, the tree table always displays a newly created node as the first in the table or as the first child below its parent node, even when a sort or a filter is applied to the table.

You can change the default.

 

List Report and Analytical Page Only

 

Availability

Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
 

List Report Only

 

Availability

Copy Available
 

Object Page Only

 

Availability

Message Strip for Rows with Errors Default
Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

  • Anchor bar navigation and a single section that contains only a grid table
  • Tab bar navigation and a current tab that contains only a grid table

Table Settings


Tooltips on Column Headers

On desktop applications, all table columns display tooltips, based on the text in:

  • Common.QuickInfo, when it’s visible
  • The column label, in all other cases

Tooltips are available only in desktop applications because users must hover their mouse on the column header to see them.


Clear All / Select All

When the selection of multiple rows is enabled for a table in the list report and object page, the Clear All checkbox is displayed by default in the selection column header for all tables, but the responsive table. You can change the default.

Information
To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

 Table Type

Selection Default

Users Can Select

Grid table

Analytical table

Tree table

Clear All   Up to 200 rows by default

We recommend you consult the application development team on how changes to the limit would impact performance.

Responsive table Select All   All the rows displayed on the interface, not all the rows in the table.

A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

Warning
For grid tables, analytical tables, and tree tables, changing the default Clear All checkbox to the Select All  checkbox can lead to performance issues because Select All   loads all the table rows to the frontend.

Always ask the application development team about the impact on performance before you consider such a change.

Guidelines
When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

Column Width

The default column width varies according to the column contents:

  • Text: can range from 3 to 20 rem
  • Image: 5 rem
  • Rating or progress indicator: 6.875 rem
  • Chart: 20 rem

You can can change the width.

You can also ask the application developers to ensure the column width takes into account the contents of both the column and the column header.

Developer Hint
For more information, refer the development team to Setting the Default Column Width.

Column Importance in Responsive Tables

By default:

  • Key fields have high importance in list reports.
  • Other columns have the importance of none and are handled like columns assigned medium importance.

You can change the level of importance.

The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

  • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
  • The values in columns with low importance are first to be hidden.

When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

You can also assign an importance to custom columns.

For more information, see:


Freezing Columns

You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

Developer Hint
For more information, refer application developers to Tables.

Labels for Multiple Fields in a Column

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


Sort Order

By default, the sort order for a column is ascending.

You can:

  • Set the default sort order to descending.
  • Define other, customized sort orders.

For more information, see the sort guidelines according to table type:


Quick Sort on a Column

Available for any sortable column.

When a column contains a combination of fields, such an ID and a description or a field group, the users can specify a sort and sort order for each field in the column with the quick sort.


Number of Table Rows Displayed at Once

By default, a responsive table loads the following number of rows at once:

  • 20 rows in a list report.
  • 10 rows in an object page with multiple sections.

When more rows exist, the users can click the More button at the end of the table to view additional rows.

With SAP Fiori elements for OData V2, you can change the default number.

For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

Guidelines
Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

Grouping

Grouping is available in responsive and analytical tables.

You can define the format of the grouping headers.

For more information, see:



No Data Found Text

By default, the following text is displayed when no data is found.

  • When the user has not applied filters, the text is “No data found.”
  • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
Guidelines
Replace the generic text with text that’s meaningful to the user.


Generic Context Menu

By default, on desktop and mobile applications, a generic context menu is activated and cannot be deactivated for all table types with both versions of SAP Fiori elements for OData.

The generic context menu generally behaves like the standard context menu described in the corresponding table articles, linked below.

The context of the generic context menu can be either a single row or multiple selected rows.

The following action types are available on the generic context menu:

  • All toolbar actions that become active only if rows are selected

Developers call them “bounded toolbar actions” or “context-dependent actions.”

The generic context menu for tree tables can contain the Move Up and Move Down actions that serve to reorder nodes within the same hierarchical level, with SAP Fiori elements for OData V4.

  • The “Open in New Tab or Window” action

It allows up to 10 items to be opened in separate tabs or windows depending on the user’s browser settings.

Similar to the standard context menu, if a control inside a row is the “click target”, and the control also provides a context menu, the control menu “wins”.



Single row context - a non-selected row is the
Single row context - a non-selected row is the "click target" so the context menu applies to the non-selected row
Multiple row context - one or more selected rows are the
Multiple row context - one or more selected rows are the "click target " so the context menu applies to all the selected rows

Order of Nodes in the Tree Table

With SAP Fiori elements for OData V4, by default, a newly created node is always displayed first in the table or as the first child below its parent node, even when a sort or a filter is applied to the table. For example, a node created:

  • At the root of the table is displayed first in the table
  • In a container node is displayed first in the container node

Instead, you can enable an option to display new nodes in the order that they were created in the table or parent node. For example, a node created:

  • At the root of the table is displayed as the last in the table
  • In a container node is displayed last in the container node

This feature allows users to act directly on the table hierarchy — not just its display — when they:

  • Create new table elements
  • Reorder nodes from the generic context menu, by moving them up or down in the table or in their parent nodes
Information

  • With this feature, a message [strip/toast] informs the user when the filter criteria applied to a table prevents a new node from being displayed.
  • For backend systems on RAP, this feature is unavailable for tree tables in a list report.

Developer Hint
For more information, refer application developers to Tree Tables.

List Report and Analytical Page Only

Initial Expansion of Table Levels

By default, on initial load, the following expandable tables are expanded to this number of levels:

  • Responsive table: 1 level
  • Tree table: 1 level
  • Analytical table: 0 levels

You can change the default value for the tree table and analytical tables.

Developer Hint
For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

Message Strip for Rows with Errors

When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


Object Page Only

Message Strip for Rows with Errors

When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.

Related Links

List Report – Header

The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

For design information, see the List Report Floorplan guidelines and the links below.

Warning
Put all controls for searching and filtering data in the list report filter bar.

Do not include the search or filter options that are available in the table header.

Feature Availability

 

Features

 

Availability

Page-Level View Management Default, you can turn it off.
Share Menu Default
Manual Update Mode Default
Live Update Mode Available
Search Available
Filter Bar Default
Initial State of Header Default:

  • Expanded on large screens
  • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
Editing Status Filter Default for draft-enabled applications.

You can hide it.

Input Controls for Filters Default
Adapt Filters UI Element
  • Default: dialog with SAP Fiori elements for OData V2
  • Default: popover with SAP Fiori elements for OData V4

Feature Details


Page-Level View Management

By default, page-level view management is enabled and the header displays a page title.

You can disable it.

Guidelines
If you disable page-level view management, you must display a header title.

For more information, see Header Title.


Share Menu

By default, the header contains the generic Share menu with the global actions Send Email and Save as Tile. It can also include the:

  • Share in SAP Jam menu item when SAP Jam integration is configured.
  • Microsoft Teams > As Chat and As Card options when the required settings have been made by the system administrators of SAP S/4HANA or SAP S/4HANA Cloud.

This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA or SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA or SAP S/4HANA Cloud system with co-workers.

With SAP Fiori elements for OData V4, you can control the visibility in the Share menu of the Send E-mail and Share: Microsoft Teams options at both application level and page level.

Save as Tile

The tile created opens the list report with the same results shown at the time the tile was saved.

Users can also save a dynamic tile for results shown after the users have filtered for a relative date value, such as today or this year.

    For more information, see:

    Developer Hint
    For more information, refer application developers to:


    Update Mode

    By default, the update mode is manual.

    You can enable live update mode instead.

    For more information, see Live Update / Manual Update.


    Search

    By default, the search is disabled.

    You can enable it.

    The limit for search strings is 1000 characters.

    Guidelines
    Work with the development team to define the searchable properties in the data.

    For more information, see Search.


    Filter Bar

    SAP Fiori elements for OData V2 uses the smart filter bar.

    SAP Fiori elements for OData V4 uses the filter bar.

    With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

    • Remove all filter values

    • Reset the value in the Editing Status filter to All

    Warning
    Put all controls for searching and filtering data in the list report filter bar.

    Do not include the search or filter options that are available in the table header.

    Initial State of Header

    The default behavior is shown below:

    Screen Size

    Application Starts with Data

    Application Starts without Data

    S Collapsed Expanded
    M Collapsed Expanded
    L Expanded Expanded
    XL Expanded Expanded

    Pin Button

    With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

    The pin option keeps the header collapsed or expanded when the user scrolls.

    The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

    For more information see, Pinning the Header Content.


    Editing Status Filter

    By default, the filter is enabled for draft-enabled applications. You can disable it.

    The filter values and corresponding results are as follows:

    • All (Default value):
      • All saved (or active) versions of the documents for which the current user has no drafts
      • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
    • All (Hiding Drafts): Only the saved objects.
    • Own DraftDrafts that the current user can display or edit.
    • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
    • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
    • No Changes: Saved versions with no corresponding draft.

    For more information, see Draft handling.


    Input Controls for Filters

    You can decide which filter/input controls to use and set the following for them:

    • The properties available as a filter criterion
    • The labels for the filter fields
    • The default filter values
    • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
    • Type-ahead for values entered
    • Value help lists
      By default, a dialog conditions tab is displayed for the value help. Remind application developers to define the right value help options.
    Developer Hint
    For information on defining the value help, refer application developers to Field Help.

    You can also:

    • Decide on the selection controls for the filters
    • Restrict the values accepted in the field. By default, the field accepts multiple values.
    Guidelines
    Date Picker and Date / Time Picker

    By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

    When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

    For more information refer them to: Configuring Filter Fields.

    For more information, see:


    Adapt Filters

    By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

    You can configure the following:

    • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
    • Additional groups for the filters
    • Show input fields: Visible by default. You can hide the Hide value/Show value button.

    Users can add additional fields through views.

    The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

    By default, the Reset button is displayed, you cannot change this.

    For more information, see: Adapt Filters.

    Related Links

    Elements and Controls

    Table Toolbar

    The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

    For design information, see the guidelines starting with Table Overview, and see the links below.

    Feature Availability

     

    List Report and Object Page Features

     

    Availability

    Title Visible by default.

    You can  hide it.

    You can show the table row count next to the title.

    Infobar Default for all table types, the infobar summarizes the filter criteria applied to the table data. It is displayed below the table toolbar and above the column headings when at least one filter is set.
    Order of Toolbar Actions With SAP Fiori elements for OData V4, you can order the toolbar actions according to their importance, starting with the most frequently-used action and ending with the most seldom-used action, regardless of whether the action is a custom or standard one.
    Table Personalization Actions Default, you can turn them off.
    Show/Hide Details Available in responsive tables
    Mass Edit Available in draft-enabled applications:

    • In both the list report and object page with SAP Fiori elements for OData V4
    • In the list report with SAP Fiori elements for OData V2
    Export With SAP Fiori elements for OData V4:

    • Export to Spreadsheet is enabled by default.
    • Export to PDF is available.

    With SAP Fiori elements for OData V2, Export to Excel is enabled by default in:

    • A list report table
    • An object page table only if the Paste icon is displayed
    Copy to Clipboard The Copy button is displayed in the table toolbar by default.
    Paste from Clipboard The Paste icon is displayed only if the table supports the paste action.
    Application-Specific Actions Available
    Actions Disabled Before Row Selection Available
    Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

    Requires an extension with SAP Fiori elements for OData V2

    Messages for Critical Actions Available
    Messages for Destructive Actions Available
    Multiple Views on a Table Available
     

    List Report Only Features

     

    Availability

    Toolbar Sticky Behavior Default, you can turn it off.
    Standard ActionsCreate and Delete Default, you can turn them off.
    Object Creation via an Object Page Default, you can change it.
    Object Creation via a Dialog Available in certain conditions
    Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
    Copy Object Available

    You determine the label on the action button.

    Hiding Actions in Multiple Content Layout Available
    Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
    Add Card to Insights Default when My Home in SAP S/4HANA Cloud is enabled.

    You can turn it off.

     

    Object Page Only Features

     

    Availability

    Search Available, when the data allows it.
    Edit Default, when the data allows it.
    Delete Default, when the data allows it.
    Subobject Creation via Subobject Page Default, you can change it.
    Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
    Create Not Visible In certain conditions
    Inline Creation Available, in draft-enabled applications for grid and responsive tables
    Prefilling Fields for New Object Creation Available, in draft-enabled applications
    Full Screen Mode for Table Display Available, not recommended
    Segmented Button for Switching Table Views Default for a table with a maximum of three views
    Select Control for Switching Table Views Default for a table with four or more views

    List Report and Object Page Features

    The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


    Table Personalization Actions

    By default, Sort, Group and Order actions are enabled.

    These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

    For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

    Table-level view management is not a prerequisite for personalization.

    For more information, see Table Personalization (Overview).



    Show / Hide Details

    The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

    After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

    The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

    • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
    • The values in columns with low importance are first to be hidden.

    By default in responsive tables:

    • Key fields have the importance set to high in list reports.
    • Other columns have the importance set to none and are handled like columns assigned medium importance.

    You can change the level of importance.


    Mass Edit

    You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

    • List report with SAP Fiori elements for OData V2
    • List report and object page with SAP Fiori elements for OData V4

    List Report

    Users cannot apply the mass edit to a draft record.

    The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

    Object Page

    With SAP Fiori elements for OData V4, you can enable the mass edit for a table in the object page. When the object page is in display mode, users can apply the mass edit to the subobjects in a table.

    Fields Displayed in the Edit Dialog

    By default, the Edit dialog contains all the table columns that are currently visible and editable.

    The application team can define the fields that display in the dialog, by both:

    • Including fields in the dialog that are not displayed in the table
    • Excluding fields from the dialog fields that are displayed in the table
    Developer Hint
    For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


    Export

    The export action exports the values in a table. When enabled, it is displayed in the table toolbar.

    • With SAP Fiori elements for OData V4:
      • Export to Spreadsheet is enabled by default.
      • Export to PDF is available.
      • By default, a maximum of 1000 rows can be exported. The application development team can change the limit.
      • Columns that contain a multi-input field (1:N) are not exported.
    • With SAP Fiori elements for OData V2 Export to Excel is enabled by default in:
      • A list report table
      • An object page table if the Paste icon is available

    For more information see Export to Spreadsheet.


    Copy and Paste

    Users can copy data from external applications — such as Microsoft Excel or Microsoft Word — or from other SAP Fiori elements applications to the clipboard, and then paste the data from the clipboard to tables in SAP Fiori elements applications that are editable.

    Copy to Clipboard

    By default, the Copy action is displayed in the table toolbar.

    With it, users can copy multiple rows or ranges of rows and columns to the clipboard.

    They can select a range of cells in rows or columns:

    Paste from Clipboard

    The Paste action is displayed in the table toolbar if the table supports it.

    After users copy data from another SAP Fiori elements application or an external application, they can paste it to:

    • The table

    Users set the focus on the table or select an empty row before pasting the data. One or more new rows are created for the pasted data.

    This feature is available only for draft-enabled applications and for tables where inline creation or the insertion of empty rows has been enabled.

    • A cell or range of cells, only in grid and responsive tables

    Users select a cell or cell range within the table and paste the data. If the selected cell or cells are in:

      • Active or draft rows, the pasted data replaces the values in those rows.
      • An empty row, new rows are created for the pasted data.

    To paste, they can use the Paste action in the toolbar or use a keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

    Limitations

    • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
    • If there are validation errors, a dialog displays an error message so the user can take remedial action.
    • The greater the number of records copied, the longer the paste operation takes.
    • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
    • Users cannot paste data into custom columns of tables.
    • This feature is not supported for custom tables.
    Information
    Pasting the data from the clipboard into another SAP Fiori elements table can cause formatting issues because the copy action doesn’t separate the content of fields that include more than one value, for example, a field with both an amount and a currency or both a value and its description.

    Instead, we recommend users export the data into a spreadsheet format that separates multiple values in one field into separate columns, with a single value in each, and then, adjust the format to match the one the target table.

    Developer Hint
    For more information, refer application developers to


    Application-Specific Actions

    You can define these actions and the text displayed on the buttons.

    The application team can control when the action button is displayed and enabled.

    For application-specific actions, application teams can define custom keyboard shortcuts.

    For more information, see:

    Developer Hint

    For more information on shortcuts, refer application developers to Keyboard Shortcuts.


    Actions Disabled Until the User Selects a Row

    You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

    Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

    For more information, see UI Element States.


    Conditional Enablement of Navigation Buttons

    With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

    With SAP Fiori elements for OData V2, this feature requires extensions.

    For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

    Guidelines
    Implement this feature only when the way to enable the button is obvious to end users.

    Messages for Critical Actions

    For actions that you set as critical, you can display one of the following after the user triggers the action:

    • A message toast confirmation
    • A confirmation message box to ensure the user wants to proceed with specific critical actions

    Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

    Guidelines

    Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

    Ask the development team whether or not the backend requires confirmations for your use case.

    Example


    SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
    Default Text                          “Do you really want to execute the action <Action Label>?”

    <Action Label> is the label shown on the button.

    “Do you really want to perform this action?
    Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


    Messages for Destructive Actions

    By default, a message is displayed for confirmation of an action that will delete or destroy important data.

    Guidelines

    Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

    Ask the development team whether or not the backend requires confirmations for your use case.

    Example


    SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
    Default Text The default message reuses the title and the description defined for the object in the table.

    • In flexible column layout: Delete object <title> <description>?

      For example, “Delete object 12345 (Sales Order)?”

    • In full screen mode: Delete object <title>?

      For example, “Delete object 12345?”

    “Do you really want to perform this action?
    Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


    Multiple Views for a Table

    You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

    For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

    With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

    List Report Only Features

    The information below relates only to table toolbar actions and settings in the list report floorplan.


    Standard Actions

    By default, Create and Delete are enabled.

    You can disable them.

    You can also enable or disable the Delete button based on conditions specified in the backend.

    Example

    You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

    Warning
    In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

    Create Object Actions

    By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

    Via a Dialog

    The action opens a dialog in modal view so the user can enter the data.

    With SAP Fiori elements for OData V2, you can:

    • Include a maximum of eight fields in the dialog
    • Enable filter values saved in the filter bar to prefill fields in the dialog
    Warning
    When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

    Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

    With Default Values That Prefill Fields for the New Object

    This feature is available with:

    • SAP Fiori elements for OData V2 for applications without draft handling
    • SAP Fiori elements for OData V4

    Via a Dialog with a Reference to an Existing Object of the Same Type

    With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

    The user:

    1. Clicks the action button.
      You can name the button to suit your use case.
    2. Selects the value of the existing object to reference in the dialog.
    3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
    4. Completes additional fields for the new object in the object page.
    Create from existing object
    Create from existing object
    Developer Hint
    For more information, refer application developers to:

    Copy Object

    You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the selected object.

    You set the label for the button according to your use case. Otherwise, the default label is Copy.

    In the toolbar, the Copy button is displayed after the Create button.

    Developer Hint
    Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

    Hiding Actions in Multiple Content Layout

    You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

    For more information, see:


    Add Card to Insights

    By default, the Add Card to Insights option is displayed in the overflow toolbar of list report tables with the single content layouts when My Home in SAP S/4HANA Cloud is enabled.

    You can ask the application development team to turn the option off.

    For more information, see: Simple Content Layout.


    Developer Hint
    For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.

    Object Page Only Features

    The information below relates only to table toolbar actions and settings in the object page floorplan.


    Search

    You can enable a search on the table.

    The limit for search strings is 1000 characters.

    For more information, see Search.


    Edit

    By default, Edit is displayed when the business object shown in the table is editable.


    Delete

    By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

    You can enable or disable the Delete action to allow users to delete only in certain conditions.

    For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

    When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

    Warning
    In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

    Subobject Creation

    By default:

    • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
    • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

    You can:

    • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
    • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
    • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
    • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
    Guidelines
    Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

    For more information, see:


    Create Action Visibility

    Whether or not the Create action is visible in the table toolbar depends on:

    • The object page mode.
    • Whether the flow is global or local.
    • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

     

    Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

    Global Flow for Draft-Enabled

    Applications with Fiori Elements for OData V2

    • Navigation indicators   are visible (if required).
    • Create button is not visible.
    • Navigation indicators   are visible (if required).
    • Create button is visible.
    • Navigation indicators   are visible (if required).
    • Create button is visible.

    Local Flow for Non-Draft Enabled Applications

    • Navigation indicators   are visible (if required).
    • Create button is visible.
    • Navigation indicators   are not visible.
    • Create button is not visible.
    Not Supported.

    Inline Creation

    You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

    The inline creation adds a new row to the table where the users can enter the subobject data.

    By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

    You can:

    • Work with the development team to define a custom sort order.
    • Enable default values to prefill the fields for the new object.

    For more information, see Add Items.


    Prefilling Fields for a New Object

    You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

    The new object must be the main object on the object page.

    You determine both the fields to prefill and the default values for the fields.


    Full Screen Mode for Table Display

    You can enable full screen mode for a table. However, it is generally not recommended.

    Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

    For more information on the restrictions for this feature, see Maximize/Minimize.


    Content Switch for Table Views

    The number of views defined for a table determines the UI control that lets users switch the table views:

    By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

    Related Links

    Object Page – Content Area

    The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

    For design information, see the Object Page Floorplan guidelines and the links below.

    Warning
    Always build the object page using the dynamic page header.

    Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

    Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

    Feature Availability

     

    Content Area

     

    Availability

    Draft Object Validation Default

    Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

    Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
    Navigation Bar: Tab Bar Available
    Sections and Subsections Available
    Reuse Components as Sections Available
     

    Subsections

     

    Availability

    Link Available

    With SAP Fiori elements for OData V4, you can display an icon or image with the link.

    With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

    Contact Facets Available
    Tables Available
    Charts Available
    Views for Tables and Charts Available
    Address Available
    Display of Related Properties Together Available with SAP Fiori elements for OData for V4

    The properties can also display as links.

    Forms Available
    Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

    You can:

    • Change the maximum
    • Enable growing mode
    • Show users the number of characters allowed in the text area
    File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
    Dynamic Side Content Available with an extension
     

    Subsection Behavior

     

    Availability

    Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
    Adjustment of the Width for Content Display in a Subsection Available
     

    Content Visibility

     

    Availability

    Visible Sections, Subsections, Quickviews, and Tables Default
    Hiding Section, Subsection, Quickview and Table Content Available
    User-Controlled Visibility with Show More/Show Less Available
    Visible Smart Form Fields Default, you can hide them in certain conditions.

    Content Area

    Draft Object Validation

    By default, data validation for the object page happens only when the users save the object so they enter data without interruption.

    They can trigger data validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

    For more information, see: Form Field Validation


    Navigation Bar

    By default, the anchor bar is generated when the object page has more than one section.

    It lets users navigate to the individual content area sections.

    You can:

    • Hide the anchor bar when you only have one section.
    • Replace it with a tab bar.

    With extensions, you can replace the buttons with another type of control.

    If there is no Anchor Bar, but there is editable information in the header, the first temporary section in the Object Page which controls the header content will have a section title called ‘Header’.

    For more information, see:


    Sections and Subsections

    You can add sections and subsections to the content area.

    Sections contain only subsections. You build the subsection content with tables, charts, and forms.

    When the object page uses:

    • Tab bar navigation, the section title isn’t displayed in the content area
    • Anchor bar navigation, only the title of the first section is hidden in the content area, unless the first section contains a table
      Guidelines

      When you assign a section or subsection title, do not use a comma (,) in it because commas serve as delimiters in SAP Fiori elements.

      Section and Subsection Titles

      To minimize both the number of titles displayed and redundancies among the title values:

      • When a section or subsection contains a single table or chart control, only the control title is displayed, but its value is replaced by the section or subsection title.
      • For sections or subsections that contain a single text area, with SAP Fiori elements for OData V4, application teams can enable an option to display the section or subsection title instead of the text area label when the object page is in display mode. With the option enabled, the label is only displayed in edit mode if the field is mandatory.

      For more information, see: Sections and Subsections.


      Reuse Components as Sections

      You can embed a reuse component as a section in the object page.

      Warning
      A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

      Consult the development team on the requirements for the reuse component.

      Subsections

      Contact Facets

      With both versions of SAP Fiori elements, in subsections, you can include a link that users can click to see additional information in a quickview.

      For applications with Microsoft Team integration, the contact card and the quick view card both display options for starting a Microsoft Teams audio call, video call, or chat with the contact.

      For more information, see:


      Tables

      You can include a table in a subsection.

      When a table is the only content in a subsection, the subsection title is not displayed. Instead, the title of the table shows the value assigned to the subsection title.

      For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


      Charts

      You can include a single chart facet in a subsection.

      In the chart, you can:

      • Display measures, their aggregation calculations, and dimensions to categorize the measures.
      • Add custom actions to the toolbar for a chart and define whether they are enabled at all times or only after the user selects part of the chart for the action.
      • Allow users to personalize the chart settings

      When a chart is the only content in a subsection, the subsection title is not displayed. Instead the title of the chart shows the value assigned to the subsection title.

      SAP Fiori Elements for OData V2

      Charts are only supported for business objects or services that are not draft enabled or are read-only.

      SAP Fiori Elements for OData V4

      You can define a chart for a draft-enabled business object. The chart only displays active data, not data entered into an unsaved draft record.

      For more information, see Chart (VizFrame).

      For more information on chart options, see Chart.

      Developer Hint
      For more information, refer application developers to Configuring Charts.


      Views for Tables and Charts

      You can turn on views for:

      • All the tables and charts on the page
      • Individual tables and charts

      For more information, see Views (Variant Management).


      Address

      You can add one or more address fields:

      • As a separate subsection
      • As part of a field group within a subsection
      • To a quick view with smart link navigation

      For more information, see:


      Display of Related Properties Together

      You can display two related properties side-by-side and with a single label in display mode.

      For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

      You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

      In edit mode, the fields can be edited separately.

      Side-by-side display of related properties
      Side-by-side display of related properties

      Related Properties as Links

      The related properties can also display as links.

      Developer Hint
      Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
      Related properties as links
      Related properties as links


      Forms

      You can add action buttons to the toolbar for a form contained in a subsection.

      With SAP Fiori elements for OData V4, you can also add an action next to the form header.

      The action types can be:

      • Actions that occur in the system while the user stays on the object page.
      • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

      Conditional Enablement of Navigation Buttons

      You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

      For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

      Guidelines
      Implement this feature only when the way to enable the button is obvious to end users.

      Columns in a Form

      To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

       

      Column Number

      Screen Size

      1 Small
      2 Medium
      3 Large
      6 Extra large
      Guidelines
      The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

      Groups in a Form

      You can group fields in a form and assign a name to the group.

      Note that the group name is displayed only when a group contains fields.

      User-Controlled Load of Fields with Low Importance

      To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

      After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

      Text Control

      By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

      You can:

      • Set a maximum number of lines for the text control that’s greater than four.
      • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
      • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

      A notification is displayed if the users try to enter text beyond the limit.

      In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

      File Upload

      With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

      For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

      The application developers can define the file size and types allowed for upload.


      Dynamic Side Content

      You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

      With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

        Guidelines

        • Do not use tables in the side content panel.
        • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
        • For the best view of the dynamic side content, set it to display in 50% of the screen.

        For more information, see:

        Developer Hint

        Subsection Behavior

        Subsection Loading Behavior

        By default, the subsection starts loading after the main object page elements are loaded.

        You can change the loading behavior to load the subsection after the header data is loaded.

        Example

        When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


        Width for Content Display in a Subsection

        When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.


        Content Visibility

        Sections, Subsections, Quickviews, and Tables

        By default, the object page displays these components.

        You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


        User-Controlled Visibility

        You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

        • When the subsection is hidden, Show More is displayed.
        • When the subsection shows, the Show Less link is displayed.


        Visibility of Smart Form Fields

        By default, all smart form fields have the high importance setting and show on all screen sizes.

        You can lower the level of importance for the fields to hide them on smaller screens.

        According to the importance assigned to the field, it is displayed as follows:

        • High (default): On all (small, medium, and large) screen sizes.
        • Medium: On large and medium screens only.
        • Low: On large screens only

        For more information, see Responsiveness.

        Related Links

        Table Rows

        The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links below.

        Feature Availability

           
         

        Actions

         

        Availability

        Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

        You can turn it off for edit mode.

        Editable Multi-Input Fields Available in an object page in edit mode for all tables.
        Inline Actions Available
        Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
        Conditional Enablement of Navigation Buttons For list report and object pages:

        • Available with SAP Fiori elements for OData V4
        • Requires an extension with SAP Fiori elements for OData V2
        Single Item Selection Default
        Multiple Item Selection Available
        Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
        Delete Available in responsive tables only
        Custom Actions Available
        Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
         

        Display

         

        Availability

        Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
        Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
        Rating Indicator Available
        Progress Indicator Available
        Quick Contact View Available
        Avatar Available
        Avatar Tooltip Available
        Other Images Available with live box mode only
        Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

        In edit mode, the multiple values fields are editable in object page tables.

        The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

        Highlighting New Line Items Available with SAP Fiori elements for OData V2

        Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

        Highlighting Line Items Based on Criticality Available
         

        Responsive Table Only

         

        Availability

        Multiple Fields in a Single Column Available
        Smart Micro Chart Available

        Actions


        Empty Row for Data Entry in Create and Edit Modes

        With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

        The empty row:

        • Is displayed at the top of the responsive table.
          The toolbar has no Create button.
        • Is displayed at the end of a grid table.
          The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
        • Has no inline navigation action to the item via the chevron.
        • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

        With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

        If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

        An empty row is displayed in the responsive table in create or edit mode
        An empty row is displayed in the responsive table in create or edit mode

        Automatic Creation of a New Empty Row

        After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

        The row with data in one field:

        • Is highlighted with a blue line to its left to show it’s a newly created draft
        • Displays the navigation chevron
        • Can also display an inline delete action
        • Displays error messages for mandatory fields without a value.

        If users do not enter data in a new empty row, it is removed when the users save.

        After the user starts entering data in the empty row, a new one is displayed
        After the user starts entering data in the empty row, a new one is displayed

        In draft-enabled applications, you can enable the feature for a table with both versions of SAP Fiori elements. You can also:

        • Enable the feature for an application so it is the default for all grid and responsive tables in all object pages with SAP Fiori elements for OData V2. The setting for the table control overrides the one at application level.
        • Set default values to populate fields in the empty rows
        • Set mandatory fields
        • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

        User-Enabled Creation of Empty Rows in Edit Mode

        In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

        If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

        On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

        Mandatory Fields

        In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

        • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
        • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
          • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
          • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
        Guidelines
        Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

        You can do this in the i18n file for the application.

        For more information see: Replacing Placeholder Text (SAP Fiori Elements).

        Drafts Saved for Rows

        A draft for a once empty row is saved after the users:

        • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
        • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

        Inline Actions

        You can define actions for table rows or inline items. The action types can be:

        • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

        When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


        Direct Edit

        You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

        This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


        Conditional Enablement of Navigation Buttons

        In list reports and object pages:

        • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
        • With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Item Selection

        Both versions of SAP Fiori elements allow you to determine whether users can select:

        • One table row for a toolbar action, using a radio button.
        • Multiple table rows for a toolbar action, using checkboxes.
          For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
          For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

        When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

        • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
          For complete information, see: Select All / Clear All.
        • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
          You can change the limit. We recommend you consult the application team on how a change would impact performance.

        SAP Fiori elements for OData V2

        By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

        SAP Fiori elements for OData V4

        With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

        • In display mode, item selection is not possible.
        • In edit mode, when the delete action is enabled, multiple selection is also enabled.

        Instead, you can enable one of the following selection modes:

        • None:
          • Display mode allows no item selection.
          • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
        • Single: Both display and edit modes allow single item selection.
        • Multi: Both display and edit modes allow multiple item selection.
        Warning
        When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

        Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

        For more information, see:

        Developer Hint
        For more information, refer the development team to:


        Delete

        In responsive tables only, you can:

        • Display an inline delete action.
        • Prevent the deletion of certain rows.

        In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

        For more information, see Delete Single Item Rows.


        Custom Actions

        You can define custom inline actions.

        Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to check the users want to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines
        Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

        For more information, see UI Text Guidelines for SAP Fiori Apps.


        Display

        You can include the display features described below in a table row or inline item.


        Read-Only Field

        With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


        Editing Status

        By default, for draft-enabled applications, in a list report, the editing status is displayed:

        • In the first column of a responsive table
        • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

        You can also add the semantic key to the status.

        The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

        • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
        • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

        For more information, see Tables.


        Rating Indicator

        You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

        The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

        With extensions, you can enable editing of the rating indicator

        For more information, see Rating Indicator.


        Progress Indicator

        You can:

        • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
        • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
        • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

        For more information, see Progress Indicator.


        Quick Contact View

        You can add a quick view to a contact to display key contact details in a popover.

        For applications with Microsoft Team integration, the contact quick view card displays options for starting an audio call, video call, or chat in with the contact in Microsoft Teams.

        For more information, see Quickview.


        Avatar and Other Images

        You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

        Warning
        Other images are not displayed correctly within the table borders. Only use them with live box mode.

        For more information, see Avatar.


        Highlighting Line Items

        By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

        Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

        You can also define highlighting and icons for line items based on their criticality.

        After a newly created item is saved, it is highlighted according to the criticality, as follows:

        • Green for success (criticality value 3)
        • Yellow for warning (criticality value 2)
        • Red for error (criticality value 1)
        • No highlighting for no criticality (criticality value 0)

        Responsive Table Only

        In a responsive table, you can include the display features described below in a table row or inline item.


        Multiple Fields in a Single Column

        You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

        For example, you can display the following in a single column:

        • Company name
        • Company ID
        • Items in Stock
        • Progress Indicator for Items in Stock
        • Overall value of the Items
        • Multiple Action buttons that allow the user to both:
          • Execute an action while staying on the list report page
          • Navigate to other objects and applications

        The visibility and position in the table of a column that combines multiple fields can be changed.

        Field Labels

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

        Limitation on Export to Spreadsheet

        When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

        Related Links

        Object Page – Header

        The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

        For design information, see the Object Page Floorplan guidelines and the links below.

        Warning
        Always build the object page using the dynamic page header.

        Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

        Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

        Feature Availability

         

        Behavior and Interaction

         

        Availability

        Expanded State Default on initial load
        Collapsed State Default on scroll

        With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

        Header Content Display in Display Mode In the header content area
        Header Content Display in Edit and Create Modes When the header is editable:

        • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
        • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
        Header Content Visible Default, you can hide it.
        Header Content Hidden Available
        Header Field Editability By default, in edit mode the header is:

        • Not editable with SAP Fiori elements for OData V2
        • Editable with SAP Fiori elements for OData V4

        You can change the default.

        Highlighting Values Based on Criticality Available
         

        Components

         

        Availability

        Dynamic Page Header Mandatory, it must be configured.
        Title Mandatory, you must define it.
        Menu for Saved Version / Draft Default for draft-enabled applications
        Breadcrumbs Default
        Subtitle Available, you define the text.
        Object Marker Default in draft-enabled applications
        Image Available
        Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
        Paging Buttons on the First Subobject Page Default under certain conditions
        Toolbar Available
         

        Toolbar Actions

         

        Availability

        Edit and Delete Default, when the data allows these actions.

        You can turn one or both actions off.

        Copy Available with SAP Fiori elements for OData V2
        Related Apps Menu Button Available

        With SAP Fiori elements for OData V4, you can change the button name to Open in…

        Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
        Application-Specific Actions Available,  they must be configured.
        Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

        Requires an extension with SAP Fiori elements for OData V2

        Order of Toolbar Actions Default

        You can change the default order.

         

        Additional Content (Optional)

         

        Availability

        Message Strip Available to provide information related to the object as a whole, such as the object status
        Simple Header Facets Available with SAP Fiori elements for OData V2 only
        Plain Text Facets Available
        Contact Facets Available
        Micro Chart Facets Available
        Form Facets Available
        Address Facets Available
        Header Field Group Available
        Rating Indicator Facets Available
        Progress Indicator Facet Available
        Key Value Facet Available
        Link Available

        With SAP Fiori elements for OData V2:

        • The default link shows the text and ID. You can remove the text or the ID from the link.
        • You can include a link that navigates to a site external to the application.

        Behavior and Interaction


        Collapsed/Expanded State

        When the object page header contains at least one facet:

        • On the initial load of the object page, the header is expanded.
        • When the user scrolls down the page, the header collapses.
        • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

        When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

        With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

        Next to the title, an arrow   button lets the users expand the header.

        Summary Line for Object Page Header on Small Screens
        Summary Line for Object Page Header on Small Screens

        Display of Header Content

        In display mode, the header content area displays all the header content.

        In edit and create modes, when the header is:

        • Editable
          • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

        The header section is only present in the edit and create modes.

          • The first temporary section will have a section title called “Header” if there is no Anchor Bar available.
          • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

         

        • Not Editable, the header is hidden.

        Note that, by default, the header is

        • Editable with SAP Fiori elements for OData V4
        • Not editable with SAP Fiori elements for OData V2

        You can ask the application developers to change the default.

        For more information, see Dynamic Page Header (Mandatory).

        Developer Hint
        To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

        Header Content Visibility

        By default, header content is visible.

        You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

        • Entire header facets
        • Content, such as fields, in a header facet
        • Content in quick views

        With Fiori elements for OData V2, you can set:

        • The header to be displayed in edit mode.
        • Header facets to be visible in edit mode.
        Developer Hint
        For more information on the features, refer the development team to:


        Header Field Editability

        By default, in edit mode the header is:

        • Not editable with SAP Fiori elements for OData V2
        • Editable with SAP Fiori elements for OData V4

        You can change the default.

        Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

        Developer Hint
        To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

        Highlighting Values Based on Criticality

        You can assign colors and icons to text to indicate the criticality of a field value.

        With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

        Components


        Title

        By default, with:

        •  SAP Fiori elements for OData V2, the title area is empty.
        •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
        Guidelines
        Tell the developers which property to use as the title.

        Menu for Saved Version / Draft

        With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


        Breadcrumbs

        Breadcrumbs are displayed above the object title.

        Guidelines
        Limit the breadcrumbs to the drilldown levels within the object page.

        Object Marker

        The object marker indicates the object is locked by another user in draft-enabled applications.


        Image

        The image is an avatar control. By default, it has a square shape.

        You can set:

        • An image to display instead of the avatar. SAP Fiori elements for OData V4 uses the lightbox control to allow a larger view of the image.
        • The avatar to a have a circular shape.

        When no image is set or found for the avatar, the avatar initials are displayed.

        If those are not set or found either, an icon for the avatar is displayed:

        • A square avatar for a product
        • A circular avatar for a person.

        For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


        Paging Buttons

        By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

        • The user has navigated from a table in the object page to the subobject.
        • The table in the object page contains at least two items.

        With SAP Fiori elements for OData V2, you can:

        • Enable the paging buttons to show on the first object page opened from a list report.
        • Disable the default display of the paging buttons on the subobject page.

        Toolbar Actions


        Edit and Delete

        By default, these actions are displayed when the data in the object page allows them.

        You can:

        • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
        • Disable the actions.

        For more information, see:


        Copy

        You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

        You set the label for the button according to your use case. Otherwise, the default label is Copy.

        In the object page, the Copy button is displayed after the Delete button.

        Developer Hint
        Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

        Related Apps Menu Button

        You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

        You can also:

        • Hide specific actions in the menu.
        • Change the button name to Open In…  with SAP Fiori elements for OData V4.

        Generic Actions

        By default, the Share button is displayed for saved objects and hidden for drafts.

        It can include the:

        • Share in SAP Jam menu item when SAP Jam integration is configured.
        • Microsoft Teams > As Chat and As Card options when the required settings have been made by the system administrators of SAP S/4HANA or SAP S/4HANA Cloud.

        This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA or SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

        When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA or SAP S/4HANA Cloud system with co-workers.

        With SAP Fiori elements for OData V4, you can control the visibility in the Share menu of the Send E-mail and Share: Microsoft Teams options at both application level and page level.

        For more information, see:

        Developer Hint
        For more information, refer application developers to:


        Application-Specific Actions

        You can include the actions required for your use case.

        The header toolbar displays application-specific actions to the left of the generic actions.

        You can also define custom shortcuts for application-defined action buttons and navigation buttons.

        Developer Hint
        For more information, refer application developers to Keyboard Shortcuts.

        Conditional Enablement of Navigation Buttons

        With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

        With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Order of Toolbar Actions

        The default order — left to right — for actions in the object page toolbar is below:

        • Edit
        • Delete
        • Copy with SAP Fiori elements for OData V2
        • Application-specific action buttons
        • Related Apps menu button
        • Share

        You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

        For more information, see:

        Additional Content


        Message Strip

        You can add a message strip in the header to provide information related to the object as a whole, such as the object status.

        The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

        When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

        The user can find the individual messages via the message popover in the footer bar.

        For more information, see:

        Simple Header Facets

        With SAP Fiori elements for OData V2:

        • You can use a simple header facet to show simple data points that align horizontally across the header.
        • When form fields contain no value, they display the empty  state indicator (–).

        Plain Text Facets

        You can use the plain text facet to display a continuous text in the header.

        For more information, see Plain Text Facet.


        Contact Facets

        You can enable a quick view for a contact.

        For applications with Microsoft Team integration, the contact card and the quick view card both display options for starting a Microsoft Teams audio call, video call, or chat with the contact.

        With SAP Fiori elements for OData V4:

        • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
        • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

        For more information, see Quick View.


        Micro Chart Facets

        You can display the following micro charts in the header:

        • Area micro chart
        • Bullet chart
        • Radial chart
        • Column chart
        • Line micro chart
        • Harvey ball chart
        • Stacked bar chart

        For more information, see Micro Charts.


        Form Facets

        You can add a quick view to the form facet.

        For more information, see Form Facet (Dataset).

        Developer Hint
        For more information, refer the development team to Form Facet.

        Address Facets

        You can display an address such as a shipping address.

        Developer Hint
        For more information, refer the development team to Address Facet in the Object Page Header.

        Header Field Groups

        You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


        Rating Indicator Facets

        You can add a rating indicator to the header. It is read-only in both display and edit modes.

        By default, the maximum rating is five stars.

        You can:

        • Change the maximum rating.
        • Specify more descriptive text for the subtitle.

        With extensions, you can make the rating editable.

        Display Mode

        The rating indicator shows with the:

        • Title
        • Subtitle with the total number of ratings
        • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

        Edit Mode

        The rating indicator moves into the header facet and appears with only the title in edit mode.

        For an aggregated rating, the number of ratings is shown in parentheses after the stars.

        For more information, see:


        Progress Indicator Facets

        You can add a progress indicator facet to the object header.

        For more information, see:


        Key Value Facets

        You can add a key value facet to highlight important data or KPIs.

        For more information, see Key Value Facet.

        Related Links

        Table Rows

        The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links below.

        Feature Availability

           
         

        Actions

         

        Availability

        Empty Row for Data Entry in Create and Edit Modes Available in an object page in edit mode for responsive and grid tables: the table displays an empty row for data entry.

        You can turn it off.

        Editable Multi-Input Fields Available in an object page in edit mode for all tables.
        Inline Actions Available
        Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
        Conditional Enablement of Navigation Buttons For list report and object pages:

        • Available with SAP Fiori elements for OData V4
        • Requires an extension with SAP Fiori elements for OData V2
        Single Item Selection Default
        Multiple Item Selection Available
        Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
        Delete Available in responsive tables only
        Custom Actions Available
        Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
         

        Display

         

        Availability

        Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
        Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
        Rating Indicator Available
        Progress Indicator Available
        Quick Contact View Available
        Avatar Available
        Avatar Tooltip Available
        Other Images Available with live box mode only
        Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

        In edit mode, the multiple values fields are editable in object page tables.

        The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

        Highlighting New Line Items Available with SAP Fiori elements for OData V2

        Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

        Highlighting Line Items Based on Criticality Available
         

        Responsive Table Only

         

        Availability

        Multiple Fields in a Single Column Available
        Smart Micro Chart Available

        Actions


        Empty Row for Data Entry in Create and Edit Modes

        With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

        The empty row:

        • Is displayed at the top of the responsive table.
          The toolbar has no Create button.
        • Is displayed at the end of a grid table.
          The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
        • Has no inline navigation action to the item via the chevron.
        • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

        With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

        If the user deletes all the empty rows in the table, a new one displays so the user can continue data entry.

        An empty row is displayed in the responsive table in create or edit mode
        An empty row is displayed in the responsive table in create or edit mode

        You can:

        • Set default values to populate fields in the empty rows
        • Enable the feature at the table level in draft-enabled applications
        • Set mandatory fields
        • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

        Automatic Creation of a New Empty Row

        After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

        The row with data in one field:

        • Is highlighted with a blue line to its left to show it’s a newly created draft
        • Displays the navigation chevron
        • Can also display an inline delete action
        • Displays error messages for mandatory fields without a value.

        If users do not enter data in a new empty row, it is removed when the users save.

        After the user starts entering data in the empty row, a new one is displayed
        After the user starts entering data in the empty row, a new one is displayed

        User-Enabled Creation of Empty Rows in Edit Mode

        In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

        If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

        On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

        Mandatory Fields

        In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

        • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
        • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
          • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
          • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
        Guidelines
        Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

        You can do this in the i18n file for the application.

        For more information see: Replacing Placeholder Text (SAP Fiori Elements).

        Drafts Saved for Rows

        A draft for a once empty row is saved after the users:

        • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
        • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

        Inline Actions

        You can define actions for table rows or inline items. The action types can be:

        • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

        When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


        Direct Edit

        You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

        This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


        Conditional Enablement of Navigation Buttons

        In list reports and object pages:

        • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
        • With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Item Selection

        Both versions of SAP Fiori elements allow you to determine whether users can select:

        • One table row for a toolbar action, using a radio button.
        • Multiple table rows for a toolbar action, using checkboxes.
          For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
          For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

        When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

        • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
          For complete information, see: Select All / Clear All.
        • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
          You can change the limit. We recommend you consult the application team on how a change would impact performance.

        SAP Fiori elements for OData V2

        By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

        SAP Fiori elements for OData V4

        With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

        • In display mode, item selection is not possible.
        • In edit mode, when the delete action is enabled, multiple selection is also enabled.

        Instead, you can enable one of the following selection modes:

        • None:
          • Display mode allows no item selection.
          • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
        • Single: Both display and edit modes allow single item selection.
        • Multi: Both display and edit modes allow multiple item selection.
        Warning
        When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

        Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

        For more information, see:

        Developer Hint
        For more information, refer the development team to:


        Delete

        In responsive tables only, you can:

        • Display an inline delete action.
        • Prevent the deletion of certain rows.

        In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

        For more information, see Delete Single Item Rows.


        Custom Actions

        You can define custom inline actions.

        Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to check the users want to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines
        Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

        For more information, see UI Text Guidelines for SAP Fiori Apps.


        Display

        You can include the display features described below in a table row or inline item.


        Read-Only Field

        With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


        Editing Status

        By default, for draft-enabled applications, in a list report, the editing status is displayed:

        • In the first column of a responsive table
        • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

        You can also add the semantic key to the status.

        The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

        • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
        • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

        For more information, see Tables.


        Rating Indicator

        You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

        The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

        With extensions, you can enable editing of the rating indicator

        For more information, see Rating Indicator.


        Progress Indicator

        You can:

        • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
        • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
        • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

        For more information, see Progress Indicator.


        Quick Contact View

        You can add a quick view to a contact to display key contact details in a popover.

        For more information, see Quickview.


        Avatar and Other Images

        You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

        Warning
        Other images are not displayed correctly within the table borders. Only use them with live box mode.

        For more information, see Avatar.


        Highlighting Line Items

        By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

        Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

        You can also define highlighting and icons for line items based on their criticality.

        After a newly created item is saved, it is highlighted according to the criticality, as follows:

        • Green for success (criticality value 3)
        • Yellow for warning (criticality value 2)
        • Red for error (criticality value 1)
        • No highlighting for no criticality (criticality value 0)

        Display in Responsive Table Only

        In a responsive table, you can include the display features described below in a table row or inline item.


        Multiple Fields in a Single Column

        You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

        For example, you can display the following in a single column:

        • Company name
        • Company ID
        • Items in Stock
        • Progress Indicator for Items in Stock
        • Overall value of the Items
        • Multiple Action buttons that allow the user to both:
          • Execute an action while staying on the list report page
          • Navigate to other objects and applications

        The visibility and position in the table of a column that combines multiple fields can be changed.

        Field Labels

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

        Limitation on Export to Spreadsheet

        When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

        Information

        Write a short and meaningful message.


        Smart Micro Chart

        You can:

        • Add an inline micro chart.
        • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

        You can choose among the following micro chart types:

        • Area micro chart
        • Bullet micro chart
        • Line micro chart
        • Micro chart/smart micro chart
        • Radial micro chart
        • Stacked bar micro chart
        Warning
        The user cannot navigate to another page from the chart.

        For more information on chart types, see: Choosing the Correct Chart Type.

        Related Links

        Table Rows

        The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links below.

        Feature Availability

           
         

        Actions

         

        Availability

        Empty Row for Data Entry in Create and Edit Modes Available in an object page in edit mode for responsive and grid tables: the table displays an empty row for data entry.

        You can turn it off.

        Editable Multi-Input Fields Available in an object page in edit mode for all tables.
        Inline Actions Available
        Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
        Conditional Enablement of Navigation Buttons For list report and object pages:

        • Available with SAP Fiori elements for OData V4
        • Requires an extension with SAP Fiori elements for OData V2
        Single Item Selection Default
        Multiple Item Selection Available
        Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
        Delete Available in responsive tables only
        Custom Actions Available
        Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
         

        Display

         

        Availability

        Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
        Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
        Rating Indicator Available
        Progress Indicator Available
        Quick Contact View Available
        Avatar Available
        Avatar Tooltip Available
        Other Images Available with live box mode only
        Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

        In edit mode, the multiple values fields are editable in object page tables.

        The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

        Highlighting New Line Items Available with SAP Fiori elements for OData V2

        Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

        Highlighting Line Items Based on Criticality Available
         

        Responsive Table Only

         

        Availability

        Multiple Fields in a Single Column Available
        Smart Micro Chart Available

        Actions


        Empty Row for Data Entry in Create and Edit Modes

        With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

        The empty row:

        • Is displayed at the top of the responsive table.
          The toolbar has no Create button.
        • Is displayed at the end of a grid table.
          The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
        • Has no inline navigation action to the item via the chevron.
        • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.

        With SAP Fiori elements for OData V4, you can set the empty row to be deletable.

        If the users delete all the empty rows in the table, a new one is added so they can continue data entry.

        An empty row is displayed in the responsive table in create or edit mode
        An empty row is displayed in the responsive table in create or edit mode

        You can:

        • Set default values to populate fields in the empty rows
        • Enable the feature at the table level in draft-enabled applications
        • Set mandatory fields
        • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

        Automatic Creation of a New Empty Row

        After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

        The row with data in one field:

        • Is highlighted with a blue line to its left to show it’s a newly created draft
        • Displays the navigation chevron
        • Can also display an inline delete action
        • Displays error messages for mandatory fields without a value.

        If users do not enter data in a new empty row, it is removed when the users save.

        After the user starts entering data in the empty row, a new one is displayed
        After the user starts entering data in the empty row, a new one is displayed

        User-Enabled Creation of Empty Rows in Edit Mode

        In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

        If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

        On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

        Mandatory Fields

        In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

        • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
        • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
          • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
          • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
        Guidelines
        Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

        You can do this in the i18n file for the application.

        For more information see: Replacing Placeholder Text (SAP Fiori Elements).

        Drafts Saved for Rows

        A draft for a once empty row is saved after the users:

        • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
        • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

        Inline Actions

        You can define actions for table rows or inline items. The action types can be:

        • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

        When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


        Direct Edit

        You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

        This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


        Conditional Enablement of Navigation Buttons

        In list reports and object pages:

        • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
        • With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Item Selection

        Both versions of SAP Fiori elements allow you to determine whether users can select:

        • One table row for a toolbar action, using a radio button.
        • Multiple table rows for a toolbar action, using checkboxes.
          For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
          For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

        When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

        • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
          For complete information, see: Select All / Clear All.
        • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
          You can change the limit. We recommend you consult the application team on how a change would impact performance.

        SAP Fiori elements for OData V2

        By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

        SAP Fiori elements for OData V4

        With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

        • In display mode, item selection is not possible.
        • In edit mode, when the delete action is enabled, multiple selection is also enabled.

        Instead, you can enable one of the following selection modes:

        • None:
          • Display mode allows no item selection.
          • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
        • Single: Both display and edit modes allow single item selection.
        • Multi: Both display and edit modes allow multiple item selection.
        Warning
        When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

        Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

        For more information, see:

        Developer Hint
        For more information, refer the development team to:


        Delete

        In responsive tables only, you can:

        • Display an inline delete action.
        • Prevent the deletion of certain rows.

        In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

        For more information, see Delete Single Item Rows.


        Custom Actions

        You can define custom inline actions.

        Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to check the users want to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines
        Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

        For more information, see UI Text Guidelines for SAP Fiori Apps.


        Display

        You can include the display features described below in a table row or inline item.


        Read-Only Field

        With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


        Editing Status

        By default, for draft-enabled applications, in a list report, the editing status is displayed:

        • In the first column of a responsive table
        • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

        You can also add the semantic key to the status.

        The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

        • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
        • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

        For more information, see Tables.


        Rating Indicator

        You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

        The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

        With extensions, you can enable editing of the rating indicator

        For more information, see Rating Indicator.


        Progress Indicator

        You can:

        • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
        • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
        • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

        For more information, see Progress Indicator.


        Quick Contact View

        You can add a quick view to a contact to display key contact details in a popover.

        For more information, see Quickview.


        Avatar and Other Images

        You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

        Warning
        Other images are not displayed correctly within the table borders. Only use them with live box mode.

        For more information, see Avatar.


        Highlighting Line Items

        By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

        Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

        You can also define highlighting and icons for line items based on their criticality.

        After a newly created item is saved, it is highlighted according to the criticality, as follows:

        • Green for success (criticality value 3)
        • Yellow for warning (criticality value 2)
        • Red for error (criticality value 1)
        • No highlighting for no criticality (criticality value 0)

        Display in Responsive Table Only

        In a responsive table, you can include the display features described below in a table row or inline item.


        Multiple Fields in a Single Column

        You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

        For example, you can display the following in a single column:

        • Company name
        • Company ID
        • Items in Stock
        • Progress Indicator for Items in Stock
        • Overall value of the Items
        • Multiple Action buttons that allow the user to both:
          • Execute an action while staying on the list report page
          • Navigate to other objects and applications

        The visibility and position in the table of a column that combines multiple fields can be changed.

        Field Labels

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

        Limitation on Export to Spreadsheet

        When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

        Information

        Write a short and meaningful message.


        Smart Micro Chart

        You can:

        • Add an inline micro chart.
        • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

        You can choose among the following micro chart types:

        • Area micro chart
        • Bullet micro chart
        • Line micro chart
        • Micro chart/smart micro chart
        • Radial micro chart
        • Stacked bar micro chart
        Warning
        The user cannot navigate to another page from the chart.

        For more information on chart types, see: Choosing the Correct Chart Type.

        Related Links

        Table Rows

        The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links below.

        Feature Availability

           
         

        Actions

         

        Availability

        Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

        You can turn it off for edit mode.

        Editable Multi-Input Fields Available in an object page in edit mode for all tables.
        Inline Actions Available
        Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
        Conditional Enablement of Navigation Buttons For list report and object pages:

        • Available with SAP Fiori elements for OData V4
        • Requires an extension with SAP Fiori elements for OData V2
        Single Item Selection Default
        Multiple Item Selection Available
        Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
        Delete Available in responsive tables only
        Custom Actions Available
        Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
         

        Display

         

        Availability

        Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
        Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
        Rating Indicator Available
        Progress Indicator Available
        Quick Contact View Available
        Avatar Available
        Avatar Tooltip Available
        Other Images Available with live box mode only
        Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

        In edit mode, the multiple values fields are editable in object page tables.

        The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

        Highlighting New Line Items Available with SAP Fiori elements for OData V2

        Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

        Highlighting Line Items Based on Criticality Available
         

        Responsive Table Only

         

        Availability

        Multiple Fields in a Single Column Available
        Smart Micro Chart Available

        Actions


        Empty Row for Data Entry in Create and Edit Modes

        With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

        The empty row:

        • Is displayed at the top of the responsive table.
          The toolbar has no Create button.
        • Is displayed at the end of a grid table.
          The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
        • Has no inline actions such as delete or navigation to the item via the chevron.
        • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.
        An empty row is displayed in the responsive table in create or edit mode
        An empty row is displayed in the responsive table in create or edit mode

        You can:

        • Set default values to populate fields in the empty rows
        • Enable the feature at the table level in draft-enabled applications
        • Set mandatory fields
        • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

        Automatic Creation of a New Empty Row

        After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

        The row with data in one field:

        • Is highlighted with a blue line to its left to show it’s a newly created draft
        • Displays the navigation chevron
        • Can also display an inline delete action
        • Displays error messages for mandatory fields without a value.

        If users do not enter data in a new empty row, it is removed when the users save.

        After the user starts entering data in the empty row, a new one is displayed
        After the user starts entering data in the empty row, a new one is displayed

        User-Enabled Creation of Empty Rows in Edit Mode

        In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

        If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

        On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

        Mandatory Fields

        In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

        • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
        • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
          • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
          • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
        Guidelines
        Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

        You can do this in the i18n file for the application.

        For more information see: Replacing Placeholder Text (SAP Fiori Elements).

        Drafts Saved for Rows

        A draft for a once empty row is saved after the users:

        • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
        • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

        Inline Actions

        You can define actions for table rows or inline items. The action types can be:

        • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

        When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


        Direct Edit

        You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

        This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


        Conditional Enablement of Navigation Buttons

        In list reports and object pages:

        • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
        • With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Item Selection

        Both versions of SAP Fiori elements allow you to determine whether users can select:

        • One table row for a toolbar action, using a radio button.
        • Multiple table rows for a toolbar action, using checkboxes.
          For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
          For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

        When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

        • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
          For complete information, see: Select All / Clear All.
        • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
          You can change the limit. We recommend you consult the application team on how a change would impact performance.

        SAP Fiori elements for OData V2

        By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

        SAP Fiori elements for OData V4

        With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

        • In display mode, item selection is not possible.
        • In edit mode, when the delete action is enabled, multiple selection is also enabled.

        Instead, you can enable one of the following selection modes:

        • None:
          • Display mode allows no item selection.
          • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
        • Single: Both display and edit modes allow single item selection.
        • Multi: Both display and edit modes allow multiple item selection.
        Warning
        When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

        Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

        For more information, see:

        Developer Hint
        For more information, refer the development team to:


        Delete

        In responsive tables only, you can:

        • Display an inline delete action.
        • Prevent the deletion of certain rows.

        In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

        For more information, see Delete Single Item Rows.


        Custom Actions

        You can define custom inline actions.

        Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to check the users want to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines
        Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

        For more information, see UI Text Guidelines for SAP Fiori Apps.


        Display

        You can include the display features described below in a table row or inline item.


        Read-Only Field

        With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


        Editing Status

        By default, for draft-enabled applications, in a list report, the editing status is displayed:

        • In the first column of a responsive table
        • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

        You can also add the semantic key to the status.

        The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

        • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
        • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

        For more information, see Tables.


        Rating Indicator

        You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

        The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

        With extensions, you can enable editing of the rating indicator

        For more information, see Rating Indicator.


        Progress Indicator

        You can:

        • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
        • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
        • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

        For more information, see Progress Indicator.


        Quick Contact View

        You can add a quick view to a contact to display key contact details in a popover.

        For more information, see Quickview.


        Avatar and Other Images

        You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

        Warning
        Other images are not displayed correctly within the table borders. Only use them with live box mode.

        For more information, see Avatar.


        Highlighting Line Items

        By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

        Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

        You can also define highlighting and icons for line items based on their criticality.

        After a newly created item is saved, it is highlighted according to the criticality, as follows:

        • Green for success (criticality value 3)
        • Yellow for warning (criticality value 2)
        • Red for error (criticality value 1)
        • No highlighting for no criticality (criticality value 0)

        Display in Responsive Table Only

        In a responsive table, you can include the display features described below in a table row or inline item.


        Multiple Fields in a Single Column

        You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

        For example, you can display the following in a single column:

        • Company name
        • Company ID
        • Items in Stock
        • Progress Indicator for Items in Stock
        • Overall value of the Items
        • Multiple Action buttons that allow the user to both:
          • Execute an action while staying on the list report page
          • Navigate to other objects and applications

        The visibility and position in the table of a column that combines multiple fields can be changed.

        Field Labels

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

        Limitation on Export to Spreadsheet

        When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

        Information

        Write a short and meaningful message.


        Smart Micro Chart

        You can:

        • Add an inline micro chart.
        • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

        You can choose among the following micro chart types:

        • Area micro chart
        • Bullet micro chart
        • Line micro chart
        • Micro chart/smart micro chart
        • Radial micro chart
        • Stacked bar micro chart
        Warning
        The user cannot navigate to another page from the chart.

        For more information on chart types, see: Choosing the Correct Chart Type.

        Related Links

        Table Features

        The SAP Fiori elements templates support the features and settings for a table detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links within this article.

        Feature Availability

         

        Table Settings

         

        Availability

        Column Header Labels You set these.
        Asterisk in Labels for Mandatory Fields In the object page, by default, a red asterisk (*) displays in the column header label for mandatory table fields with SAP Fiori elements for OData V4.
        Tooltips on Column Headers Default
        Clear All The Clear All  checkbox is displayed by default in both the list report and object page when the selection of multiple rows is enabled for:

        • Grid tables
        • Analytical tables
        • Tree tables

        You can change the default.

        Select All The Select All  checkbox is displayed by default when the selection of multiple rows is enabled for a responsive table.

        You can change the default.

        Sticky Column Header Behavior Default, you can turn it off.
        Column Width The default width depends on the column contents. You can change it.
        Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

        You can change the level of importance.

         Freezing Columns

        Available in analytical tables, grid tables, and tree tables for the number of columns that you decide.

        Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
        Ascending Sort Order on a Column Default, you can change it.
        Quick Sort on a Column Available
        Grouping Available in responsive and analytical tables, not in grid tables
        Grouped Totals in Analytical Tables For now, an asterisk (*) is displayed instead of a figure for grouped totals of items with different units of measure in the same group.
        Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
        No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
        Message Strip above the Table You can display a custom message above the table in the:

        • List report, object page, and analytical page with SAP Fiori elements for OData V2
        • List report with SAP Fiori elements for OData V4

        In the object page, by default, a message strip is displayed when there are errors in the table.

        When there are multiple messages, the one with the highest severity is displayed.

        Generic Context Menu Activated by default for:

        • All table types with SAP Fiori elements for OData V2
        • All table types except the tree table, with SAP Fiori elements for OData V4
         

        List Report and Analytical Page Only

         

        Availability

        Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
         

        List Report Only

         

        Availability

        Copy Available
         

        Object Page Only

         

        Availability

        Message Strip for Rows with Errors Default
        Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

        • Anchor bar navigation and a single section that contains only a grid table
        • Tab bar navigation and a current tab that contains only a grid table

        Table Settings


        Tooltips on Column Headers

        On desktop applications, all table columns display tooltips, based on the text in:

        • Common.QuickInfo, when it’s visible
        • The column label, in all other cases

        Tooltips are available only in desktop applications because users must hover their mouse on the column header to see them.


        Clear All / Select All

        When the selection of multiple rows is enabled for a table in the list report and object page, the Clear All checkbox is displayed by default in the selection column header for all tables, but the responsive table. You can change the default.

        Information
        To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

         Table Type

        Selection Default

        Users Can Select

        Grid table

        Analytical table

        Tree table

        Clear All   Up to 200 rows by default

        We recommend you consult the application development team on how changes to the limit would impact performance.

        Responsive table Select All   All the rows displayed on the interface, not all the rows in the table.

        A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

        Warning
        For grid tables, analytical tables, and tree tables, changing the default Clear All checkbox to the Select All  checkbox can lead to performance issues because Select All   loads all the table rows to the frontend.

        Always ask the application development team about the impact on performance before you consider such a change.

        Guidelines
        When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

        Column Width

        The default column width varies according to the column contents:

        • Text: can range from 3 to 20 rem
        • Image: 5 rem
        • Rating or progress indicator: 6.875 rem
        • Chart: 20 rem

        You can can change the width.

        You can also ask the application developers to ensure the column width takes into account the contents of both the column and the column header.

        Developer Hint
        For more information, refer the development team to Setting the Default Column Width.

        Column Importance in Responsive Tables

        By default:

        • Key fields have high importance in list reports.
        • Other columns have the importance of none and are handled like columns assigned medium importance.

        You can change the level of importance.

        The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

        • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
        • The values in columns with low importance are first to be hidden.

        When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

        You can also assign an importance to custom columns.

        For more information, see:


        Freezing Columns

        You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

        Developer Hint
        For more information, refer application developers to Tables.

        Labels for Multiple Fields in a Column

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


        Sort Order

        By default, the sort order for a column is ascending.

        You can:

        • Set the default sort order to descending.
        • Define other, customized sort orders.

        For more information, see the sort guidelines according to table type:


        Quick Sort on a Column

        Available for any sortable column.

        When a column contains a combination of fields, such an ID and a description or a field group, the users can specify a sort and sort order for each field in the column with the quick sort.


        Number of Table Rows Displayed at Once

        By default, a responsive table loads the following number of rows at once:

        • 20 rows in a list report.
        • 10 rows in an object page with multiple sections.

        When more rows exist, the users can click the More button at the end of the table to view additional rows.

        With SAP Fiori elements for OData V2, you can change the default number.

        For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

        Guidelines
        Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

        Grouping

        Grouping is available in responsive and analytical tables.

        You can define the format of the grouping headers.

        For more information, see:



        No Data Found Text

        By default, the following text is displayed when no data is found.

        • When the user has not applied filters, the text is “No data found.”
        • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
        Guidelines
        Replace the generic text with text that’s meaningful to the user.


        Generic Context Menu

        By default, on desktop and mobile applications, a generic context menu is activated and cannot be deactivated for:

        • All table types but the tree table with SAP Fiori elements for OData V4
        • All table types with SAP Fiori elements for OData V2

        The generic context menu generally behaves like the standard context menu described in the corresponding table articles, linked below.

        The context of the generic context menu can be either a single row or multiple selected rows.

        The following action types are available on the generic context menu:

        • All toolbar actions that become active only if rows are selected

        Developers call them “bounded toolbar actions” or “context-dependent actions.”

        • The “Open in New Tab or Window” action

        It allows up to 10 items to be opened in separate tabs or windows depending on the user’s browser settings.

        Similar to the standard context menu, if a control inside a row is the “click target”, and the control also provides a context menu, the control menu “wins”.

        Single row context - a non-selected row is the
        Single row context - a non-selected row is the "click target" so the context menu applies to the non-selected row
        Multiple row context - one or more selected rows are the
        Multiple row context - one or more selected rows are the "click target " so the context menu applies to all the selected rows

        List Report and Analytical Page Only

        Initial Expansion of Table Levels

        By default, on initial load, the following expandable tables are expanded to this number of levels:

        • Responsive table: 1 level
        • Tree table: 1 level
        • Analytical table: 0 levels

        You can change the default value for the tree table and analytical tables.

        Developer Hint
        For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

        Object Page Only

        Message Strip for Rows with Errors

        When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


        Related Links

        Table Toolbar

        The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

        For design information, see the guidelines starting with Table Overview, and see the links below.

        Feature Availability

         

         

        List Report and Object Page Features

         

        Availability

        Title Visible by default.

        You can  hide it.

        You can show the table row count next to the title.

        Infobar Default for all table types, the infobar summarizes the filter criteria applied to the table data. It is displayed below the table toolbar and above the column headings when at least one filter is set.
        Order of Toolbar Actions With SAP Fiori elements for OData V4, you can order the toolbar actions according to their importance, starting with the most frequently-used action and ending with the most seldom-used action, regardless of whether the action is a custom or standard one.
        Table Personalization Actions Default, you can turn them off.
        Show/Hide Details Available in responsive tables
        Mass Edit Available in draft-enabled applications:

        • In both the list report and object page with SAP Fiori elements for OData V4
        • In the list report with SAP Fiori elements for OData V2
        Export With SAP Fiori elements for OData V4:

        • Export to Spreadsheet is enabled by default.
        • Export to PDF is available.

        With SAP Fiori elements for OData V2, Export to Excel is enabled by default in:

        • A list report table
        • An object page table only if the Paste icon is displayed
        Copy to Clipboard The Copy button is displayed in the table toolbar by default.
        Paste from Clipboard The Paste icon is displayed only if the table supports the paste action.
        Application-Specific Actions Available
        Actions Disabled Before Row Selection Available
        Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

        Requires an extension with SAP Fiori elements for OData V2

        Messages for Critical Actions Available
        Messages for Destructive Actions Available
        Multiple Views on a Table Available
         

        List Report Only Features

         

        Availability

        Toolbar Sticky Behavior Default, you can turn it off.
        Standard ActionsCreate and Delete Default, you can turn them off.
        Object Creation via an Object Page Default, you can change it.
        Object Creation via a Dialog Available in certain conditions
        Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
        Copy Object Available

        You determine the label on the action button.

        Hiding Actions in Multiple Content Layout Available
        Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
        Add Card to Insights Default when My Home in SAP S/4HANA Cloud is enabled.

        You can turn it off.

         

        Object Page Only Features

         

        Availability

        Search Available, when the data allows it.
        Edit Default, when the data allows it.
        Delete Default, when the data allows it.
        Subobject Creation via Subobject Page Default, you can change it.
        Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
        Create Not Visible In certain conditions
        Inline Creation Available, in draft-enabled applications for grid and responsive tables
        Prefilling Fields for New Object Creation Available, in draft-enabled applications
        Full Screen Mode for Table Display Available, not recommended
        Segmented Button for Switching Table Views Default for a table with a maximum of three views
        Select Control for Switching Table Views Default for a table with four or more views

        List Report and Object Page Features

        The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


        Table Personalization Actions

        By default, Sort, Group and Order actions are enabled.

        These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

        For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

        Table-level view management is not a prerequisite for personalization.

        For more information, see Table Personalization (Overview).



        Show / Hide Details

        The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

        After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

        The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

        • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
        • The values in columns with low importance are first to be hidden.

        By default in responsive tables:

        • Key fields have the importance set to high in list reports.
        • Other columns have the importance set to none and are handled like columns assigned medium importance.

        You can change the level of importance.


        Mass Edit

        You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

        • List report and object page with SAP Fiori elements for OData V4
        • List report with SAP Fiori elements for OData V2

        List Report

        Users cannot apply the mass edit to a draft record.

        The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

        By default, the Edit dialog contains all the table columns that are currently visible and editable.

        Object Page

        When it’s enabled for a table in the object page and the object page is in edit mode, users can apply the mass edit to subobjects.

        For more information, see Mass Edit.

        Developer Hint
        For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


        Export

        The export action exports the values in a table. When enabled, it is displayed in the table toolbar.

        • With SAP Fiori elements for OData V4:
          • Export to Spreadsheet is enabled by default.
          • Export to PDF is available.
          • By default, a maximum of 1000 rows can be exported. The application development team can change the limit.
        • With SAP Fiori elements for OData V2 Export to Excel is enabled by default in:
          • A list report table
          • An object page table if the Paste icon is available

        For more information see Export to Spreadsheet.


        Copy and Paste

        Users can copy data from external applications — such as Microsoft Excel or Microsoft Word — or from other SAP Fiori elements applications to the clipboard, and then paste the data from the clipboard to tables in SAP Fiori elements applications that are editable.

        Copy to Clipboard

        By default, the Copy action is displayed in the table toolbar.

        With it, users can copy multiple rows or ranges of rows and columns to the clipboard.

        They can select a range of cells in rows or columns:

        Paste from Clipboard

        The Paste action is displayed in the table toolbar if the table supports it.

        After users copy data from another SAP Fiori elements application or an external application, they can paste it to:

        • The table

        Users set the focus on the table or select an empty row before pasting the data. One or more new rows are created for the pasted data.

        This feature is available only for draft-enabled applications and for tables where inline creation or the insertion of empty rows has been enabled.

        • A cell or range of cells, only in grid and responsive tables

        Users select a cell or cell range within the table and paste the data. If the selected cell or cells are in:

          • Active or draft rows, the pasted data replaces the values in those rows.
          • An empty row, new rows are created for the pasted data.

        To paste, they can use the Paste action in the toolbar or use a keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

        Limitations

        • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
        • If there are validation errors, a dialog displays an error message so the user can take remedial action.
        • The greater the number of records copied, the longer the paste operation takes.
        • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
        • Users cannot paste data into custom columns of tables.
        • This feature is not supported for custom tables.
        Information
        Pasting the data from the clipboard into another SAP Fiori elements table can cause formatting issues because the copy action doesn’t separate the content of fields that include more than one value, for example, a field with both an amount and a currency or both a value and its description.

        Instead, we recommend users export the data into a spreadsheet format that separates multiple values in one field into separate columns, with a single value in each, and then, adjust the format to match the one the target table.

        Developer Hint
        For more information, refer application developers to


        Application-Specific Actions

        You can define these actions and the text displayed on the buttons.

        The application team can control when the action button is displayed and enabled.

        For application-specific actions, application teams can define custom keyboard shortcuts.

        For more information, see:

        Developer Hint

        For more information on shortcuts, refer application developers to Keyboard Shortcuts.


        Actions Disabled Until the User Selects a Row

        You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

        Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

        For more information, see UI Element States.


        Conditional Enablement of Navigation Buttons

        With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

        With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to ensure the user wants to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines

        Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text                          “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


        Messages for Destructive Actions

        By default, a message is displayed for confirmation of an action that will delete or destroy important data.

        Guidelines

        Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text The default message reuses the title and the description defined for the object in the table.

        • In flexible column layout: Delete object <title> <description>?

          For example, “Delete object 12345 (Sales Order)?”

        • In full screen mode: Delete object <title>?

          For example, “Delete object 12345?”

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


        Multiple Views for a Table

        You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

        For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

        With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

        List Report Only Features

        The information below relates only to table toolbar actions and settings in the list report floorplan.


        Standard Actions

        By default, Create and Delete are enabled.

        You can disable them.

        You can also enable or disable the Delete button based on conditions specified in the backend.

        Example

        You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

        Warning
        In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

        Create Object Actions

        By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

        Via a Dialog

        The action opens a dialog in modal view so the user can enter the data.

        With SAP Fiori elements for OData V2, you can:

        • Include a maximum of eight fields in the dialog
        • Enable filter values saved in the filter bar to prefill fields in the dialog
        Warning
        When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

        Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

        With Default Values That Prefill Fields for the New Object

        This feature is available with:

        • SAP Fiori elements for OData V2 for applications without draft handling
        • SAP Fiori elements for OData V4

        Via a Dialog with a Reference to an Existing Object of the Same Type

        With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

        The user:

        1. Clicks the action button.
          You can name the button to suit your use case.
        2. Selects the value of the existing object to reference in the dialog.
        3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
        4. Completes additional fields for the new object in the object page.
        Create from existing object
        Create from existing object
        Developer Hint
        For more information, refer application developers to:

        Copy Object

        You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the selected object.

        You set the label for the button according to your use case. Otherwise, the default label is Copy.

        In the toolbar, the Copy button is displayed after the Create button.

        Developer Hint
        Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

        Hiding Actions in Multiple Content Layout

        You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

        For more information, see:


        Add Card to Insights

        By default, the Add Card to Insights option is displayed in the overflow toolbar of list report tables with the single content layouts when My Home in SAP S/4HANA Cloud is enabled.

        You can ask the application development team to turn the option off.

        For more information, see: Simple Content Layout.


        Developer Hint
        For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.

        Object Page Only Features

        The information below relates only to table toolbar actions and settings in the object page floorplan.


        Search

        You can enable a search on the table.

        For more information, see Search.


        Edit

        By default, Edit is displayed when the business object shown in the table is editable.


        Delete

        By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

        You can enable or disable the Delete action to allow users to delete only in certain conditions.

        For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

        When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

        Warning
        In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

        Subobject Creation

        By default:

        • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
        • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

        You can:

        • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
        • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
        • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
        • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
        Guidelines
        Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

        For more information, see:


        Create Action Visibility

        Whether or not the Create action is visible in the table toolbar depends on:

        • The object page mode.
        • Whether the flow is global or local.
        • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

         

        Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

        Global Flow for Draft-Enabled

        Applications with Fiori Elements for OData V2

        • Navigation indicators   are visible (if required).
        • Create button is not visible.
        • Navigation indicators   are visible (if required).
        • Create button is visible.
        • Navigation indicators   are visible (if required).
        • Create button is visible.

        Local Flow for Non-Draft Enabled Applications

        • Navigation indicators   are visible (if required).
        • Create button is visible.
        • Navigation indicators   are not visible.
        • Create button is not visible.
        Not Supported.

        Inline Creation

        You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

        The inline creation adds a new row to the table where the users can enter the subobject data.

        By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

        You can:

        • Work with the development team to define a custom sort order.
        • Enable default values to prefill the fields for the new object.

        For more information, see Add Items.


        Prefilling Fields for a New Object

        You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

        The new object must be the main object on the object page.

        You determine both the fields to prefill and the default values for the fields.


        Full Screen Mode for Table Display

        You can enable full screen mode for a table. However, it is generally not recommended.

        Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

        For more information on the restrictions for this feature, see Maximize/Minimize.


        Content Switch for Table Views

        The number of views defined for a table determines the UI control that lets users switch the table views:

        By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

        Related Links

        Table Rows

        The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links below.

        Feature Availability

           
         

        Actions

         

        Availability

        Empty Row for Data Entry in Create and Edit Modes Available in an object page for responsive and grid tables: the table displays an empty row for data entry.

        You can turn it off for edit mode.

        Editable Multi-Input Fields Available in an object page in edit mode for all tables.
        Inline Actions Available
        Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
        Conditional Enablement of Navigation Buttons For list report and object pages:

        • Available with SAP Fiori elements for OData V4
        • Requires an extension with SAP Fiori elements for OData V2
        Single Item Selection Default
        Multiple Item Selection Available
        Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
        Delete Available in responsive tables only
        Custom Actions Available
        Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
         

        Display

         

        Availability

        Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
        Editing Status For draft-enabled applications, displayed by default in the responsive table and grid table in a list report. With SAP Fiori elements for OData V4, it is also displayed by default in a tree table.
        Rating Indicator Available
        Progress Indicator Available
        Quick Contact View Available
        Avatar Available
        Avatar Tooltip Available
        Other Images Available with live box mode only
        Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

        In edit mode, the multiple values fields are editable in object page tables.

        The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

        Highlighting New Line Items Available with SAP Fiori elements for OData V2

        Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

        Highlighting Line Items Based on Criticality Available
         

        Responsive Table Only

         

        Availability

        Multiple Fields in a Single Column Available
        Smart Micro Chart Available

        Actions


        Empty Row for Data Entry in Create and Edit Modes

        With this feature, when the object page is in create or edit mode, responsive tables and grid tables display one empty row where the users can enter data for a new subobject.

        The empty row:

        • Is displayed at the top of the responsive table.
          The toolbar has no Create button.
        • Is displayed at the end of a grid table.
          The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
        • Has no inline actions such as delete or navigation to the item via the chevron.
        • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.
        An empty row is displayed in the responsive table in create or edit mode
        An empty row is displayed in the responsive table in create or edit mode

        You can:

        • Set default values to populate fields in the empty rows
        • Enable the feature at the table level in draft-enabled applications
        • Set mandatory fields
        • Set fields in the empty row so they are not editable at creation time, but become editable afterwards for use cases where fields become relevant only after the row is saved. At creation time, these fields are read-only.

        Automatic Creation of a New Empty Row

        After users start to enter data in one field in the empty row, a new empty row is added underneath it so they can continue data entry for either one column or one row at a time.

        The row with data in one field:

        • Is highlighted with a blue line to its left to show it’s a newly created draft
        • Displays the navigation chevron
        • Can also display an inline delete action
        • Displays error messages for mandatory fields without a value.

        If users do not enter data in a new empty row, it is removed when the users save.

        After the user starts entering data in the empty row, a new one is displayed
        After the user starts entering data in the empty row, a new one is displayed

        User-Enabled Creation of Empty Rows in Edit Mode

        In edit mode, you can turn off the default creation of empty rows for tables whose maintenance mostly requires updating data in existing rows.

        If the users want to create additional rows, the Create button lets them enable the automatic creation of one empty row.

        On first click, the Create button creates the empty row. On subsequent clicks, the Create button moves the focus to the first editable field in the first empty table row.  After the users save their changes, the automatic creation of empty rows is turned off.

        Mandatory Fields

        In create and edit modes, both versions of SAP Fiori elements guide users in completing the required fields for an empty row, as follows:

        • With SAP Fiori elements for OData V4, a red asterisk (*) is displayed in the column header label for the mandatory fields.
        • Both SAP Fiori elements for OData V2 and V4 show an error message strip above the table:
          • When the table does not display mandatory columns. It instructs users to display the columns from the table settings.
          • When mandatory fields are not filled. In addition to the message strip for the table, the mandatory field displays a value state message. “Enter a value” is the the placeholder message text.
        Guidelines
        Replace the placeholder text to specify the value to enter with wording more meaningful to the users, for example, “Enter a delivery date.

        You can do this in the i18n file for the application.

        For more information see: Replacing Placeholder Text (SAP Fiori Elements).

        Drafts Saved for Rows

        A draft for a once empty row is saved after the users:

        • Shift the focus away from the input field in the row with SAP Fiori elements for OData V4
        • Have shifted their focus away from the input field in the row and an interval of 20 seconds has passed with SAP Fiori elements for OData V2

        Inline Actions

        You can define actions for table rows or inline items. The action types can be:

        • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

        When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


        Direct Edit

        You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

        This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


        Conditional Enablement of Navigation Buttons

        In list reports and object pages:

        • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
        • With SAP Fiori elements for OData V2, this feature requires extensions.

        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

        Guidelines
        Implement this feature only when the way to enable the button is obvious to end users.

        Item Selection

        Both versions of SAP Fiori elements allow you to determine whether users can select:

        • One table row for a toolbar action, using a radio button.
        • Multiple table rows for a toolbar action, using checkboxes.
          For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
          For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

        When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

        • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
          For complete information, see: Select All / Clear All.
        • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
          You can change the limit. We recommend you consult the application team on how a change would impact performance.

        SAP Fiori elements for OData V2

        By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

        SAP Fiori elements for OData V4

        With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

        • In display mode, item selection is not possible.
        • In edit mode, when the delete action is enabled, multiple selection is also enabled.

        Instead, you can enable one of the following selection modes:

        • None:
          • Display mode allows no item selection.
          • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
        • Single: Both display and edit modes allow single item selection.
        • Multi: Both display and edit modes allow multiple item selection.
        Warning
        When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

        Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

        For more information, see:

        Developer Hint
        For more information, refer the development team to:


        Delete

        In responsive tables only, you can:

        • Display an inline delete action.
        • Prevent the deletion of certain rows.

        In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

        For more information, see Delete Single Item Rows.


        Custom Actions

        You can define custom inline actions.

        Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


        Messages for Critical Actions

        For actions that you set as critical, you can display one of the following after the user triggers the action:

        • A message toast confirmation
        • A confirmation message box to check the users want to proceed with specific critical actions

        Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

        Guidelines
        Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

        Ask the development team whether or not the backend requires confirmations for your use case.

        Example


        SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
        Default Text “Do you really want to execute the action <Action Label>?”

        <Action Label> is the label shown on the button.

        “Do you really want to perform this action?
        Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

        For more information, see UI Text Guidelines for SAP Fiori Apps.


        Display

        You can include the display features described below in a table row or inline item.


        Read-Only Field

        With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


        Editing Status

        By default, for draft-enabled applications, in a list report, the editing status is displayed:

        • In the first column of a responsive table
        • In a separate column, next to the key column, in a grid table. The column is unlabeled. Users can hide or display it by deselecting or selecting Edit Status in the table personalization dialog.

        You can also add the semantic key to the status.

        The edit status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

        • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
        • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

        For more information, see Tables.


        Rating Indicator

        You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

        The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

        With extensions, you can enable editing of the rating indicator

        For more information, see Rating Indicator.


        Progress Indicator

        You can:

        • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
        • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
        • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

        For more information, see Progress Indicator.


        Quick Contact View

        You can add a quick view to a contact to display key contact details in a popover.

        For more information, see Quickview.


        Avatar and Other Images

        You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

        Warning
        Other images are not displayed correctly within the table borders. Only use them with live box mode.

        For more information, see Avatar.


        Highlighting Line Items

        By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

        Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

        You can also define highlighting and icons for line items based on their criticality.

        After a newly created item is saved, it is highlighted according to the criticality, as follows:

        • Green for success (criticality value 3)
        • Yellow for warning (criticality value 2)
        • Red for error (criticality value 1)
        • No highlighting for no criticality (criticality value 0)

        Display in Responsive Table Only

        In a responsive table, you can include the display features described below in a table row or inline item.


        Multiple Fields in a Single Column

        You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

        For example, you can display the following in a single column:

        • Company name
        • Company ID
        • Items in Stock
        • Progress Indicator for Items in Stock
        • Overall value of the Items
        • Multiple Action buttons that allow the user to both:
          • Execute an action while staying on the list report page
          • Navigate to other objects and applications

        The visibility and position in the table of a column that combines multiple fields can be changed.

        Field Labels

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

        Limitation on Export to Spreadsheet

        When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

        Information

        Write a short and meaningful message.


        Smart Micro Chart

        You can:

        • Add an inline micro chart.
        • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

        You can choose among the following micro chart types:

        • Area micro chart
        • Bullet micro chart
        • Line micro chart
        • Micro chart/smart micro chart
        • Radial micro chart
        • Stacked bar micro chart
        Warning
        The user cannot navigate to another page from the chart.

        For more information on chart types, see: Choosing the Correct Chart Type.

        Related Links

        Table Features

        The SAP Fiori elements templates support the features and settings for a table detailed below.

        For design information see the table guidelines, starting with Table Overview, and the links within this article.

        Feature Availability

         

        Table Settings

         

        Availability

        Column Heading Labels You set these.
        Asterisk in Labels for Mandatory Fields In the object page, by default, a red asterisk (*) displays in the column header label for mandatory table fields with SAP Fiori elements for OData V4.
        Tooltips on Column Headers Default
        Clear All When the selection of multiple rows is enabled, the Clear All  checkbox is displayed by default in both the list report and object page for:

        • Grid tables
        • Analytical tables
        • Tree tables

        You can change the default

        Select All When the selection of multiple rows is enabled for a responsive table in an object page, the Select All  checkbox is displayed by default.

        You can change the default.

        Sticky Column Header Behavior Default, you can turn it off.
        Column Width The default width depends on the column contents. You can change it.
        Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

        You can change the level of importance.

        Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
        Ascending Sort Order on a Column Default, you can change it.
        Quick Sort on a Column Available
        Grouping Available in responsive and analytical tables
        Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
        No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
        Message Strip above the Table You can display a custom message above the table in the:

        • List report, object page, and analytical page with SAP Fiori elements for OData V2
        • List report with SAP Fiori elements for OData V4

        In the object page, by default, a message strip is displayed when there are errors in the table.

        When there are multiple messages, the one with the highest severity is displayed.

         

        List Report and Analytical Page Only

         

        Availability

        Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
         

        Object Page Only

         

        Availability

        Message Strip for Rows with Errors Default
        Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

        • Anchor bar navigation and a single section that contains only a grid table
        • Tab bar navigation and a current tab that contains only a grid table

        Table Settings


        Tooltips on Column Headers

        On desktop applications, all table columns display tooltips, based on the text in:

        • Common.QuickInfo, when it’s visible
        • The column label, in all other cases

        Tooltips are available only in desktop applications because users must hover their mouse on the column header to see them.


        Clear All / Select All

        When the selection of multiple rows is enabled for a table in the list report and object page, the Clear All checkbox is displayed by default in the selection column header for all tables, but the responsive table. You can change the default.

        Information
        To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

         Table Type

        Selection Default

        Users Can Select

        Grid table

        Analytical table

        Tree table

        Clear All   Up to 200 rows by default

        We recommend you consult the application development team on how changes to the limit would impact performance.

        Responsive table Select All   All the rows displayed on the interface, not all the rows in the table.

        A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

        Warning
        For grid tables, analytical tables, and tree tables, changing the default Clear All checkbox to the Select All  checkbox can lead to performance issues because Select All   loads all the table rows to the frontend.

        Always ask the application development team about the impact on performance before you consider such a change.

        Guidelines
        When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

        Column Width

        The default column width varies according to the column contents:

        • Text: can range from 3 to 20 rem
        • Image: 5 rem
        • Rating or progress indicator: 6.875 rem
        • Chart: 20 rem

        You can can change the width.

        You can also ask the application developers to ensure the column width takes into account the contents of the column header or to predefine a fixed width for the column.

        Developer Hint
        For more information, refer the development team to Setting the Default Column Width.

        Column Importance in Responsive Tables

        By default:

        • Key fields have high importance in list reports.
        • Other columns have the importance of none and are handled like columns assigned medium importance.

        You can change the level of importance.

        The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

        • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
        • The values in columns with low importance are first to be hidden.

        When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

        You can also assign an importance to custom columns.

        For more information, see:


        Freezing Columns

        You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

        Developer Hint
        For more information, refer application developers to Tables.

        Labels for Multiple Fields in a Column

        By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

        You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


        Sort Order

        By default, the sort order for a column is ascending.

        You can:

        • Set the default sort order to descending.
        • Define other, customized sort orders.

        For more information, see the sort guidelines according to table type:


        Quick Sort on a Column

        Available for any sortable column.

        When a column contains a combination of fields, such as an ID and a description or a field group, the users can sort on each field in the column.


        Number of Table Rows Displayed at Once

        By default, a responsive table loads the following number of rows at once:

        • 20 rows in a list report.
        • 10 rows in an object page with multiple sections.

        When more rows exist, the users can click the More button at the end of the table to view additional rows.

        With SAP Fiori elements for OData V2, you can change the default number.

        For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

        Guidelines
        Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

        Grouping

        Grouping is available in responsive and analytical tables.

        You can define the format of the grouping headers.

        For more information, see:



        No Data Found Text

        By default, the following text is displayed when no data is found.

        • When the user has not applied filters, the text is “No data found.”
        • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
        Guidelines
        Replace the generic text with text that’s meaningful to the user.

        List Report and Analytical Page Only

        Initial Expansion of Table Levels

        By default, on initial load, the following expandable tables are expanded to this number of levels:

        • Responsive table: 1 level
        • Tree table: 1 level
        • Analytical table: 0 levels

        You can change the default value for the tree table and analytical tables.

        Developer Hint
        For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

        Object Page Only

        Message Strip for Rows with Errors

        When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


        Related Links

        List Report – Header

        The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

        For design information, see the List Report Floorplan guidelines and the links below.

        Warning
        Put all controls for searching and filtering data in the list report filter bar.

        Do not include the search or filter options that are available in the table header.

        Feature Availability

         

        Features

         

        Availability

        Page-Level View Management Default, you can turn it off.
        Share Menu Default
        Manual Update Mode Default
        Live Update Mode Available with SAP Fiori elements for OData V2 only
        Search Available
        Filter Bar Default
        Initial State of Header Default:

        • Expanded on large screens
        • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
        Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
        Editing Status Filter Default for draft-enabled applications
        Input Controls for Filters Default
        Adapt Filters UI Element
        • Default: dialog with SAP Fiori elements for OData V2
        • Default: popover with SAP Fiori elements for OData V4

        Feature Details


        Page-Level View Management

        By default, page-level view management is enabled and the header displays a page title.

        You can disable it.

        Guidelines
        If you disable page-level view management, you must display a header title.

        For more information, see Header Title.


        Share Menu

        By default, the header contains the generic Share menu with the global actions Send Email and Save as Tile. It can also include the:

        • Share in SAP Jam menu item when SAP Jam integration is configured.
        • Chat in Microsoft Teams menu item, when the required settings have been made by the system administrators of SAP S/4HANA Cloud.

        This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

        When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA Cloud system with co-workers.

          Developer Hint
          For more information, refer application developers to: Integrating Microsoft Teams.

          Save as Tile

          The tile created opens the list report with the same results shown at the time the tile was saved.

          With SAP Fiori elements for OData V4, users can also save a dynamic tile for results shown after the users have filtered for a relative date value, such as today or this year.

              For more information, see:


              Update Mode

              By default, the update mode is manual.

              You can enable live update mode instead with SAP Fiori elements for OData V2.

              For more information, see Live Update / Manual Update.


              Search

              By default, the search is disabled.

              You can enable it.

              Guidelines
              Work with the development team to define the searchable properties in the data.

              For more information, see Search.


              Filter Bar

              SAP Fiori elements for OData V2 uses the smart filter bar.

              SAP Fiori elements for OData V4 uses the filter bar.

              With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

              • Remove all filter values

              • Reset the value in the Editing Status filter to All

              Warning
              Put all controls for searching and filtering data in the list report filter bar.

              Do not include the search or filter options that are available in the table header.

              Initial State of Header

              The default behavior is shown below:

              Screen Size

              Application Starts with Data

              Application Starts without Data

              S Collapsed Expanded
              M Collapsed Expanded
              L Expanded Expanded
              XL Expanded Expanded

              Pin Button

              With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

              The pin option keeps the header collapsed or expanded when the user scrolls.

              The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

              For more information see, Pinning the Header Content.


              Editing Status Filter

              By default, the filter is enabled for draft-enabled applications.

              The filter values and corresponding results are as follows:

              • All (Default value):
                • All saved (or active) versions of the documents for which the current user has no drafts
                • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
              • All (Hiding Drafts): Only the saved objects.
              • Own DraftDrafts that the current user can display or edit.
              • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
              • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
              • No Changes: Saved versions with no corresponding draft.

              For more information, see Draft handling.


              Input Controls for Filters

              You can decide which filter/input controls to use and set the following for them:

              • The properties available as a filter criterion
              • The labels for the filter fields
              • The default filter values
              • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
              • Type-ahead for values entered
              • Value help lists

              You can also:

              • Decide on the selection controls for the filters
              • Restrict the values accepted in the field. By default, the field accepts multiple values.
              Guidelines
              Date Picker and Date / Time Picker

              By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

              When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

              For more information refer them to: Configuring Filter Fields.

              For more information, see:


              Adapt Filters

              By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

              You can configure the following:

              • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
              • Additional groups for the filters
              • Show input fields: Visible by default. You can hide the Hide value/Show value button.

              Users can add additional fields through views.

              The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

              By default, the Reset button is displayed, you cannot change this.

              For more information, see: Adapt Filters.

              Related Links

              Elements and Controls

              Object Page – Content Area

              The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

              For design information, see the Object Page Floorplan guidelines and the links below.

              Warning
              Always build the object page using the dynamic page header.

              Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

              Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

              Feature Availability

               

              Content Area

               

              Availability

              Draft Object Validation Default

              Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

              Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
              Navigation Bar: Tab Bar Available
              Sections and Subsections Available
              Reuse Components as Sections Available
               

              Subsections

               

              Availability

              Link Available

              With SAP Fiori elements for OData V4, you can display an icon or image with the link.

              With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

              Smart Link Contact Available, SAP Fiori elements for OData V2 only
              Tables Available
              Charts Available
              Views for Tables and Charts Available
              Address Available
              Display of Related Properties Together Available with SAP Fiori elements for OData for V4

              The properties can also display as links.

              Forms Available
              Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

              You can:

              • Change the maximum
              • Enable growing mode
              • Show users the number of characters allowed in the text area
              File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
              Dynamic Side Content Available with an extension
               

              Subsection Behavior

               

              Availability

              Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
              Adjustment of the Width for Content Display in a Subsection Available
               

              Content Visibility

               

              Availability

              Visible Sections, Subsections, Quickviews, and Tables Default
              Hiding Section, Subsection, Quickview and Table Content Available
              User-Controlled Visibility with Show More/Show Less Available
              Visible Smart Form Fields Default, you can hide them in certain conditions.

              Content Area

              Draft Object Validation

              By default, data validation for the object page happens only when the users save the object so they enter data without interruption.

              They can trigger data validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

              For more information, see: Form Field Validation

              Navigation Bar

              By default, the anchor bar is generated when the object page has more than one section.

              It lets users navigate to the individual content area sections.

              You can:

              • Hide the anchor bar when you only have one section.
              • Replace it with a tab bar.

              With extensions, you can replace the buttons with another type of control.

              If there is no Anchor Bar, but there is editable information in the header, the first temporary section in the Object Page which controls the header content will have a section title called ‘Header’.

              For more information, see:


              Sections and Subsections

              You can add sections and subsections to the content area.

              Sections contain only subsections. You build the subsection content with tables, charts, and forms.

              When the object page uses:

              • Tab bar navigation, the section title isn’t displayed in the content area
              • Anchor bar navigation, only the title of the first section is hidden in the content area, unless the first section contains a table
                Guidelines

                When you assign a section or subsection title, do not use a comma (,) in it because commas serve as delimiters in SAP Fiori elements.

                Section and Subsection Titles

                To minimize both the number of titles displayed and redundancies among the title values:

                • When a section or subsection contains a single table or chart control, only the control title is displayed, but its value is replaced by the section or subsection title.
                • With SAP Fiori elements for OData V4, when a section or subsection contains a single text area, the section or subsection title is displayed instead of the text area label when the object page is in display mode. The label is only displayed in edit mode if the field is mandatory.

                For more information, see: Sections and Subsections.


                Reuse Components as Sections

                You can embed a reuse component as a section in the object page.

                Warning
                A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                Consult the development team on the requirements for the reuse component.

                Subsections

                With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                The smart link contact can include a contact list and a quickview of the contact details.

                For more information, see:

                Tables

                You can include a table in a subsection.

                When a table is the only content in a subsection, the subsection title is not displayed. Instead, the title of the table shows the value assigned to the subsection title.

                For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                Charts

                You can include a single chart facet in a subsection.

                In the chart, you can:

                • Display measures, their aggregation calculations, and dimensions to categorize the measures.
                • Add custom actions to the toolbar for a chart and define whether they are enabled at all times or only after the user selects part of the chart for the action.
                • Allow users to personalize the chart settings

                When a chart is the only content in a subsection, the subsection title is not displayed. Instead the title of the chart shows the value assigned to the subsection title.

                SAP Fiori Elements for OData V2

                Charts are only supported for business objects or services that are not draft enabled or are read-only.

                SAP Fiori Elements for OData V4

                You can define a chart for a draft-enabled business object. The chart only displays active data, not data entered into an unsaved draft record.

                For more information, see Chart (VizFrame).

                For more information on chart options, see Chart.

                Developer Hint
                For more information, refer application developers to Configuring Charts.

                Views for Tables and Charts

                You can turn on views for:

                • All the tables and charts on the page
                • Individual tables and charts

                For more information, see Views (Variant Management).

                Address

                You can add one or more address fields:

                • As a separate subsection
                • As part of a field group within a subsection
                • To a quick view with smart link navigation

                For more information, see:

                Display of Related Properties Together

                You can display two related properties side-by-side and with a single label in display mode.

                For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

                You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

                In edit mode, the fields can be edited separately.

                Side-by-side display of related properties
                Side-by-side display of related properties

                Related Properties as Links

                The related properties can also display as links.

                Developer Hint
                Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
                Related properties as links
                Related properties as links

                Forms

                You can add action buttons to the toolbar for a form contained in a subsection.

                With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                The action types can be:

                • Actions that occur in the system while the user stays on the object page.
                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                Conditional Enablement of Navigation Buttons

                You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                Guidelines
                Implement this feature only when the way to enable the button is obvious to end users.

                Columns in a Form

                To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                 

                Column Number

                Screen Size

                1 Small
                2 Medium
                3 Large
                6 Extra large
                Guidelines
                The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                Groups in a Form

                You can group fields in a form and assign a name to the group.

                Note that the group name is displayed only when a group contains fields.

                User-Controlled Load of Fields with Low Importance

                To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                Text Control

                By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                You can:

                • Set a maximum number of lines for the text control that’s greater than four.
                • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
                • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

                A notification is displayed if the users try to enter text beyond the limit.

                In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                File Upload

                With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                The application developers can define the file size and types allowed for upload.

                Dynamic Side Content

                You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                  Guidelines

                  • Do not use tables in the side content panel.
                  • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                  • For the best view of the dynamic side content, set it to display in 50% of the screen.

                  For more information, see:

                  Developer Hint

                  Subsection Behavior

                  Subsection Loading Behavior

                  By default, the subsection starts loading after the main object page elements are loaded.

                  You can change the loading behavior to load the subsection after the header data is loaded.

                  Example

                  When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                  Width for Content Display in a Subsection

                  When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                  Content Visibility

                  Sections, Subsections, Quickviews, and Tables

                  By default, the object page displays these components.

                  You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                  User-Controlled Visibility

                  You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                  • When the subsection is hidden, Show More is displayed.
                  • When the subsection shows, the Show Less link is displayed.

                  Visibility of Smart Form Fields

                  By default, all smart form fields have the high importance setting and show on all screen sizes.

                  You can lower the level of importance for the fields to hide them on smaller screens.

                  According to the importance assigned to the field, it is displayed as follows:

                  • High (default): On all (small, medium, and large) screen sizes.
                  • Medium: On large and medium screens only.
                  • Low: On large screens only

                  For more information, see Responsiveness.

                  Related Links

                  Object Page – Header

                  The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                  For design information, see the Object Page Floorplan guidelines and the links below.

                  Warning
                  Always build the object page using the dynamic page header.

                  Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                  Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                  Feature Availability

                   

                  Behavior and Interaction

                   

                  Availability

                  Expanded State Default on initial load
                  Collapsed State Default on scroll

                  With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                  Header Content Display in Display Mode In the header content area
                  Header Content Display in Edit and Create Modes When the header is editable:

                  • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                  • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                  Header Content Visible Default, you can hide it.
                  Header Content Hidden Available
                  Header Field Editability By default, in edit mode the header is:

                  • Not editable with SAP Fiori elements for OData V2
                  • Editable with SAP Fiori elements for OData V4

                  You can change the default.

                  Highlighting Values Based on Criticality Available
                   

                  Components

                   

                  Availability

                  Dynamic Page Header Mandatory, it must be configured.
                  Title Mandatory, you must define it.
                  Menu for Saved Version / Draft Default for draft-enabled applications
                  Breadcrumbs Default
                  Subtitle Available, you define the text.
                  Object Marker Default in draft-enabled applications
                  Image Available
                  Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                  Paging Buttons on the First Subobject Page Default under certain conditions
                  Toolbar Available
                   

                  Toolbar Actions

                   

                  Availability

                  Edit and Delete Default, when the data allows these actions.

                  You can turn one or both actions off.

                  Copy Available with SAP Fiori elements for OData V2
                  Related Apps Menu Button Available

                  With SAP Fiori elements for OData V4, you can change the button name to Open in…

                  Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                  Application-Specific Actions Available,  they must be configured.
                  Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                  Requires an extension with SAP Fiori elements for OData V2

                  Order of Toolbar Actions Default

                  You can change the default order.

                   

                  Additional Content (Optional)

                   

                  Availability

                  Message Strip Available to provide information related to the object as a whole, such as the object status
                  Simple Header Facets Available with SAP Fiori elements for OData V2 only
                  Plain Text Facets Available
                  Contact Facets Available
                  Micro Chart Facets Available
                  Form Facets Available
                  Address Facets Available
                  Header Field Group Available
                  Rating Indicator Facets Available
                  Progress Indicator Facet Available
                  Key Value Facet Available
                  Link Available

                  With SAP Fiori elements for OData V2:

                  • The default link shows the text and ID. You can remove the text or the ID from the link.
                  • You can include a link that navigates to a site external to the application.

                  Behavior and Interaction


                  Collapsed/Expanded State

                  When the object page header contains at least one facet:

                  • On the initial load of the object page, the header is expanded.
                  • When the user scrolls down the page, the header collapses.
                  • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                  When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                  With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                  Next to the title, an arrow   button lets the users expand the header.

                  Summary Line for Object Page Header on Small Screens
                  Summary Line for Object Page Header on Small Screens

                  Display of Header Content

                  In display mode, the header content area displays all the header content.

                  In edit and create modes, when the header is:

                  • Editable
                    • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                  The header section is only present in the edit and create modes.

                    • The first temporary section will have a section title called “Header” if there is no Anchor Bar available.
                    • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                   

                  • Not Editable, the header is hidden.

                  Note that, by default, the header is

                  • Editable with SAP Fiori elements for OData V4
                  • Not editable with SAP Fiori elements for OData V2

                  You can ask the application developers to change the default.

                  For more information, see Dynamic Page Header (Mandatory).

                  Developer Hint
                  To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                  Header Content Visibility

                  By default, header content is visible.

                  You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                  • Entire header facets
                  • Content, such as fields, in a header facet
                  • Content in quick views

                  With Fiori elements for OData V2, you can set:

                  • The header to be displayed in edit mode.
                  • Header facets to be visible in edit mode.
                  Developer Hint
                  For more information on the features, refer the development team to:


                  Header Field Editability

                  By default, in edit mode the header is:

                  • Not editable with SAP Fiori elements for OData V2
                  • Editable with SAP Fiori elements for OData V4

                  You can change the default.

                  Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                  Developer Hint
                  To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                  Highlighting Values Based on Criticality

                  You can assign colors and icons to text to indicate the criticality of a field value.

                  With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                  Components


                  Title

                  By default, with:

                  •  SAP Fiori elements for OData V2, the title area is empty.
                  •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                  Guidelines
                  Tell the developers which property to use as the title.

                  Menu for Saved Version / Draft

                  With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                  Breadcrumbs

                  Breadcrumbs are displayed above the object title.

                  Guidelines
                  Limit the breadcrumbs to the drilldown levels within the object page.

                  Object Marker

                  The object marker indicates the object is locked by another user in draft-enabled applications.


                  Image

                  The image is an avatar control. By default, it has a square shape.

                  You can set:

                  • An image to display instead of the avatar. SAP Fiori elements for OData V4 uses the lightbox control to allow a larger view of the image.
                  • The avatar to a have a circular shape.

                  When no image is set or found for the avatar, the avatar initials are displayed.

                  If those are not set or found either, an icon for the avatar is displayed:

                  • A square avatar for a product
                  • A circular avatar for a person.

                  For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                  Paging Buttons

                  By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                  • The user has navigated from a table in the object page to the subobject.
                  • The table in the object page contains at least two items.

                  With SAP Fiori elements for OData V2, you can:

                  • Enable the paging buttons to show on the first object page opened from a list report.
                  • Disable the default display of the paging buttons on the subobject page.

                  Toolbar Actions


                  Edit and Delete

                  By default, these actions are displayed when the data in the object page allows them.

                  You can:

                  • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                  • Disable the actions.

                  For more information, see:


                  Copy

                  You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                  You set the label for the button according to your use case. Otherwise, the default label is Copy.

                  In the object page, the Copy button is displayed after the Delete button.

                  Developer Hint
                  Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                  Related Apps Menu Button

                  You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                  You can also:

                  • Hide specific actions in the menu.
                  • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                  Generic Actions

                  By default, the Share button is displayed for saved objects and hidden for drafts.

                  It can include the:

                  • Share in SAP Jam menu item when SAP Jam integration is configured.
                  • Microsoft Teams > As Chat and As Card options when the required settings have been made by the system administrators of SAP S/4HANA or SAP S/4HANA Cloud.

                  This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA or SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                  When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA or SAP S/4HANA Cloud system with co-workers.

                  With SAP Fiori elements for OData V4, you can control the visibility in the Share menu of the Send E-mail and Share: Microsoft Teams options at both application level and page level.

                  For more information, see:

                  Developer Hint
                  For more information, refer application developers to:


                  Application-Specific Actions

                  You can include the actions required for your use case.

                  The header toolbar displays application-specific actions to the left of the generic actions.

                  You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                  Developer Hint
                  For more information, refer application developers to Keyboard Shortcuts.

                  Conditional Enablement of Navigation Buttons

                  With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                  With SAP Fiori elements for OData V2, this feature requires extensions.

                  For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                  Guidelines
                  Implement this feature only when the way to enable the button is obvious to end users.

                  Order of Toolbar Actions

                  The default order — left to right — for actions in the object page toolbar is below:

                  • Edit
                  • Delete
                  • Copy with SAP Fiori elements for OData V2
                  • Application-specific action buttons
                  • Related Apps menu button
                  • Share

                  You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                  For more information, see:

                  Additional Content


                  Message Strip

                  You can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                  The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                  When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                  The user can find the individual messages via the message popover in the footer bar.

                  For more information, see:

                  Simple Header Facets

                  With SAP Fiori elements for OData V2:

                  • You can use a simple header facet to show simple data points that align horizontally across the header.
                  • When form fields contain no value, they display the empty  state indicator (–).

                  Plain Text Facets

                  You can use the plain text facet to display a continuous text in the header.

                  For more information, see Plain Text Facet.


                  Contact Facets

                  You can enable a quick view for a contact.

                  With SAP Fiori elements for OData V4:

                  • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                  • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                  For more information, see Quick View.


                  Micro Chart Facets

                  You can display the following micro charts in the header:

                  • Area micro chart
                  • Bullet chart
                  • Radial chart
                  • Column chart
                  • Line micro chart
                  • Harvey ball chart
                  • Stacked bar chart

                  For more information, see Micro Charts.


                  Form Facets

                  You can add a quick view to the form facet.

                  For more information, see Form Facet (Dataset).

                  Developer Hint
                  For more information, refer the development team to Form Facet.

                  Address Facets

                  You can display an address such as a shipping address.

                  Developer Hint
                  For more information, refer the development team to Address Facet in the Object Page Header.

                  Header Field Groups

                  You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                  Rating Indicator Facets

                  You can add a rating indicator to the header. It is read-only in both display and edit modes.

                  By default, the maximum rating is five stars.

                  You can:

                  • Change the maximum rating.
                  • Specify more descriptive text for the subtitle.

                  With extensions, you can make the rating editable.

                  Display Mode

                  The rating indicator shows with the:

                  • Title
                  • Subtitle with the total number of ratings
                  • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                  Edit Mode

                  The rating indicator moves into the header facet and appears with only the title in edit mode.

                  For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                  For more information, see:


                  Progress Indicator Facets

                  You can add a progress indicator facet to the object header.

                  For more information, see:


                  Key Value Facets

                  You can add a key value facet to highlight important data or KPIs.

                  For more information, see Key Value Facet.

                  Related Links

                  List Report – Header

                  The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

                  For design information, see the List Report Floorplan guidelines and the links below.

                  Warning
                  Put all controls for searching and filtering data in the list report filter bar.

                  Do not include the search or filter options that are available in the table header.

                  Feature Availability

                   

                  Features

                   

                  Availability

                  Page-Level View Management Default, you can turn it off.
                  Share Menu Default
                  Manual Update Mode Default
                  Live Update Mode Available
                  Search Available
                  Filter Bar Default
                  Initial State of Header Default:

                  • Expanded on large screens
                  • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
                  Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
                  Editing Status Filter Default for draft-enabled applications
                  Input Controls for Filters Default
                  Adapt Filters UI Element
                  • Default: dialog with SAP Fiori elements for OData V2
                  • Default: popover with SAP Fiori elements for OData V4

                  Feature Details


                  Page-Level View Management

                  By default, page-level view management is enabled and the header displays a page title.

                  You can disable it.

                  Guidelines
                  If you disable page-level view management, you must display a header title.

                  For more information, see Header Title.


                  Share Menu

                  By default, the header contains the generic Share menu with the global actions Send Email and Save as Tile. It can also include the:

                  • Share in SAP Jam menu item when SAP Jam integration is configured.
                  • Microsoft Teams > As Chat and As Card options when the required settings have been made by the system administrators of SAP S/4HANA or SAP S/4HANA Cloud.

                  This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA or SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                  When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA or SAP S/4HANA Cloud system with co-workers.

                  With SAP Fiori elements for OData V4, you can control the visibility in the Share menu of the Send E-mail and Share: Microsoft Teams options at both application level and page level.

                  Save as Tile

                  The tile created opens the list report with the same results shown at the time the tile was saved.

                  Users can also save a dynamic tile for results shown after the users have filtered for a relative date value, such as today or this year.

                    For more information, see:

                    Developer Hint
                    For more information, refer application developers to:


                    Update Mode

                    By default, the update mode is manual.

                    You can enable live update mode instead.

                    For more information, see Live Update / Manual Update.


                    Search

                    By default, the search is disabled.

                    You can enable it.

                    Guidelines
                    Work with the development team to define the searchable properties in the data.

                    For more information, see Search.


                    Filter Bar

                    SAP Fiori elements for OData V2 uses the smart filter bar.

                    SAP Fiori elements for OData V4 uses the filter bar.

                    With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

                    • Remove all filter values

                    • Reset the value in the Editing Status filter to All

                    Warning
                    Put all controls for searching and filtering data in the list report filter bar.

                    Do not include the search or filter options that are available in the table header.

                    Initial State of Header

                    The default behavior is shown below:

                    Screen Size

                    Application Starts with Data

                    Application Starts without Data

                    S Collapsed Expanded
                    M Collapsed Expanded
                    L Expanded Expanded
                    XL Expanded Expanded

                    Pin Button

                    With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

                    The pin option keeps the header collapsed or expanded when the user scrolls.

                    The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

                    For more information see, Pinning the Header Content.


                    Editing Status Filter

                    By default, the filter is enabled for draft-enabled applications.

                    The filter values and corresponding results are as follows:

                    • All (Default value):
                      • All saved (or active) versions of the documents for which the current user has no drafts
                      • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
                    • All (Hiding Drafts): Only the saved objects.
                    • Own DraftDrafts that the current user can display or edit.
                    • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
                    • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
                    • No Changes: Saved versions with no corresponding draft.

                    For more information, see Draft handling.


                    Input Controls for Filters

                    You can decide which filter/input controls to use and set the following for them:

                    • The properties available as a filter criterion
                    • The labels for the filter fields
                    • The default filter values
                    • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
                    • Type-ahead for values entered
                    • Value help lists
                      By default, a dialog conditions tab is displayed for the value help. Remind application developers to define the right value help options.
                    Developer Hint
                    For information on defining the value help, refer application developers to Field Help.

                    You can also:

                    • Decide on the selection controls for the filters
                    • Restrict the values accepted in the field. By default, the field accepts multiple values.
                    Guidelines
                    Date Picker and Date / Time Picker

                    By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

                    When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

                    For more information refer them to: Configuring Filter Fields.

                    For more information, see:


                    Adapt Filters

                    By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

                    You can configure the following:

                    • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
                    • Additional groups for the filters
                    • Show input fields: Visible by default. You can hide the Hide value/Show value button.

                    Users can add additional fields through views.

                    The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

                    By default, the Reset button is displayed, you cannot change this.

                    For more information, see: Adapt Filters.

                    Related Links

                    Elements and Controls

                    List Report – Content Area

                    The SAP Fiori elements list report template supports the three content area layouts detailed below.

                    For design information, see General Layout and the links below.

                    Simple Content Layout

                    The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                    • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                    • Automatic data loading
                    • One table toolbar
                    • Creation of business objects via a dialog
                    • Creation of cards for the Insights section of My Home in SAP S/4HANA Cloud, when My Home in SAP S/4HANA Cloud has been enabled. The Add Card to Insights option automatically appears in the overflow toolbar of the table in list report. You can turn off this feature.
                    Warning

                    • We strongly recommend you avoid table-level view management, but it is supported.
                    • With SAP Fiori elements for OData V4 these restrictions apply for the Insights cards:
                      • When users navigate from the card in the Insights section of the My Home page to the list report table, the table view is similar to its state at card creation, but it does not retain the changes in the position or removal of filter fields or table columns.
                      • The formatting of unit of measure fields differs between the Insights card and the list report table.

                    Developer Hint
                    For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.
                    Simple content layout (default)
                    Simple content layout (default)

                    Multiple View Layout

                    For more complex scenarios, you can turn on the multiple view layout which supports: 

                    • Display of multiple views of a table that shows one business object, for example, each view of the same table can display different prefiltered states
                    • The segmented button for a maximum of three views or the select control for four or more views
                      Note that the SAP Fiori elements framework determines the switch control automatically based on the number of views.
                    • Display of the count or number of total rows in the view (must be enabled)
                    • One table toolbar
                    • Automatic data loading
                    • Creation of business objects via a dialog with SAP Fiori elements for OData V2
                    • Creation of cards for the Insights section of My Home in SAP S/4HANA Cloud, by default when My Home in SAP S/4HANA Cloud has been enabled. You can turn off this feature.
                    Warning

                    • We strongly recommend you avoid table-level view management, but it is supported.
                    • With SAP Fiori elements for OData V4 these restrictions apply for the Insights cards:
                      • When users navigate from the card in the Insights section of the My Home page to the list report table, the table view is similar to its state at card creation, but it does not retain the changes in the position or removal of filter fields or table columns.
                      • The formatting of unit of measure fields differs between the Insights card and the list report table.

                    Developer Hint
                    For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.
                    Multiple view layout - Segmented button
                    Multiple view layout - Segmented button
                    Muliple view layout - Select control
                    Muliple view layout - Select control

                    Multiple Content Layout

                    To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                    • Display of one or more business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can be filtered by a specific customer and a specific date
                    • Text-only icon tab bar to switch among the tabs
                    • Views with data visualization in either table or chart format with both SAP Fiori elements for OData V2 and V4
                    • Automatic data loading
                    • Different toolbars for each view
                    Warning

                    • We strongly recommend you avoid table-level or chart-level view management, but it is supported.
                    • Creation of business objects must be done in an object page. Doing it via a dialog is not supported
                    • Do not use a mix of responsive and non-responsive tables.

                    Developer Hint
                    Application developers may be unfamiliar with the designer term “multiple content layout.”

                    For more information on implementing this feature, refer the development team to:

                    Multiple content layout
                    Multiple content layout

                    Related Links

                    Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                    List Report – Header

                    The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

                    For design information, see the List Report Floorplan guidelines and the links below.

                    Warning
                    Put all controls for searching and filtering data in the list report filter bar.

                    Do not include the search or filter options that are available in the table header.

                    Feature Availability

                     

                    Features

                     

                    Availability

                    Page-Level View Management Default, you can turn it off.
                    Share Menu Default
                    Manual Update Mode Default
                    Live Update Mode Available
                    Search Available
                    Filter Bar Default
                    Initial State of Header Default:

                    • Expanded on large screens
                    • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
                    Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
                    Editing Status Filter Default for draft-enabled applications
                    Input Controls for Filters Default
                    Adapt Filters UI Element
                    • Default: dialog with SAP Fiori elements for OData V2
                    • Default: popover with SAP Fiori elements for OData V4

                    Feature Details


                    Page-Level View Management

                    By default, page-level view management is enabled and the header displays a page title.

                    You can disable it.

                    Guidelines
                    If you disable page-level view management, you must display a header title.

                    For more information, see Header Title.

                    Share Menu

                    By default, the header contains the generic Share menu with the global actions Send Email and Save as Tile. It can also include the:

                    • Share in SAP Jam menu item when SAP Jam integration is configured.
                    • Microsoft Teams > As Chat option when the required settings have been made by the system administrators of SAP S/4HANA or SAP S/4HANA Cloud.

                    This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA or SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                    When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA or SAP S/4HANA Cloud system with co-workers.

                      Save as Tile

                      The tile created opens the list report with the same results shown at the time the tile was saved.

                      Users can also save a dynamic tile for results shown after the users have filtered for a relative

                        For more information, see:

                        Developer Hint
                        For more information, refer application developers to:



                        Update Mode

                        By default, the update mode is manual.

                        You can enable live update mode instead.

                        For more information, see Live Update / Manual Update.


                        Search

                        By default, the search is disabled.

                        You can enable it.

                        Guidelines
                        Work with the development team to define the searchable properties in the data.

                        For more information, see Search.


                        Filter Bar

                        SAP Fiori elements for OData V2 uses the smart filter bar.

                        SAP Fiori elements for OData V4 uses the filter bar.

                        With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

                        • Remove all filter values

                        • Reset the value in the Editing Status filter to All

                        Warning
                        Put all controls for searching and filtering data in the list report filter bar.

                        Do not include the search or filter options that are available in the table header.

                        Initial State of Header

                        The default behavior is shown below:

                        Screen Size

                        Application Starts with Data

                        Application Starts without Data

                        S Collapsed Expanded
                        M Collapsed Expanded
                        L Expanded Expanded
                        XL Expanded Expanded

                        Pin Button

                        With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

                        The pin option keeps the header collapsed or expanded when the user scrolls.

                        The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

                        For more information see, Pinning the Header Content.


                        Editing Status Filter

                        By default, the filter is enabled for draft-enabled applications.

                        The filter values and corresponding results are as follows:

                        • All (Default value):
                          • All saved (or active) versions of the documents for which the current user has no drafts
                          • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
                        • All (Hiding Drafts): Only the saved objects.
                        • Own DraftDrafts that the current user can display or edit.
                        • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
                        • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
                        • No Changes: Saved versions with no corresponding draft.

                        For more information, see Draft handling.


                        Input Controls for Filters

                        You can decide which filter/input controls to use and set the following for them:

                        • The properties available as a filter criterion
                        • The labels for the filter fields
                        • The default filter values
                        • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
                        • Type-ahead for values entered
                        • Value help lists
                          By default, a dialog conditions tab is displayed for the value help. Remind application developers to define the right value help options.

                        You can also:

                        • Decide on the selection controls for the filters
                        • Restrict the values accepted in the field. By default, the field accepts multiple values.
                        Guidelines
                        Date Picker and Date / Time Picker

                        By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

                        When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

                        For more information refer them to: Configuring Filter Fields.

                        For more information, see:

                        Developer Hint
                        For information on defining the value help, refer application developers to XXXX

                        Adapt Filters

                        By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

                        You can configure the following:

                        • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
                        • Additional groups for the filters
                        • Show input fields: Visible by default. You can hide the Hide value/Show value button.

                        Users can add additional fields through views.

                        The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

                        By default, the Reset button is displayed, you cannot change this.

                        For more information, see: Adapt Filters.

                        Related Links

                        Elements and Controls

                        Object Page – Header

                        The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                        For design information, see the Object Page Floorplan guidelines and the links below.

                        Warning
                        Always build the object page using the dynamic page header.

                        Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                        Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                        Feature Availability

                         

                        Behavior and Interaction

                         

                        Availability

                        Expanded State Default on initial load
                        Collapsed State Default on scroll

                        With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                        Header Content Display in Display Mode In the header content area
                        Header Content Display in Edit and Create Modes When the header is editable:

                        • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                        • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                        Header Content Visible Default, you can hide it.
                        Header Content Hidden Available
                        Header Field Editability By default, in edit mode the header is:

                        • Not editable with SAP Fiori elements for OData V2
                        • Editable with SAP Fiori elements for OData V4

                        You can change the default.

                        Highlighting Values Based on Criticality Available
                         

                        Components

                         

                        Availability

                        Dynamic Page Header Mandatory, it must be configured.
                        Title Mandatory, you must define it.
                        Menu for Saved Version / Draft Default for draft-enabled applications
                        Breadcrumbs Default
                        Subtitle Available, you define the text.
                        Object Marker Default in draft-enabled applications
                        Image Available
                        Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                        Paging Buttons on the First Subobject Page Default under certain conditions
                        Toolbar Available
                         

                        Toolbar Actions

                         

                        Availability

                        Edit and Delete Default, when the data allows these actions.

                        You can turn one or both actions off.

                        Copy Available with SAP Fiori elements for OData V2
                        Related Apps Menu Button Available

                        With SAP Fiori elements for OData V4, you can change the button name to Open in…

                        Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                        Application-Specific Actions Available,  they must be configured.
                        Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                        Requires an extension with SAP Fiori elements for OData V2

                        Order of Toolbar Actions Default

                        You can change the default order.

                         

                        Additional Content (Optional)

                         

                        Availability

                        Message Strip Available with SAP Fiori elements for OData V4 to provide information related to the object as a whole, such as the object status
                        Simple Header Facets Available with SAP Fiori elements for OData V2 only
                        Plain Text Facets Available
                        Contact Facets Available
                        Micro Chart Facets Available
                        Form Facets Available
                        Address Facets Available
                        Header Field Group Available
                        Rating Indicator Facets Available
                        Progress Indicator Facet Available
                        Key Value Facet Available
                        Link Available

                        With SAP Fiori elements for OData V2:

                        • The default link shows the text and ID. You can remove the text or the ID from the link.
                        • You can include a link that navigates to a site external to the application.

                        Behavior and Interaction


                        Collapsed/Expanded State

                        When the object page header contains at least one facet:

                        • On the initial load of the object page, the header is expanded.
                        • When the user scrolls down the page, the header collapses.
                        • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                        When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                        With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                        Next to the title, an arrow   button lets the users expand the header.

                        Summary Line for Object Page Header on Small Screens
                        Summary Line for Object Page Header on Small Screens

                        Display of Header Content

                        In display mode, the header content area displays all the header content.

                        In edit and create modes, when the header is:

                        • Editable
                          • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                        The header section is only present in the edit and create modes.

                          • The first temporary section will have a section title called “Header” if there is no Anchor Bar available.
                          • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                         

                        • Not Editable, the header is hidden.

                        Note that, by default, the header is

                        • Editable with SAP Fiori elements for OData V4
                        • Not editable with SAP Fiori elements for OData V2

                        You can ask the application developers to change the default.

                        For more information, see Dynamic Page Header (Mandatory).

                        Developer Hint
                        To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                        Header Content Visibility

                        By default, header content is visible.

                        You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                        • Entire header facets
                        • Content, such as fields, in a header facet
                        • Content in quick views

                        With Fiori elements for OData V2, you can set:

                        • The header to be displayed in edit mode.
                        • Header facets to be visible in edit mode.
                        Developer Hint
                        For more information on the features, refer the development team to:


                        Header Field Editability

                        By default, in edit mode the header is:

                        • Not editable with SAP Fiori elements for OData V2
                        • Editable with SAP Fiori elements for OData V4

                        You can change the default.

                        Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                        Developer Hint
                        To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                        Highlighting Values Based on Criticality

                        You can assign colors and icons to text to indicate the criticality of a field value.

                        With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                        Components


                        Title

                        By default, with:

                        •  SAP Fiori elements for OData V2, the title area is empty.
                        •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                        Guidelines
                        Tell the developers which property to use as the title.

                        Menu for Saved Version / Draft

                        With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                        Breadcrumbs

                        Breadcrumbs are displayed above the object title.

                        Guidelines
                        Limit the breadcrumbs to the drilldown levels within the object page.

                        Object Marker

                        The object marker indicates the object is locked by another user in draft-enabled applications.


                        Image

                        The image is an avatar control. By default, it has a square shape.

                        You can set:

                        • An image to display instead of the avatar.
                        • The avatar to a have a circular shape.

                        When no image is set or found for the avatar, the avatar initials are displayed.

                        If those are not set or found either, an icon for the avatar is displayed:

                        • A square avatar for a product
                        • A circular avatar for a person.

                        For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                        Paging Buttons

                        By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                        • The user has navigated from a table in the object page to the subobject.
                        • The table in the object page contains at least two items.

                        With SAP Fiori elements for OData V2, you can:

                        • Enable the paging buttons to show on the first object page opened from a list report.
                        • Disable the default display of the paging buttons on the subobject page.

                        Toolbar Actions


                        Edit and Delete

                        By default, these actions are displayed when the data in the object page allows them.

                        You can:

                        • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                        • Disable the actions.

                        For more information, see:


                        Copy

                        You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                        You set the label for the button according to your use case. Otherwise, the default label is Copy.

                        In the object page, the Copy button is displayed after the Delete button.

                        Developer Hint
                        Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                        Related Apps Menu Button

                        You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                        You can also:

                        • Hide specific actions in the menu.
                        • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                        Generic Actions

                        By default, the Share button is displayed for saved objects and hidden for drafts.

                        The share menu includes the Chat in Microsoft Teams option when the required settings have been made by the system administrators of SAP S/4HANA CloudThis option is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.
                        The share menu includes the Chat in Microsoft Teams option when the required settings have been made by the system administrators of SAP S/4HANA Cloud.

                        The option is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                        For more information, see Share (Generic).

                        Developer Hint
                        For more information, refer application developers to: Integrating Microsoft Teams.

                        Application-Specific Actions

                        You can include the actions required for your use case.

                        The header toolbar displays application-specific actions to the left of the generic actions.

                        You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                        Developer Hint
                        For more information, refer application developers to Keyboard Shortcuts.

                        Conditional Enablement of Navigation Buttons

                        With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                        With SAP Fiori elements for OData V2, this feature requires extensions.

                        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                        Guidelines
                        Implement this feature only when the way to enable the button is obvious to end users.

                        Order of Toolbar Actions

                        The default order — left to right — for actions in the object page toolbar is below:

                        • Edit
                        • Delete
                        • Copy with SAP Fiori elements for OData V2
                        • Application-specific action buttons
                        • Related Apps menu button
                        • Share

                        You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                        For more information, see:

                        Additional Content


                        Message Strip

                        With SAP Fiori elements for OData V4, you can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                        The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                        When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                        The user can find the individual messages via the message popover in the footer bar.

                        For more information, see:

                        Simple Header Facets

                        With SAP Fiori elements for OData V2:

                        • You can use a simple header facet to show simple data points that align horizontally across the header.
                        • When form fields contain no value, they display the empty  state indicator (–).

                        Plain Text Facets

                        You can use the plain text facet to display a continuous text in the header.

                        For more information, see Plain Text Facet.


                        Contact Facets

                        You can enable a quick view for a contact.

                        With SAP Fiori elements for OData V4:

                        • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                        • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                        For more information, see Quick View.


                        Micro Chart Facets

                        You can display the following micro charts in the header:

                        • Area micro chart
                        • Bullet chart
                        • Radial chart
                        • Column chart
                        • Line micro chart
                        • Harvey ball chart
                        • Stacked bar chart

                        For more information, see Micro Charts.


                        Form Facets

                        You can add a quick view to the form facet.

                        For more information, see Form Facet (Dataset).

                        Developer Hint
                        For more information, refer the development team to Form Facet.

                        Address Facets

                        You can display an address such as a shipping address.

                        Developer Hint
                        For more information, refer the development team to Address Facet in the Object Page Header.

                        Header Field Groups

                        You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                        Rating Indicator Facets

                        You can add a rating indicator to the header. It is read-only in both display and edit modes.

                        By default, the maximum rating is five stars.

                        You can:

                        • Change the maximum rating.
                        • Specify more descriptive text for the subtitle.

                        With extensions, you can make the rating editable.

                        Display Mode

                        The rating indicator shows with the:

                        • Title
                        • Subtitle with the total number of ratings
                        • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                        Edit Mode

                        The rating indicator moves into the header facet and appears with only the title in edit mode.

                        For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                        For more information, see:


                        Progress Indicator Facets

                        You can add a progress indicator facet to the object header.

                        For more information, see:


                        Key Value Facets

                        You can add a key value facet to highlight important data or KPIs.

                        For more information, see Key Value Facet.

                        Related Links

                        Object Page – Content Area

                        The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                        For design information, see the Object Page Floorplan guidelines and the links below.

                        Warning
                        Always build the object page using the dynamic page header.

                        Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                        Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                        Feature Availability

                         

                        Content Area

                         

                        Availability

                        Draft Object Validation Default

                        Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                        Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                        Navigation Bar: Tab Bar Available
                        Sections and Subsections Available
                        Reuse Components as Sections Available
                         

                        Subsections

                         

                        Availability

                        Link Available

                        With SAP Fiori elements for OData V4, you can display an icon or image with the link.

                        With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                        Smart Link Contact Available, SAP Fiori elements for OData V2 only
                        Tables Available
                        Charts Available
                        Views for Tables and Charts Available
                        Address Available
                        Display of Related Properties Together Available with SAP Fiori elements for OData for V4

                        The properties can also display as links.

                        Forms Available
                        Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

                        You can:

                        • Change the maximum
                        • Enable growing mode
                        • Show users the number of characters allowed in the text area
                        File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                        Dynamic Side Content Available with an extension
                         

                        Subsection Behavior

                         

                        Availability

                        Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                        Adjustment of the Width for Content Display in a Subsection Available
                         

                        Content Visibility

                         

                        Availability

                        Visible Sections, Subsections, Quickviews, and Tables Default
                        Hiding Section, Subsection, Quickview and Table Content Available
                        User-Controlled Visibility with Show More/Show Less Available
                        Visible Smart Form Fields Default, you can hide them in certain conditions.

                        Content Area

                        Draft Object Validation

                        By default, data validation for the object page happens only when the users save the object so they enter data without interruption.

                        They can trigger data validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                        For more information, see: Form Field Validation

                        Navigation Bar

                        By default, the anchor bar is generated when the object page has more than one section.

                        It lets users navigate to the individual content area sections.

                        You can:

                        • Hide the anchor bar when you only have one section.
                        • Replace it with a tab bar.

                        With extensions, you can replace the buttons with another type of control.

                        If there is no Anchor Bar, but there is editable information in the header, the first temporary section in the Object Page which controls the header content will have a section title called ‘Header’.

                        For more information, see:

                        Sections and Subsections

                        You can add sections and subsections to the content area.

                        Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                        For more information, see: Sections and Subsections.

                        Reuse Components as Sections

                        You can embed a reuse component as a section in the object page.

                        Warning
                        A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                        Consult the development team on the requirements for the reuse component.

                        Subsections

                        With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                        The smart link contact can include a contact list and a quickview of the contact details.

                        For more information, see:

                        Tables

                        You can include a table in a subsection.

                        For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                        Charts

                        You can include a single chart facet in a subsection.

                        In the chart, you can:

                        • Display measures, their aggregation calculations, and dimensions to categorize the measures.
                        • Add custom actions to the toolbar for a chart and define whether they are enabled at all times or only after the user selects part of the chart for the action.
                        • Allow users to personalize the chart settings

                        SAP Fiori Elements for OData V2

                        Charts are only supported for business objects or services that are not draft enabled or are read-only.

                        SAP Fiori Elements for OData V4

                        You can define a chart for a draft-enabled business object. The chart only displays active data, not data entered into an unsaved draft record.

                        For more information, see Chart (VizFrame).

                        For more information on chart options, see Chart.

                        Developer Hint
                        For more information, refer application developers to Configuring Charts.

                        Views for Tables and Charts

                        You can turn on views for:

                        • All the tables and charts on the page
                        • Individual tables and charts

                        For more information, see Views (Variant Management).

                        Address

                        You can add one or more address fields:

                        • As a separate subsection
                        • As part of a field group within a subsection
                        • To a quick view with smart link navigation

                        For more information, see:

                        Display of Related Properties Together

                        You can display two related properties side-by-side and with a single label in display mode.

                        For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

                        You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

                        In edit mode, the fields can be edited separately.

                        Side-by-side display of related properties
                        Side-by-side display of related properties

                        Related Properties as Links

                        The related properties can also display as links.

                        Developer Hint
                        Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
                        Related properties as links
                        Related properties as links

                        Forms

                        You can add action buttons to the toolbar for a form contained in a subsection.

                        With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                        The action types can be:

                        • Actions that occur in the system while the user stays on the object page.
                        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                        Conditional Enablement of Navigation Buttons

                        You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                        Guidelines
                        Implement this feature only when the way to enable the button is obvious to end users.

                        Columns in a Form

                        To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                         

                        Column Number

                        Screen Size

                        1 Small
                        2 Medium
                        3 Large
                        6 Extra large
                        Guidelines
                        The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                        Groups in a Form

                        You can group fields in a form and assign a name to the group.

                        Note that the group name is displayed only when a group contains fields.

                        User-Controlled Load of Fields with Low Importance

                        To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                        After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                        Text Control

                        By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                        You can:

                        • Set a maximum number of lines for the text control that’s greater than four.
                        • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
                        • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

                        A notification is displayed if the users try to enter text beyond the limit.

                        In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                        File Upload

                        With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                        For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                        The application developers can define the file size and types allowed for upload.

                        Dynamic Side Content

                        You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                        With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                          Guidelines

                          • Do not use tables in the side content panel.
                          • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                          • For the best view of the dynamic side content, set it to display in 50% of the screen.

                          For more information, see:

                          Developer Hint

                          Subsection Behavior

                          Subsection Loading Behavior

                          By default, the subsection starts loading after the main object page elements are loaded.

                          You can change the loading behavior to load the subsection after the header data is loaded.

                          Example

                          When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                          Width for Content Display in a Subsection

                          When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                          Content Visibility

                          Sections, Subsections, Quickviews, and Tables

                          By default, the object page displays these components.

                          You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                          User-Controlled Visibility

                          You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                          • When the subsection is hidden, Show More is displayed.
                          • When the subsection shows, the Show Less link is displayed.

                          Visibility of Smart Form Fields

                          By default, all smart form fields have the high importance setting and show on all screen sizes.

                          You can lower the level of importance for the fields to hide them on smaller screens.

                          According to the importance assigned to the field, it is displayed as follows:

                          • High (default): On all (small, medium, and large) screen sizes.
                          • Medium: On large and medium screens only.
                          • Low: On large screens only

                          For more information, see Responsiveness.

                          Related Links

                          Table Toolbar

                          The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

                          For design information, see the guidelines starting with Table Overview, and see the links below.

                          Feature Availability

                           

                          List Report and Object Page Features

                           

                          Availability

                          Title Visible by default.

                          You can  hide it.

                          You can show the table row count next to the title.

                          Infobar Default for all table types, the infobar summarizes the filter criteria applied to the table data. It is displayed below the table toolbar and above the column headings when at least one filter is set.
                          Table Personalization Actions Default, you can turn them off.
                          Application-Specific Actions Available
                          Mass Edit Available in draft-enabled applications:

                          • In both the list report and object page with SAP Fiori elements for OData V4
                          • In the list report with SAP Fiori elements for OData V2
                          Show/Hide Details Available in responsive tables
                          Order of Toolbar Actions With SAP Fiori elements for OData V4, you can order the toolbar actions according to their importance, starting with the most frequently-used action and ending with the most seldom-used action, regardless of whether the action is a custom or standard one.
                          Actions Disabled Before Row Selection Available
                          Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                          Requires an extension with SAP Fiori elements for OData V2

                          Messages for Critical Actions Available
                          Messages for Destructive Actions Available
                          Multiple Views on a Table Available
                           

                          List Report Only Features

                           

                          Availability

                          Toolbar Sticky Behavior Default, you can turn it off.
                          Standard ActionsCreateDelete, and Export to Spreadsheet Default, you can turn them off.
                          Object Creation via an Object Page Default, you can change it.
                          Object Creation via a Dialog Available in certain conditions
                          Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
                          Copy Available

                          You determine the label on the action button.

                          Hiding Actions in Multiple Content Layout Available
                          Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
                          Add Card to Insights Default when My Home in SAP S/4HANA Cloud is enabled.

                          You can turn it off.

                           

                          Object Page Only Features

                           

                          Availability

                          Search Available, when the data allows it.
                          Edit Default, when the data allows it.
                          Delete Default, when the data allows it.
                          Subobject Creation via Subobject Page Default, you can change it.
                          Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
                          Create Not Visible In certain conditions
                          Inline Creation Available, in draft-enabled applications for grid and responsive tables
                          Prefilling Fields for New Object Creation Available, in draft-enabled applications
                          Selection of Cell Range and Copy to Clipboard Available
                          Copy and Paste from Microsoft Excel Available, in draft-enabled applications for grid and responsive tables, in certain conditions
                          Export to Spreadsheet With SAP Fiori elements for OData V4:

                          • Available
                          • Default, when the copy and paste from Microsoft Excel feature is enabled
                          Export to PDF Available with SAP Fiori elements for OData V4
                          Full Screen Mode for Table Display Available, not recommended
                          Segmented Button for Switching Table Views Default for a table with a maximum of three views
                          Select Control for Switching Table Views Default for a table with four or more views

                          List Report and Object Page Features

                          The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


                          Table Personalization Actions

                          By default, Sort, Group and Order actions are enabled.

                          These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

                          For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

                          Table-level view management is not a prerequisite for personalization.

                          For more information, see Table Personalization (Overview).



                          Application-Specific Actions

                          You can define these actions and the text displayed on the buttons.

                          The application team can control when the action button is displayed and enabled.

                          For application-specific actions, application teams can define custom keyboard shortcuts.

                          For more information, see:

                          Developer Hint

                          For more information on shortcuts, refer application developers to Keyboard Shortcuts.


                          Mass Edit

                          You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

                          • List report and object page with SAP Fiori elements for OData V4
                          • List report with SAP Fiori elements for OData V2

                          List Report

                          Users cannot apply the mass edit to a draft record.

                          The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

                          By default, the Edit dialog contains all the table columns that are currently visible and editable.

                          Object Page

                          When it’s enabled for a table in the object page and the object page is in edit mode, users can apply the mass edit to subobjects.

                          For more information, see Mass Edit.

                          Developer Hint
                          For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


                          Show / Hide Details

                          The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

                          After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

                          The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                          • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                          • The values in columns with low importance are first to be hidden.

                          By default in responsive tables:

                          • Key fields have the importance set to high in list reports.
                          • Other columns have the importance set to none and are handled like columns assigned medium importance.

                          You can change the level of importance.


                          Actions Disabled Until the User Selects a Row

                          You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

                          Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

                          For more information, see UI Element States.


                          Conditional Enablement of Navigation Buttons

                          With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                          With SAP Fiori elements for OData V2, this feature requires extensions.

                          For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                          Guidelines
                          Implement this feature only when the way to enable the button is obvious to end users.

                          Messages for Critical Actions

                          For actions that you set as critical, you can display one of the following after the user triggers the action:

                          • A message toast confirmation
                          • A confirmation message box to ensure the user wants to proceed with specific critical actions

                          Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                          Guidelines

                          Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                          Ask the development team whether or not the backend requires confirmations for your use case.

                          Example


                          SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                          Default Text                          “Do you really want to execute the action <Action Label>?”

                          <Action Label> is the label shown on the button.

                          “Do you really want to perform this action?
                          Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


                          Messages for Destructive Actions

                          By default, a message is displayed for confirmation of an action that will delete or destroy important data.

                          Guidelines

                          Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                          Ask the development team whether or not the backend requires confirmations for your use case.

                          Example


                          SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                          Default Text The default message reuses the title and the description defined for the object in the table.

                          • In flexible column layout: Delete object <title> <description>?

                            For example, “Delete object 12345 (Sales Order)?”

                          • In full screen mode: Delete object <title>?

                            For example, “Delete object 12345?”

                          “Do you really want to perform this action?
                          Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


                          Multiple Views for a Table

                          You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

                          For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

                          With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

                          List Report Only Features

                          The information below relates only to table toolbar actions and settings in the list report floorplan.


                          Standard Actions

                          By default, Create, Delete, and Export to Spreadsheet are enabled.

                          You can disable them.

                          You can also enable or disable the Delete button based on conditions specified in the backend.

                          Example

                          You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

                          Warning
                          In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

                          Create Object Actions

                          By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

                          Via a Dialog

                          The action opens a dialog in modal view so the user can enter the data.

                          With SAP Fiori elements for OData V2, you can:

                          • Include a maximum of eight fields in the dialog
                          • Enable filter values saved in the filter bar to prefill fields in the dialog
                          Warning
                          When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

                          Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

                          With Default Values That Prefill Fields for the New Object

                          This feature is available with:

                          • SAP Fiori elements for OData V2 for applications without draft handling
                          • SAP Fiori elements for OData V4

                          Via a Dialog with a Reference to an Existing Object of the Same Type

                          With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

                          The user:

                          1. Clicks the action button.
                            You can name the button to suit your use case.
                          2. Selects the value of the existing object to reference in the dialog.
                          3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
                          4. Completes additional fields for the new object in the object page.
                          Create from existing object
                          Create from existing object
                          Developer Hint
                          For more information, refer application developers to:

                          Copy

                          You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the current object.

                          You set the label for the button according to your use case. Otherwise, the default label is Copy.

                          In the toolbar, the Copy button is displayed after the Create button.

                          Developer Hint
                          Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

                          Hiding Actions in Multiple Content Layout

                          You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

                          For more information, see:


                          Add Card to Insights

                          By default, the Add Card to Insights option is displayed in the overflow toolbar of list report tables with the single content layouts when My Home in SAP S/4HANA Cloud is enabled.

                          You can ask the application development team to turn the option off.

                          For more information, see: Simple Content Layout.


                          Developer Hint
                          For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.

                          Object Page Only Features

                          The information below relates only to table toolbar actions and settings in the object page floorplan.


                          Search

                          You can enable a search on the table.

                          For more information, see Search.


                          Edit

                          By default, Edit is displayed when the business object shown in the table is editable.


                          Delete

                          By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

                          You can enable or disable the Delete action to allow users to delete only in certain conditions.

                          For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

                          When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

                          Warning
                          In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

                          Subobject Creation

                          By default:

                          • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
                          • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

                          You can:

                          • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
                          • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
                          • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
                          • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
                          Guidelines
                          Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

                          For more information, see:


                          Create Action Visibility

                          Whether or not the Create action is visible in the table toolbar depends on:

                          • The object page mode.
                          • Whether the flow is global or local.
                          • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

                           

                          Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

                          Global Flow for Draft-Enabled

                          Applications with Fiori Elements for OData V2

                          • Navigation indicators   are visible (if required).
                          • Create button is not visible.
                          • Navigation indicators   are visible (if required).
                          • Create button is visible.
                          • Navigation indicators   are visible (if required).
                          • Create button is visible.

                          Local Flow for Non-Draft Enabled Applications

                          • Navigation indicators   are visible (if required).
                          • Create button is visible.
                          • Navigation indicators   are not visible.
                          • Create button is not visible.
                          Not Supported.

                          Inline Creation

                          You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

                          The inline creation adds a new row to the table where the users can enter the subobject data.

                          By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

                          You can:

                          • Work with the development team to define a custom sort order.
                          • Enable default values to prefill the fields for the new object.

                          For more information, see Add Items.


                          Prefilling Fields for a New Object

                          You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

                          The new object must be the main object on the object page.

                          You determine both the fields to prefill and the default values for the fields.


                          Selection of Cell Range and Copy to Clipboard

                          The copy action applies to:

                          • Multiple rows for all tables
                          • A range of selected cells for all tables except the responsive table

                          Users can select a range of cells:

                            • With their mouse, by clicking and holding the mouse button while they select the cells
                            • With the key combinations, described in Shortcut Key Combinations
                          Warning
                          The copy function doesn’t separate the content for cells that combine, for example, both an amount with a currency or both a value and its description so users need to adjust this information before they paste it into another SAP Fiori elements table.
                          Developer Hint
                          For more information on the keyboard shortcuts for copying multiple rows and ranges, refer application developers to Tables.

                          Copy and Paste from Microsoft Excel

                          By default, the table toolbar for responsive and grid tables displays Paste when the following are enabled:

                          • Draft-handling for the application.
                          • Inline creation for the object page table.

                          After users copy data from a spreadsheet, they can place the focus anywhere in the table except for the cells and trigger the browser paste with the keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

                          Limitations

                          • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
                          • If there are validation errors, a dialog displays an error message so the user can take remedial action.
                          • The greater the number of records copied, the longer the paste operation takes.
                          • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
                          • Users cannot paste data into custom columns of tables.
                          • This feature is not supported for custom tables.

                          Export to Spreadsheet

                          By default, Export to Spreadsheet is enabled with the copy and paste from spreadsheet feature above.

                          You can enable the button independently of the copy and paste from Microsoft Excel.

                          The Export to Spreadsheet button allows user to export the values in the table, including values in custom columns.

                          For more information see Export to Spreadsheet.


                          Full Screen Mode for Table Display

                          You can enable full screen mode for a table. However, it is generally not recommended.

                          Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

                          For more information on the restrictions for this feature, see Maximize/Minimize.


                          Content Switch for Table Views

                          The number of views defined for a table determines the UI control that lets users switch the table views:

                          By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

                          Related Links

                          List Report – Content Area

                          The SAP Fiori elements list report template supports the three content area layouts detailed below.

                          For design information, see General Layout and the links below.

                          Simple Content Layout

                          The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                          • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                          • Automatic data loading
                          • One table toolbar
                          • Creation of business objects via a dialog
                          • Creation of cards for the Insights section of My Home in SAP S/4HANA Cloud, when My Home in SAP S/4HANA Cloud has been enabled. The Add Card to Insights option automatically appears in the overflow toolbar of the table in list report. You can turn off this feature.
                          Warning

                          • We strongly recommend against table-level view management, but it is supported.
                          • With SAP Fiori elements for OData V4 these restrictions apply for the Insights cards:

                            • After the creation of a card from the list report table, when users navigate from the card in the Insights section of My Home to the list report table, the table does  not retain removed filter fields or table columns and changes in the position of filter fields or table columns

                            • Insights cards don’t have the same formatting for unit of measure fields as shown in the list report table.

                          Developer Hint
                          For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.
                          Simple content layout (default)
                          Simple content layout (default)

                          Multiple View Layout

                          For more complex scenarios, you can turn on the multiple view layout which supports: 

                          • Display of multiple views of a table that shows one business object, for example, each view of the same table can display different prefiltered states
                          • The segmented button for a maximum of three views or the select control for four or more views
                            Note that the SAP Fiori elements framework determines the switch control automatically based on the number of views.
                          • Display of the count or number of total rows in the view (must be enabled)
                          • One table toolbar
                          • Automatic data loading
                          • Creation of business objects via a dialog with SAP Fiori elements for OData V2
                          • Creation of cards for the Insights section of My Home in SAP S/4HANA Cloud, by default when My Home in SAP S/4HANA Cloud has been enabled. You can turn off this feature.
                          Warning

                          • We strongly recommend against table-level view management, but it is supported.
                          • With SAP Fiori elements for OData V4 these restrictions apply for the Insights cards:

                            • After the creation of a card from the list report table, when users navigate from the card in the Insights section of My Home to the list report table, the table does  not retain removed filter fields or table columns and changes in the position of filter fields or table columns

                            • Insights cards don’t have the same formatting for unit of measure fields as shown in the list report table.

                          Developer Hint
                          For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.
                          Multiple view layout - Segmented button
                          Multiple view layout - Segmented button
                          Muliple view layout - Select control
                          Muliple view layout - Select control

                          Multiple Content Layout

                          To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                          • Display of one or more business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can be filtered by a specific customer and a specific date
                          • Text-only icon tab bar to switch among the tabs
                          • Views with data visualization in either table or chart format with both SAP Fiori elements for OData V2 and V4
                          • Automatic data loading
                          • Different toolbars for each view
                          Warning

                          • We strongly recommend against table-level or chart-level view management, but it is supported.
                          • Creation of business objects must be done in an object page. Doing it via a dialog is not supported
                          • Do not use a mix of responsive and non-responsive tables.

                          Developer Hint
                          Application developers may be unfamiliar with the designer term “multiple content layout.”

                          For more information on implementing this feature, refer the development team to:

                          Multiple content layout
                          Multiple content layout

                          Related Links

                          Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                          Table Features

                          The SAP Fiori elements templates support the features and settings for a table detailed below.

                          For design information see the table guidelines, starting with Table Overview, and the links within this article.

                          Feature Availability

                           

                          Table Settings

                           

                          Availability

                          Column Heading Labels You set these.
                          Asterisk in Labels for Mandatory Fields In the object page, by default, a red asterisk (*) displays in the column header label for mandatory table fields with SAP Fiori elements for OData V4.
                          Tooltips on Column Headers Default
                          Clear All When the selection of multiple rows is enabled, the Clear All  checkbox is displayed by default in both the list report and object page for:

                          • Grid tables
                          • Analytical tables
                          • Tree tables

                          You can change the default

                          Select All When the selection of multiple rows is enabled for a responsive table in an object page, the Select All  checkbox is displayed by default.

                          You can change the default.

                          Sticky Column Header Behavior Default, you can turn it off.
                          Column Width The default width depends on the column contents. You can change it.
                          Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                          You can change the level of importance.

                          Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                          Ascending Sort Order on a Column Default, you can change it.
                          Grouping Available in responsive and analytical tables
                          Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                          No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                          Message Strip above the Table You can display a custom message above the table in the:

                          • List report, object page, and analytical page with SAP Fiori elements for OData V2
                          • List report with SAP Fiori elements for OData V4

                          In the object page, by default, a message strip is displayed when there are errors in the table.

                          When there are multiple messages, the one with the highest severity is displayed.

                           

                          List Report and Analytical Page Only

                           

                          Availability

                          Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                           

                          Object Page Only

                           

                          Availability

                          Message Strip for Rows with Errors Default
                          Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

                          • Anchor bar navigation and a single section that contains only a grid table
                          • Tab bar navigation and a current tab that contains only a grid table

                          Table Settings


                          Tooltips on Column Headers

                          On desktop applications, all table columns display tooltips, based on the text in:

                          • Common.QuickInfo, when it’s visible
                          • The column label, in all other cases

                          Tooltips are available only in desktop applications because users must hover their mouse on the column header to see them.


                          Clear All / Select All

                          When the selection of multiple rows is enabled for a table in the list report and object page, the Clear All checkbox is displayed by default in the selection column header for all tables, but the responsive table. You can change the default.

                          Information
                          To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

                           Table Type

                          Selection Default

                          Users Can Select

                          Grid table

                          Analytical table

                          Tree table

                          Clear All   Up to 200 rows by default

                          We recommend you consult the application development team on how changes to the limit would impact performance.

                          Responsive table Select All   All the rows displayed on the interface, not all the rows in the table.

                          A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

                          Warning
                          For grid tables, analytical tables, and tree tables, changing the default Clear All checkbox to the Select All  checkbox can lead to performance issues because Select All   loads all the table rows to the frontend.

                          Always ask the application development team about the impact on performance before you consider such a change.

                          Guidelines
                          When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                          Column Width

                          The default column width varies according to the column contents:

                          • Text: can range from 3 to 20 rem
                          • Image: 5 rem
                          • Rating or progress indicator: 6.875 rem
                          • Chart: 20 rem

                          You can can change the width.

                          With SAP Fiori elements for OData V4, you can also ask the application developers to ensure the column width is adjusted to both the contents of the column and the column header.

                          Developer Hint
                          For more information, refer the development team to Setting the Default Column Width.

                          Column Importance in Responsive Tables

                          By default:

                          • Key fields have high importance in list reports.
                          • Other columns have the importance of none and are handled like columns assigned medium importance.

                          You can change the level of importance.

                          The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                          • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                          • The values in columns with low importance are first to be hidden.

                          When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                          You can also assign an importance to custom columns.

                          For more information, see:


                          Freezing Columns

                          You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

                          Developer Hint
                          For more information, refer application developers to Tables.

                          Labels for Multiple Fields in a Column

                          By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                          You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                          Sort Order

                          By default, the sort order for a column is ascending.

                          You can:

                          • Set the default sort order to descending.
                          • Define other, customized sort orders.

                          For more information, see the sort guidelines according to table type:


                          Number of Table Rows Displayed at Once

                          By default, a responsive table loads the following number of rows at once:

                          • 20 rows in a list report.
                          • 10 rows in an object page with multiple sections.

                          When more rows exist, the users can click the More button at the end of the table to view additional rows.

                          With SAP Fiori elements for OData V2, you can change the default number.

                          For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                          Guidelines
                          Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                          Grouping

                          Grouping is available in responsive and analytical tables.

                          You can define the format of the grouping headers.

                          For more information, see:



                          No Data Found Text

                          By default, the following text is displayed when no data is found.

                          • When the user has not applied filters, the text is “No data found.”
                          • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                          Guidelines
                          Replace the generic text with text that’s meaningful to the user.

                          List Report and Analytical Page Only

                          Initial Expansion of Table Levels

                          By default, on initial load, the following expandable tables are expanded to this number of levels:

                          • Responsive table: 1 level
                          • Tree table: 1 level
                          • Analytical table: 0 levels

                          You can change the default value for the tree table and analytical tables.

                          Developer Hint
                          For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                          Object Page Only

                          Message Strip for Rows with Errors

                          When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                          Related Links

                          Table Rows

                          The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                          For design information see the table guidelines, starting with Table Overview, and the links below.

                          Feature Availability

                             
                           

                          Actions

                           

                          Availability

                          Inline Actions Available
                          Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                          Conditional Enablement of Navigation Buttons For list report and object pages:

                          • Available with SAP Fiori elements for OData V4
                          • Requires an extension with SAP Fiori elements for OData V2
                          Single Item Selection Default
                          Multiple Item Selection Available
                          Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                          Delete Available in responsive tables only
                          Custom Actions Available
                          Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                           

                          Display

                           

                          Availability

                          Empty Row for Data Entry Available for responsive and grid tables in an object page in create and edit modes
                          Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                          Editing Status For draft-enabled applications, displayed by default in a responsive table in a list report
                          Rating Indicator Available
                          Progress Indicator Available
                          Quick Contact View Available
                          Avatar Available
                          Avatar Tooltip Available
                          Other Images Available with live box mode only
                          Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                          In edit mode, the multiple values are displayed, but not editable.

                          The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                          Highlighting New Line Items Available with SAP Fiori elements for OData V2

                          Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                          Highlighting Line Items Based on Criticality Available
                           

                          Responsive Table Only

                           

                          Availability

                          Multiple Fields in a Single Column Available
                          Smart Micro Chart Available

                          Actions

                          Inline Actions

                          You can define actions for table rows or inline items. The action types can be:

                          • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                          • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                          When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                          Direct Edit

                          You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                          This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                          Conditional Enablement of Navigation Buttons

                          In list reports and object pages:

                          • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                          • With SAP Fiori elements for OData V2, this feature requires extensions.

                          For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                          Guidelines
                          Implement this feature only when the way to enable the button is obvious to end users.

                          Item Selection

                          Both versions of SAP Fiori elements allow you to determine whether users can select:

                          • One table row for a toolbar action, using a radio button.
                          • Multiple table rows for a toolbar action, using checkboxes.
                            For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                            For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                          When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                          • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                            For complete information, see: Select All / Clear All.
                          • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                            You can change the limit. We recommend you consult the application team on how a change would impact performance.

                          SAP Fiori elements for OData V2

                          By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                          SAP Fiori elements for OData V4

                          With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                          • In display mode, item selection is not possible.
                          • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                          Instead, you can enable one of the following selection modes:

                          • None:
                            • Display mode allows no item selection.
                            • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                          • Single: Both display and edit modes allow single item selection.
                          • Multi: Both display and edit modes allow multiple item selection.
                          Warning
                          When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                          Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                          For more information, see:

                          Developer Hint
                          For more information, refer the development team to:


                          Delete

                          In responsive tables only, you can:

                          • Display an inline delete action.
                          • Prevent the deletion of certain rows.

                          In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                          For more information, see Delete Single Item Rows.


                          Custom Actions

                          You can define custom inline actions.

                          Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                          Messages for Critical Actions

                          For actions that you set as critical, you can display one of the following after the user triggers the action:

                          • A message toast confirmation
                          • A confirmation message box to check the users want to proceed with specific critical actions

                          Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                          Guidelines
                          Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                          Ask the development team whether or not the backend requires confirmations for your use case.

                          Example


                          SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                          Default Text “Do you really want to execute the action <Action Label>?”

                          <Action Label> is the label shown on the button.

                          “Do you really want to perform this action?
                          Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                          For more information, see UI Text Guidelines for SAP Fiori Apps.


                          Display

                          You can include the display features described below in a table row or inline item.


                          Empty Row for Data Entry

                          With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display one empty row where the users can enter data for a new subobject.

                          The empty row:

                          • Is displayed at the top of the responsive table.
                            The toolbar has no Create button.
                          • Is displayed at the end of a grid table.
                            The Create button in the toolbar scrolls to the empty row at the end of the table and puts the focus on the first editable field.
                          • Has no inline actions such as delete or navigation to the item via the chevron.
                          • Cannot be sorted or grouped because it doesn’t exist in the table on the back end.
                          An empty row is displayed in the responsive table in create or edit mode
                          An empty row is displayed in the responsive table in create or edit mode

                          Automatic Creation of a New Empty Row

                          After users start to enter data in one field in the empty row:

                          • A new empty row is added underneath it so they can continue data entry for either one column or one row at a time.
                          • The row with data in one field:
                            • Is highlighted with a blue line to its left to show it’s a newly created draft
                            • Displays the navigation chevron
                            • Can also display an inline delete action
                          After the user starts entering data in the empty row, a new one is displayed
                          After the user starts entering data in the empty row, a new one is displayed

                          You can:

                          • Set default values to populate fields in the empty rows
                          • Enable the feature at the table level in draft-enabled applications
                          • Disable fields in the empty row so they are read-only at creation time and become editable afterwards for use cases where certain fields become relevant only after creation, with SAP Fiori elements for OData V4

                          Read-Only Field

                          With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                          Editing Status

                          By default, for draft-enabled applications, a responsive table in a list report displays the editing status in the first column.

                          You can also add the semantic key to the status.

                          The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                          • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                          • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                          For more information, see Tables.


                          Rating Indicator

                          You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                          The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                          With extensions, you can enable editing of the rating indicator

                          For more information, see Rating Indicator.


                          Progress Indicator

                          You can:

                          • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                          • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                          • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                          For more information, see Progress Indicator.


                          Quick Contact View

                          You can add a quick view to a contact to display key contact details in a popover.

                          For more information, see Quickview.


                          Avatar and Other Images

                          You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                          Warning
                          Other images are not displayed correctly within the table borders. Only use them with live box mode.

                          For more information, see Avatar.


                          Highlighting Line Items

                          By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                          Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                          You can also define highlighting and icons for line items based on their criticality.

                          After a newly created item is saved, it is highlighted according to the criticality, as follows:

                          • Green for success (criticality value 3)
                          • Yellow for warning (criticality value 2)
                          • Red for error (criticality value 1)
                          • No highlighting for no criticality (criticality value 0)

                          Display in Responsive Table Only

                          In a responsive table, you can include the display features described below in a table row or inline item.


                          Multiple Fields in a Single Column

                          You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                          For example, you can display the following in a single column:

                          • Company name
                          • Company ID
                          • Items in Stock
                          • Progress Indicator for Items in Stock
                          • Overall value of the Items
                          • Multiple Action buttons that allow the user to both:
                            • Execute an action while staying on the list report page
                            • Navigate to other objects and applications

                          The visibility and position in the table of a column that combines multiple fields can be changed.

                          Field Labels

                          By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                          You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                          Limitation on Export to Spreadsheet

                          When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                          Information

                          Write a short and meaningful message.


                          Smart Micro Chart

                          You can:

                          • Add an inline micro chart.
                          • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                          You can choose among the following micro chart types:

                          • Area micro chart
                          • Bullet micro chart
                          • Line micro chart
                          • Micro chart/smart micro chart
                          • Radial micro chart
                          • Stacked bar micro chart
                          Warning
                          The user cannot navigate to another page from the chart.

                          For more information on chart types, see: Choosing the Correct Chart Type.

                          Related Links

                          Table Toolbar

                          The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

                          For design information, see the guidelines starting with Table Overview, and see the links below.

                          Feature Availability

                           

                           

                          List Report and Object Page Features

                           

                          Availability

                          Title Visible by default

                          You can  hide it.

                          With SAP Fiori elements for OData V4, you can show the table row count next to the title.

                          Table Personalization Actions Default, you can turn them off.
                          Application-Specific Actions Available
                          Mass Edit Available in draft-enabled applications:

                          • In both the list report and object page with SAP Fiori elements for OData V4
                          • In the list report with SAP Fiori elements for OData V2
                          Show/Hide Details Available in responsive tables
                          Order of Toolbar Actions With SAP Fiori elements for OData V4, you can order the toolbar actions according to their importance, starting with the most frequently-used action and ending with the most seldom-used action, regardless of whether the action is a custom or standard one.
                          Actions Disabled Before Row Selection Available
                          Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                          Requires an extension with SAP Fiori elements for OData V2

                          Messages for Critical Actions Available
                          Messages for Destructive Actions Available
                          Multiple Views on a Table Available
                           

                          List Report Only Features

                           

                          Availability

                          Toolbar Sticky Behavior Default, you can turn it off.
                          Standard ActionsCreateDelete, and Export to Spreadsheet Default, you can turn them off.
                          Object Creation via an Object Page Default, you can change it.
                          Object Creation via a Dialog Available in certain conditions
                          Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
                          Copy Available

                          You determine the label on the action button.

                          Hiding Actions in Multiple Content Layout Available
                          Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
                          Add Card to Insights Default when My Home in SAP S/4HANA Cloud is enabled.

                          You can turn it off.

                           

                          Object Page Only Features

                           

                          Availability

                          Search Available, when the data allows it.
                          Edit Default, when the data allows it.
                          Delete Default, when the data allows it.
                          Subobject Creation via Subobject Page Default, you can change it.
                          Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
                          Create Not Visible In certain conditions
                          Inline Creation Available, in draft-enabled applications for grid and responsive tables
                          Prefilling Fields for New Object Creation Available, in draft-enabled applications
                          Copy and Paste from Microsoft Excel Available, in draft-enabled applications for grid and responsive tables, in certain conditions
                          Export to Spreadsheet With SAP Fiori elements for OData V4:

                          • Available
                          • Default, when the copy and paste from Microsoft Excel feature is enabled
                          Export to PDF Available with SAP Fiori elements for OData V4
                          Full Screen Mode for Table Display Available, not recommended
                          Segmented Button for Switching Table Views Default for a table with a maximum of three views
                          Select Control for Switching Table Views Default for a table with four or more views

                          List Report and Object Page Features

                          The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


                          Table Personalization Actions

                          By default, Sort, Group and Order actions are enabled.

                          These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

                          For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

                          Table-level view management is not a prerequisite for personalization.

                          For more information, see Table Personalization (Overview).



                          Application-Specific Actions

                          You can define these actions and the text displayed on the buttons.

                          The application team can control when the action button is displayed and enabled.

                          For application-specific actions, application teams can define custom keyboard shortcuts.

                          For more information, see:

                          Developer Hint

                          For more information on shortcuts, refer application developers to Keyboard Shortcuts.


                          Mass Edit

                          You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

                          • List report and object page with SAP Fiori elements for OData V4
                          • List report with SAP Fiori elements for OData V2

                          List Report

                          Users cannot apply the mass edit to a draft record.

                          The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

                          By default, the Edit dialog contains all the table columns that are currently visible and editable.

                          Object Page

                          When it’s enabled for a table in the object page and the object page is in edit mode, users can apply the mass edit to subobjects.

                          For more information, see Mass Edit.

                          Developer Hint
                          For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


                          Show / Hide Details

                          The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

                          After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

                          The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                          • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                          • The values in columns with low importance are first to be hidden.

                          By default in responsive tables:

                          • Key fields have the importance set to high in list reports.
                          • Other columns have the importance set to none and are handled like columns assigned medium importance.

                          You can change the level of importance.


                          Actions Disabled Until the User Selects a Row

                          You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

                          Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

                          For more information, see UI Element States.


                          Conditional Enablement of Navigation Buttons

                          With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                          With SAP Fiori elements for OData V2, this feature requires extensions.

                          For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                          Guidelines
                          Implement this feature only when the way to enable the button is obvious to end users.

                          Messages for Critical Actions

                          For actions that you set as critical, you can display one of the following after the user triggers the action:

                          • A message toast confirmation
                          • A confirmation message box to ensure the user wants to proceed with specific critical actions

                          Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                          Guidelines

                          Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                          Ask the development team whether or not the backend requires confirmations for your use case.

                          Example


                          SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                          Default Text                          “Do you really want to execute the action <Action Label>?”

                          <Action Label> is the label shown on the button.

                          “Do you really want to perform this action?
                          Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


                          Messages for Destructive Actions

                          By default, a message is displayed for confirmation of an action that will delete or destroy important data.

                          Guidelines

                          Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                          Ask the development team whether or not the backend requires confirmations for your use case.

                          Example


                          SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                          Default Text The default message reuses the title and the description defined for the object in the table.

                          • In flexible column layout: Delete object <title> <description>?

                            For example, “Delete object 12345 (Sales Order)?”

                          • In full screen mode: Delete object <title>?

                            For example, “Delete object 12345?”

                          “Do you really want to perform this action?
                          Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


                          Multiple Views for a Table

                          You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

                          For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

                          With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

                          List Report Only Features

                          The information below relates only to table toolbar actions and settings in the list report floorplan.


                          Standard Actions

                          By default, Create, Delete, and Export to Spreadsheet are enabled.

                          You can disable them.

                          You can also enable or disable the Delete button based on conditions specified in the backend.

                          Example

                          You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

                          Warning
                          In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

                          Create Object Actions

                          By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

                          Via a Dialog

                          The action opens a dialog in modal view so the user can enter the data.

                          With SAP Fiori elements for OData V2, you can:

                          • Include a maximum of eight fields in the dialog
                          • Enable filter values saved in the filter bar to prefill fields in the dialog
                          Warning
                          When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

                          Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

                          With Default Values That Prefill Fields for the New Object

                          This feature is available with:

                          • SAP Fiori elements for OData V2 for applications without draft handling
                          • SAP Fiori elements for OData V4

                          Via a Dialog with a Reference to an Existing Object of the Same Type

                          With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

                          The user:

                          1. Clicks the action button.
                            You can name the button to suit your use case.
                          2. Selects the value of the existing object to reference in the dialog.
                          3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
                          4. Completes additional fields for the new object in the object page.
                          Create from existing object
                          Create from existing object
                          Developer Hint
                          For more information, refer application developers to:

                          Copy

                          You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the current object.

                          You set the label for the button according to your use case. Otherwise, the default label is Copy.

                          In the toolbar, the Copy button is displayed after the Create button.

                          Developer Hint
                          Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

                          Hiding Actions in Multiple Content Layout

                          You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

                          For more information, see:


                          Add Card to Insights

                          By default, the Add Card to Insights option appears in the overflow toolbar of list report tables with the single content and multiple view layouts when My Home in SAP S/4HANA Cloud is enabled.

                          You can ask the application development team to turn the option off.

                          For more information, see:


                          Developer Hint
                          For more information on card creation and disabling it, refer application developers to Creating Cards for the Insights Section of My Home in SAP S/4HANA Cloud.

                          Object Page Only Features

                          The information below relates only to table toolbar actions and settings in the object page floorplan.


                          Search

                          You can enable a search on the table.

                          For more information, see Search.


                          Edit

                          By default, Edit is displayed when the business object shown in the table is editable.


                          Delete

                          By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

                          You can enable or disable the Delete action to allow users to delete only in certain conditions.

                          For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

                          When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

                          Warning
                          In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

                          Subobject Creation

                          By default:

                          • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
                          • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

                          You can:

                          • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
                          • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
                          • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
                          • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
                          Guidelines
                          Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

                          For more information, see:


                          Create Action Visibility

                          Whether or not the Create action is visible in the table toolbar depends on:

                          • The object page mode.
                          • Whether the flow is global or local.
                          • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

                           

                          Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

                          Global Flow for Draft-Enabled

                          Applications with Fiori Elements for OData V2

                          • Navigation indicators   are visible (if required).
                          • Create button is not visible.
                          • Navigation indicators   are visible (if required).
                          • Create button is visible.
                          • Navigation indicators   are visible (if required).
                          • Create button is visible.

                          Local Flow for Non-Draft Enabled Applications

                          • Navigation indicators   are visible (if required).
                          • Create button is visible.
                          • Navigation indicators   are not visible.
                          • Create button is not visible.
                          Not Supported.

                          Inline Creation

                          You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

                          The inline creation adds a new row to the table where the users can enter the subobject data.

                          By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

                          You can:

                          • Work with the development team to define a custom sort order.
                          • Enable default values to prefill the fields for the new object.

                          For more information, see Add Items.


                          Prefilling Fields for a New Object

                          You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

                          The new object must be the main object on the object page.

                          You determine both the fields to prefill and the default values for the fields.


                          Copy and Paste from Microsoft Excel

                          By default, the table toolbar for responsive and grid tables displays Paste when the following are enabled:

                          • Draft-handling for the application.
                          • Inline creation for the object page table.

                          After users copy data from a spreadsheet, they can place the focus anywhere in the table except for the cells and trigger the browser paste with the keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

                          Limitations

                          • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
                          • If there are validation errors, a dialog displays an error message so the user can take remedial action.
                          • The greater the number of records copied, the longer the paste operation takes.
                          • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
                          • Users cannot paste data into custom columns of tables.
                          • This feature is not supported for custom tables.

                          Export to Spreadsheet

                          By default, Export to Spreadsheet is enabled with the copy and paste from spreadsheet feature above.

                          You can enable the button independently of the copy and paste from Microsoft Excel.

                          The Export to Spreadsheet button allows user to export the values in the table, including values in custom columns.

                          For more information see Export to Spreadsheet.


                          Full Screen Mode for Table Display

                          You can enable full screen mode for a table. However, it is generally not recommended.

                          Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

                          For more information on the restrictions for this feature, see Maximize/Minimize.


                          Content Switch for Table Views

                          The number of views defined for a table determines the UI control that lets users switch the table views:

                          By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

                          Related Links

                          Table Features

                          The SAP Fiori elements templates support the features and settings for a table detailed below.

                          For design information see the table guidelines, starting with Table Overview, and the links within this article.

                          Feature Availability

                           

                          Table Settings

                           

                          Availability

                          Column Heading Labels You set these.
                          Tooltips on Column Headers Default
                          Clear All When the selection of multiple rows is enabled, the Clear All  checkbox is displayed by default for:

                          • Grid tables, analytical tables and tree tables in both list reports and object pages
                          • Responsive tables in a list report with SAP Fiori elements for OData V2

                          You can change the default options.

                          Select All With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table in an object page, the Select All  checkbox is displayed by default.

                          You can change the default.

                          Sticky Column Header Behavior Default, you can turn it off.
                          Column Width The default width depends on the column contents. You can change it.
                          Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                          You can change the level of importance.

                          Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                          Ascending Sort Order on a Column Default, you can change it.
                          Grouping Available in responsive and analytical tables
                          Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                          No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                          Message Strip above the Table You can display a custom message above the table in the:

                          • List report, object page, and analytical page with SAP Fiori elements for OData V2
                          • List report with SAP Fiori elements for OData V4

                          In the object page, by default, a message strip is displayed when there are errors in the table.

                          When there are multiple messages, the one with the highest severity is displayed.

                           

                          List Report and Analytical Page Only

                           

                          Availability

                          Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                           

                          Object Page Only

                           

                          Availability

                          Message Strip for Rows with Errors Default
                          Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

                          • Anchor bar navigation and a single section that contains only a grid table
                          • Tab bar navigation and a current tab that contains only a grid table

                          Table Settings


                          Tooltips on Column Headers

                          On desktop applications, all table columns display tooltips, based on the text in:

                          • Common.QuickInfo, when it’s visible
                          • The column label, in all other cases

                          Tooltips are available only in desktop applications because users must hover their mouse on the column header to see them.


                          Clear All / Select All

                          When the selection of multiple rows is enabled for a table, the Clear All checkbox is displayed by default in the table header for the selection column in most cases, as shown in the table below. The exception is for the responsive table in the object page.

                          Information
                          To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

                          Floorplan

                           Table Type

                          Selection Default

                          Number of Rows Users Can Select

                          List Report Grid table

                          Analytical table

                          Tree table

                          Clear All   Limited to 200 rows by default

                          You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                          List Report Responsive table Clear All   Limited to the number of rows displayed on the interface
                          Object Page Grid table

                          Analytical table

                          Tree table

                          Clear All   Limited to 200 rows by default

                          You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                          Object Page Responsive table Select All   Limited to the number of rows displayed on the interface

                          Select All Behavior

                          In a responsive table, when the users select the Select All  checkbox, a limited number of items in the table are selected, not all.

                          A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

                          Warning
                          For grid tables, analytical tables, and tree tables, changing the the default from the Clear All checkbox to the Select All  checkbox can result in significant performance issues because the Select All   loads all the table rows to the frontend.

                          Always ask the application developers about the impact on performance before you consider such a change.

                          Guidelines
                          When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                          Column Width

                          The default column width varies according to the column contents:

                          • Text: can range from 3 to 20 rem
                          • Image: 5 rem
                          • Rating or progress indicator: 6.875 rem
                          • Chart: 20 rem

                          You can can change the width.

                          Developer Hint
                          For more information, refer the development team to Setting the Default Column Width.

                          Column Importance in Responsive Tables

                          By default:

                          • Key fields have high importance in list reports.
                          • Other columns have the importance of none and are handled like columns assigned medium importance.

                          You can change the level of importance.

                          The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                          • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                          • The values in columns with low importance are first to be hidden.

                          When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                          You can also assign an importance to custom columns.

                          For more information, see:


                          Freezing Columns

                          You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

                          Developer Hint
                          For more information, refer application developers to Tables.

                          Labels for Multiple Fields in a Column

                          By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                          You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                          Sort Order

                          By default, the sort order for a column is ascending.

                          You can:

                          • Set the default sort order to descending.
                          • Define other, customized sort orders.

                          For more information, see the sort guidelines according to table type:


                          Number of Table Rows Displayed at Once

                          By default, a responsive table loads the following number of rows at once:

                          • 20 rows in a list report.
                          • 10 rows in an object page with multiple sections.

                          When more rows exist, the users can click the More button at the end of the table to view additional rows.

                          With SAP Fiori elements for OData V2, you can change the default number.

                          For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                          Guidelines
                          Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                          Grouping

                          Grouping is available in responsive and analytical tables.

                          You can define the format of the grouping headers.

                          For more information, see:



                          No Data Found Text

                          By default, the following text is displayed when no data is found.

                          • When the user has not applied filters, the text is “No data found.”
                          • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                          Guidelines
                          Replace the generic text with text that’s meaningful to the user.

                          List Report and Analytical Page Only

                          Initial Expansion of Table Levels

                          By default, on initial load, the following expandable tables are expanded to this number of levels:

                          • Responsive table: 1 level
                          • Tree table: 1 level
                          • Analytical table: 0 levels

                          You can change the default value for the tree table and analytical tables.

                          Developer Hint
                          For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                          Object Page Only

                          Message Strip for Rows with Errors

                          When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                          Related Links

                          Table Features

                          The SAP Fiori elements templates support the features and settings for a table detailed below.

                          For design information see the table guidelines, starting with Table Overview, and the links within this article.

                          Feature Availability

                           

                          Table Settings

                           

                          Availability

                          Column Heading Labels You set these.
                          Tooltips on Column Header Labels Available for exceptional use cases with SAP Fiori elements for OData V4
                          Clear All When the selection of multiple rows is enabled, the Clear All  checkbox is displayed by default for:

                          • Grid tables, analytical tables and tree tables in both list reports and object pages
                          • Responsive tables in a list report with SAP Fiori elements for OData V2

                          You can change the default options.

                          Select All With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table in an object page, the Select All  checkbox is displayed by default.

                          You can change the default.

                          Sticky Column Header Behavior Default, you can turn it off.
                          Column Width The default width depends on the column contents. You can change it.
                          Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                          You can change the level of importance.

                          Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                          Ascending Sort Order on a Column Default, you can change it.
                          Grouping Available in responsive and analytical tables
                          Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                          No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                          Message Strip above the Table You can display a custom message above the table in the:

                          • List report, object page, and analytical page with SAP Fiori elements for OData V2
                          • List report with SAP Fiori elements for OData V4

                          In the object page, by default, a message strip is displayed when there are errors in the table.

                          When there are multiple messages, the one with the highest severity is displayed.

                           

                          List Report and Analytical Page Only

                           

                          Availability

                          Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                           

                          Object Page Only

                           

                          Availability

                          Message Strip for Rows with Errors Default
                          Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

                          • Anchor bar navigation and a single section that contains only a grid table
                          • Tab bar navigation and a current tab that contains only a grid table

                          Table Settings


                          Tooltips on Column Header Labels

                          Warning
                          Available with SAP Fiori elements for OData V4, the tooltips on the column header label feature makes sense only when the users always work on a desktop with a mouse. The users must hover on the column header to see the tooltips.

                          Clear All / Select All

                          When the selection of multiple rows is enabled for a table, the Clear All checkbox is displayed by default in the table header for the selection column in most cases, as shown in the table below. The exception is for the responsive table in the object page.

                          Information
                          To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

                          Floorplan

                           Table Type

                          Selection Default

                          Number of Rows Users Can Select

                          List Report Grid table

                          Analytical table

                          Tree table

                          Clear All   Limited to 200 rows by default

                          You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                          List Report Responsive table Clear All   Limited to the number of rows displayed on the interface
                          Object Page Grid table

                          Analytical table

                          Tree table

                          Clear All   Limited to 200 rows by default

                          You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                          Object Page Responsive table Select All   Limited to the number of rows displayed on the interface

                          Select All Behavior

                          In a responsive table, when the users select the Select All  checkbox, a limited number of items in the table are selected, not all.

                          A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

                          Warning
                          For grid tables, analytical tables, and tree tables, changing the the default from the Clear All checkbox to the Select All  checkbox can result in significant performance issues because the Select All   loads all the table rows to the frontend.

                          Always ask the application developers about the impact on performance before you consider such a change.

                          Guidelines
                          When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                          Column Width

                          The default column width varies according to the column contents:

                          • Text: can range from 3 to 20 rem
                          • Image: 5 rem
                          • Rating or progress indicator: 6.875 rem
                          • Chart: 20 rem

                          You can can change the width.

                          Developer Hint
                          For more information, refer the development team to Setting the Default Column Width.

                          Column Importance in Responsive Tables

                          By default:

                          • Key fields have high importance in list reports.
                          • Other columns have the importance of none and are handled like columns assigned medium importance.

                          You can change the level of importance.

                          The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                          • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                          • The values in columns with low importance are first to be hidden.

                          When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                          You can also assign an importance to custom columns.

                          For more information, see:


                          Freezing Columns

                          You can freeze the first columns of an analytical table, grid table, or tree table so that they always remain visible when the users scroll the table horizontally. You specify the number of columns.

                          Developer Hint
                          For more information, refer application developers to Tables.

                          Labels for Multiple Fields in a Column

                          By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                          You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                          Sort Order

                          By default, the sort order for a column is ascending.

                          You can:

                          • Set the default sort order to descending.
                          • Define other, customized sort orders.

                          For more information, see the sort guidelines according to table type:


                          Number of Table Rows Displayed at Once

                          By default, a responsive table loads the following number of rows at once:

                          • 20 rows in a list report.
                          • 10 rows in an object page with multiple sections.

                          When more rows exist, the users can click the More button at the end of the table to view additional rows.

                          With SAP Fiori elements for OData V2, you can change the default number.

                          For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                          Guidelines
                          Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                          Grouping

                          Grouping is available in responsive and analytical tables.

                          You can define the format of the grouping headers.

                          For more information, see:



                          No Data Found Text

                          By default, the following text is displayed when no data is found.

                          • When the user has not applied filters, the text is “No data found.”
                          • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                          Guidelines
                          Replace the generic text with text that’s meaningful to the user.

                          List Report and Analytical Page Only

                          Initial Expansion of Table Levels

                          By default, on initial load, the following expandable tables are expanded to this number of levels:

                          • Responsive table: 1 level
                          • Tree table: 1 level
                          • Analytical table: 0 levels

                          You can change the default value for the tree table and analytical tables.

                          Developer Hint
                          For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                          Object Page Only

                          Message Strip for Rows with Errors

                          When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                          Related Links

                          Object Page – Content Area

                          The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                          For design information, see the Object Page Floorplan guidelines and the links below.

                          Warning
                          Always build the object page using the dynamic page header.

                          Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                          Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                          Feature Availability

                           

                          Content Area

                           

                          Availability

                          Draft Object Validation Default

                          Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                          Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                          Navigation Bar: Tab Bar Available
                          Sections and Subsections Available
                          Reuse Components as Sections Available
                           

                          Subsections

                           

                          Availability

                          Link Available

                          With SAP Fiori elements for OData V4, you can display an icon or image with the link.

                          With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                          Smart Link Contact Available, SAP Fiori elements for OData V2 only
                          Tables Available
                          Charts Available
                          Views for Tables and Charts Available
                          Address Available
                          Display of Related Properties Together Available with SAP Fiori elements for OData for V4

                          The properties can also display as links.

                          Forms Available
                          Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

                          You can:

                          • Change the maximum
                          • Enable growing mode
                          • Show users the number of characters allowed in the text area
                          File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                          Dynamic Side Content Available with an extension
                           

                          Subsection Behavior

                           

                          Availability

                          Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                          Adjustment of the Width for Content Display in a Subsection Available
                           

                          Content Visibility

                           

                          Availability

                          Visible Sections, Subsections, Quickviews, and Tables Default
                          Hiding Section, Subsection, Quickview and Table Content Available
                          User-Controlled Visibility with Show More/Show Less Available
                          Visible Smart Form Fields Default, you can hide them in certain conditions.

                          Content Area

                          Navigation Bar

                          By default, the anchor bar is generated when the object page has at least one section.

                          It lets users navigate to the individual content area sections.

                          You can:

                          • Hide the anchor bar when you only have one section.
                          • Replace it with a tab bar.

                          With extensions, you can replace the buttons with another type of control.

                          For more information, see:

                          Sections and Subsections

                          You can add sections and subsections to the content area.

                          Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                          For more information, see: Sections and Subsections.

                          Reuse Components as Sections

                          You can embed a reuse component as a section in the object page.

                          Warning
                          A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                          Consult the development team on the requirements for the reuse component.

                          Subsections

                          With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                          The smart link contact can include a contact list and a quickview of the contact details.

                          For more information, see:

                          Tables

                          You can include a table in a subsection.

                          For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                          Charts

                          You can include a single chart facet in a subsection.

                          In the chart, you can:

                          • Display measures, their aggregation calculations, and dimensions to categorize the measures.
                          • Add custom actions to the toolbar for a chart and define whether they are enabled at all times or only after the user selects part of the chart for the action.
                          • Allow users to personalize the chart settings

                          SAP Fiori Elements for OData V2

                          Charts are only supported for business objects or services that are not draft enabled or are read-only.

                          SAP Fiori Elements for OData V4

                          You can define a chart for a draft-enabled business object. The chart only displays active data, not data entered into an unsaved draft record.

                          For more information, see Chart (VizFrame).

                          For more information on chart options, see Chart.

                          Developer Hint
                          For more information, refer application developers to Configuring Charts.

                          Views for Tables and Charts

                          You can turn on views for:

                          • All the tables and charts on the page
                          • Individual tables and charts

                          For more information, see Views (Variant Management).

                          Address

                          You can add one or more address fields:

                          • As a separate subsection
                          • As part of a field group within a subsection
                          • To a quick view with smart link navigation

                          For more information, see:

                          Display of Related Properties Together

                          You can display two related properties side-by-side and with a single label in display mode.

                          For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

                          You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

                          In edit mode, the fields can be edited separately.

                          Side-by-side display of related properties
                          Side-by-side display of related properties

                          Related Properties as Links

                          The related properties can also display as links.

                          Developer Hint
                          Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
                          Related properties as links
                          Related properties as links

                          Forms

                          You can add action buttons to the toolbar for a form contained in a subsection.

                          With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                          The action types can be:

                          • Actions that occur in the system while the user stays on the object page.
                          • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                          Conditional Enablement of Navigation Buttons

                          You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                          For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                          Guidelines
                          Implement this feature only when the way to enable the button is obvious to end users.

                          Columns in a Form

                          To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                           

                          Column Number

                          Screen Size

                          1 Small
                          2 Medium
                          3 Large
                          6 Extra large
                          Guidelines
                          The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                          Groups in a Form

                          You can group fields in a form and assign a name to the group.

                          Note that the group name is displayed only when a group contains fields.

                          User-Controlled Load of Fields with Low Importance

                          To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                          After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                          Text Control

                          By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                          You can:

                          • Set a maximum number of lines for the text control that’s greater than four.
                          • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
                          • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

                          A notification is displayed if the users try to enter text beyond the limit.

                          In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                          File Upload

                          With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                          For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                          The application developers can define the file size and types allowed for upload.

                          Dynamic Side Content

                          You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                          With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                            Guidelines

                            • Do not use tables in the side content panel.
                            • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                            • For the best view of the dynamic side content, set it to display in 50% of the screen.

                            For more information, see:

                            Developer Hint

                            Subsection Behavior

                            Subsection Loading Behavior

                            By default, the subsection starts loading after the main object page elements are loaded.

                            You can change the loading behavior to load the subsection after the header data is loaded.

                            Example

                            When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                            Width for Content Display in a Subsection

                            When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                            Content Visibility

                            Sections, Subsections, Quickviews, and Tables

                            By default, the object page displays these components.

                            You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                            User-Controlled Visibility

                            You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                            • When the subsection is hidden, Show More is displayed.
                            • When the subsection shows, the Show Less link is displayed.

                            Visibility of Smart Form Fields

                            By default, all smart form fields have the high importance setting and show on all screen sizes.

                            You can lower the level of importance for the fields to hide them on smaller screens.

                            According to the importance assigned to the field, it is displayed as follows:

                            • High (default): On all (small, medium, and large) screen sizes.
                            • Medium: On large and medium screens only.
                            • Low: On large screens only

                            For more information, see Responsiveness.

                            Related Links

                            Object Page – Header

                            The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                            For design information, see the Object Page Floorplan guidelines and the links below.

                            Warning
                            Always build the object page using the dynamic page header.

                            Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                            Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                            Feature Availability

                             

                            Behavior and Interaction

                             

                            Availability

                            Expanded State Default on initial load
                            Collapsed State Default on scroll

                            With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                            Header Content Display in Display Mode In the header content area
                            Header Content Display in Edit and Create Modes When the header is editable:

                            • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                            • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                            Header Content Visible Default, you can hide it.
                            Header Content Hidden Available
                            Header Field Editability By default, in edit mode the header is:

                            • Not editable with SAP Fiori elements for OData V2
                            • Editable with SAP Fiori elements for OData V4

                            You can change the default.

                            Highlighting Values Based on Criticality Available
                             

                            Components

                             

                            Availability

                            Dynamic Page Header Mandatory, it must be configured.
                            Title Mandatory, you must define it.
                            Menu for Saved Version / Draft Default for draft-enabled applications
                            Breadcrumbs Default
                            Subtitle Available, you define the text.
                            Object Marker Default in draft-enabled applications
                            Image Available
                            Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                            Paging Buttons on the First Subobject Page Default under certain conditions
                            Toolbar Available
                             

                            Toolbar Actions

                             

                            Availability

                            Edit and Delete Default, when the data allows these actions.

                            You can turn one or both actions off.

                            Copy Available with SAP Fiori elements for OData V2
                            Related Apps Menu Button Available

                            With SAP Fiori elements for OData V4, you can change the button name to Open in…

                            Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                            Application-Specific Actions Available,  they must be configured.
                            Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                            Requires an extension with SAP Fiori elements for OData V2

                            Order of Toolbar Actions Default

                            You can change the default order.

                             

                            Additional Content (Optional)

                             

                            Availability

                            Message Strip Available with SAP Fiori elements for OData V4 to provide information related to the object as a whole, such as the object status
                            Simple Header Facets Available with SAP Fiori elements for OData V2 only
                            Plain Text Facets Available
                            Contact Facets Available
                            Micro Chart Facets Available
                            Form Facets Available
                            Address Facets Available
                            Header Field Group Available
                            Rating Indicator Facets Available
                            Progress Indicator Facet Available
                            Key Value Facet Available
                            Link Available

                            With SAP Fiori elements for OData V2:

                            • The default link shows the text and ID. You can remove the text or the ID from the link.
                            • You can include a link that navigates to a site external to the application.

                            Behavior and Interaction


                            Collapsed/Expanded State

                            When the object page header contains at least one facet:

                            • On the initial load of the object page, the header is expanded.
                            • When the user scrolls down the page, the header collapses.
                            • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                            When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                            With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                            Next to the title, an arrow   button lets the users expand the header.

                            Summary Line for Object Page Header on Small Screens
                            Summary Line for Object Page Header on Small Screens

                            Display of Header Content

                            In display mode, the header content area displays all the header content.

                            In edit and create modes, when the header is:

                            • Editable
                              • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                            The header section is only present in the edit and create modes.

                              • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                             

                            • Not Editable, the header is hidden.

                            Note that, by default, the header is

                            • Editable with SAP Fiori elements for OData V4
                            • Not editable with SAP Fiori elements for OData V2

                            You can ask the application developers to change the default.

                            For more information, see Dynamic Page Header (Mandatory).

                            Developer Hint
                            To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                            Header Content Visibility

                            By default, header content is visible.

                            You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                            • Entire header facets
                            • Content, such as fields, in a header facet
                            • Content in quick views

                            With Fiori elements for OData V2, you can set:

                            • The header to be displayed in edit mode.
                            • Header facets to be visible in edit mode.
                            Developer Hint
                            For more information on the features, refer the development team to:


                            Header Field Editability

                            By default, in edit mode the header is:

                            • Not editable with SAP Fiori elements for OData V2
                            • Editable with SAP Fiori elements for OData V4

                            You can change the default.

                            Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                            Developer Hint
                            To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                            Highlighting Values Based on Criticality

                            You can assign colors and icons to text to indicate the criticality of a field value.

                            With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                            Components


                            Title

                            By default, with:

                            •  SAP Fiori elements for OData V2, the title area is empty.
                            •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                            Guidelines
                            Tell the developers which property to use as the title.

                            Menu for Saved Version / Draft

                            With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                            Breadcrumbs

                            Breadcrumbs are displayed above the object title.

                            Guidelines
                            Limit the breadcrumbs to the drilldown levels within the object page.

                            Object Marker

                            The object marker indicates the object is locked by another user in draft-enabled applications.


                            Image

                            The image is an avatar control. By default, it has a square shape.

                            You can set:

                            • An image to display instead of the avatar.
                            • The avatar to a have a circular shape.

                            When no image is set or found for the avatar, the avatar initials are displayed.

                            If those are not set or found either, an icon for the avatar is displayed:

                            • A square avatar for a product
                            • A circular avatar for a person.

                            For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                            Paging Buttons

                            By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                            • The user has navigated from a table in the object page to the subobject.
                            • The table in the object page contains at least two items.

                            With SAP Fiori elements for OData V2, you can:

                            • Enable the paging buttons to show on the first object page opened from a list report.
                            • Disable the default display of the paging buttons on the subobject page.

                            Toolbar Actions


                            Edit and Delete

                            By default, these actions are displayed when the data in the object page allows them.

                            You can:

                            • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                            • Disable the actions.

                            For more information, see:


                            Copy

                            You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                            You set the label for the button according to your use case. Otherwise, the default label is Copy.

                            In the object page, the Copy button is displayed after the Delete button.

                            Developer Hint
                            Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                            Related Apps Menu Button

                            You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                            You can also:

                            • Hide specific actions in the menu.
                            • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                            Generic Actions

                            By default, the Share button is displayed for saved objects and hidden for drafts.

                            The share menu includes the Chat in Microsoft Teams option when the required settings have been made by the system administrators of SAP S/4HANA CloudThis option is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.
                            The share menu includes the Chat in Microsoft Teams option when the required settings have been made by the system administrators of SAP S/4HANA Cloud.

                            The option is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                            For more information, see Share (Generic).

                            Developer Hint
                            For more information, refer application developers to: Integrating Microsoft Teams.

                            Application-Specific Actions

                            You can include the actions required for your use case.

                            The header toolbar displays application-specific actions to the left of the generic actions.

                            You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                            Developer Hint
                            For more information, refer application developers to Keyboard Shortcuts.

                            Conditional Enablement of Navigation Buttons

                            With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                            With SAP Fiori elements for OData V2, this feature requires extensions.

                            For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                            Guidelines
                            Implement this feature only when the way to enable the button is obvious to end users.

                            Order of Toolbar Actions

                            The default order — left to right — for actions in the object page toolbar is below:

                            • Edit
                            • Delete
                            • Copy with SAP Fiori elements for OData V2
                            • Application-specific action buttons
                            • Related Apps menu button
                            • Share

                            You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                            For more information, see:

                            Additional Content


                            Message Strip

                            With SAP Fiori elements for OData V4, you can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                            The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                            When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                            The user can find the individual messages via the message popover in the footer bar.

                            For more information, see:

                            Simple Header Facets

                            With SAP Fiori elements for OData V2:

                            • You can use a simple header facet to show simple data points that align horizontally across the header.
                            • When form fields contain no value, they display the empty  state indicator (–).

                            Plain Text Facets

                            You can use the plain text facet to display a continuous text in the header.

                            For more information, see Plain Text Facet.


                            Contact Facets

                            You can enable a quick view for a contact.

                            With SAP Fiori elements for OData V4:

                            • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                            • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                            For more information, see Quick View.


                            Micro Chart Facets

                            You can display the following micro charts in the header:

                            • Area micro chart
                            • Bullet chart
                            • Radial chart
                            • Column chart
                            • Line micro chart
                            • Harvey ball chart
                            • Stacked bar chart

                            For more information, see Micro Charts.


                            Form Facets

                            You can add a quick view to the form facet.

                            For more information, see Form Facet (Dataset).

                            Developer Hint
                            For more information, refer the development team to Form Facet.

                            Address Facets

                            You can display an address such as a shipping address.

                            Developer Hint
                            For more information, refer the development team to Address Facet in the Object Page Header.

                            Header Field Groups

                            You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                            Rating Indicator Facets

                            You can add a rating indicator to the header. It is read-only in both display and edit modes.

                            By default, the maximum rating is five stars.

                            You can:

                            • Change the maximum rating.
                            • Specify more descriptive text for the subtitle.

                            With extensions, you can make the rating editable.

                            Display Mode

                            The rating indicator shows with the:

                            • Title
                            • Subtitle with the total number of ratings
                            • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                            Edit Mode

                            The rating indicator moves into the header facet and appears with only the title in edit mode.

                            For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                            For more information, see:


                            Progress Indicator Facets

                            You can add a progress indicator facet to the object header.

                            For more information, see:


                            Key Value Facets

                            You can add a key value facet to highlight important data or KPIs.

                            For more information, see Key Value Facet.

                            Related Links

                            Table Rows

                            The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                            For design information see the table guidelines, starting with Table Overview, and the links below.

                            Feature Availability

                               
                             

                            Actions

                             

                            Availability

                            Inline Actions Available
                            Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                            Conditional Enablement of Navigation Buttons For list report and object pages:

                            • Available with SAP Fiori elements for OData V4
                            • Requires an extension with SAP Fiori elements for OData V2
                            Single Item Selection Default
                            Multiple Item Selection Available
                            Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                            Delete Available in responsive tables only
                            Custom Actions Available
                            Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                             

                            Display

                             

                            Availability

                            Empty Rows Available for responsive and grid tables in an object page in create and edit modes.
                            Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                            Editing Status For draft-enabled applications, displayed by default in a responsive table in a list report
                            Rating Indicator Available
                            Progress Indicator Available
                            Quick Contact View Available
                            Avatar Available
                            Avatar Tooltip Available
                            Other Images Available with live box mode only
                            Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                            In edit mode, the multiple values are displayed, but not editable.

                            The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                            Highlighting New Line Items Available with SAP Fiori elements for OData V2

                            Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                            Highlighting Line Items Based on Criticality Available
                             

                            Responsive Table Only

                             

                            Availability

                            Multiple Fields in a Single Column Available
                            Smart Micro Chart Available

                            Actions

                            Inline Actions

                            You can define actions for table rows or inline items. The action types can be:

                            • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                            • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                            When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                            Direct Edit

                            You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                            This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                            Conditional Enablement of Navigation Buttons

                            In list reports and object pages:

                            • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                            • With SAP Fiori elements for OData V2, this feature requires extensions.

                            For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                            Guidelines
                            Implement this feature only when the way to enable the button is obvious to end users.

                            Item Selection

                            Both versions of SAP Fiori elements allow you to determine whether users can select:

                            • One table row for a toolbar action, using a radio button.
                            • Multiple table rows for a toolbar action, using checkboxes.
                              For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                              For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                            When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                            • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                              For complete information, see: Select All / Clear All.
                            • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                              You can change the limit. We recommend you consult the application team on how a change would impact performance.

                            SAP Fiori elements for OData V2

                            By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                            SAP Fiori elements for OData V4

                            With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                            • In display mode, item selection is not possible.
                            • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                            Instead, you can enable one of the following selection modes:

                            • None:
                              • Display mode allows no item selection.
                              • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                            • Single: Both display and edit modes allow single item selection.
                            • Multi: Both display and edit modes allow multiple item selection.
                            Warning
                            When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                            Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                            For more information, see:

                            Developer Hint
                            For more information, refer the development team to:


                            Delete

                            In responsive tables only, you can:

                            • Display an inline delete action.
                            • Prevent the deletion of certain rows.

                            In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                            For more information, see Delete Single Item Rows.


                            Custom Actions

                            You can define custom inline actions.

                            Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                            Messages for Critical Actions

                            For actions that you set as critical, you can display one of the following after the user triggers the action:

                            • A message toast confirmation
                            • A confirmation message box to check the users want to proceed with specific critical actions

                            Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                            Guidelines
                            Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                            Ask the development team whether or not the backend requires confirmations for your use case.

                            Example


                            SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                            Default Text “Do you really want to execute the action <Action Label>?”

                            <Action Label> is the label shown on the button.

                            “Do you really want to perform this action?
                            Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                            For more information, see UI Text Guidelines for SAP Fiori Apps.


                            Display

                            You can include the display features described below in a table row or inline item.


                            Empty Rows

                            With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display two empty rows where the user can enter data for subobjects. The purpose of displaying two empty rows is to give the user a choice between entering data for one column at a time or for one row at a time.

                            You can enable the feature at the table level in draft-enabled applications.

                            • Inline actions, such as delete or navigation to the item via the chevron are hidden on the empty rows.
                            • Sorting and grouping are not applicable for the empty rows because they don’t exist in a table on the back end.

                            As soon as the user has entered data in one field in an empty row and moved the focus away from that field:

                            • The row with the completed field is highlighted with a blue line to its left to show it’s a newly created draft.
                            • The row displays the navigation chevron. Deletion also supported for the row.
                            • A new empty row is added under the highlighted row so two empty rows are always available for data entry.

                            You can set default values to populate fields in the empty rows.

                            With SAP Fiori elements for OData V4, for use cases where certain fields become relevant only after creation, you can disable the fields in the empty row so they are read-only at creation time and become editable afterwards.

                            With both SAP Fiori elements for OData V2 and V4, the empty rows are displayed:

                            • At the end of a grid table.
                              The Create button in the toolbar scrolls to the first empty row at the end of the table and puts the focus on the first editable field.
                            • At the top of the responsive table.
                              The toolbar has no Create button.

                            Read-Only Field

                            With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                            Editing Status

                            By default, for draft-enabled applications, a responsive table in a list report displays the editing status in the first column.

                            You can also add the semantic key to the status.

                            The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                            • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                            • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                            For more information, see Tables.


                            Rating Indicator

                            You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                            The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                            With extensions, you can enable editing of the rating indicator

                            For more information, see Rating Indicator.


                            Progress Indicator

                            You can:

                            • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                            • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                            • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                            For more information, see Progress Indicator.


                            Quick Contact View

                            You can add a quick view to a contact to display key contact details in a popover.

                            For more information, see Quickview.


                            Avatar and Other Images

                            You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                            Warning
                            Other images are not displayed correctly within the table borders. Only use them with live box mode.

                            For more information, see Avatar.


                            Highlighting Line Items

                            By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                            Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                            You can also define highlighting and icons for line items based on their criticality.

                            After a newly created item is saved, it is highlighted according to the criticality, as follows:

                            • Green for success (criticality value 3)
                            • Yellow for warning (criticality value 2)
                            • Red for error (criticality value 1)
                            • No highlighting for no criticality (criticality value 0)

                            Display in Responsive Table Only

                            In a responsive table, you can include the display features described below in a table row or inline item.


                            Multiple Fields in a Single Column

                            You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                            For example, you can display the following in a single column:

                            • Company name
                            • Company ID
                            • Items in Stock
                            • Progress Indicator for Items in Stock
                            • Overall value of the Items
                            • Multiple Action buttons that allow the user to both:
                              • Execute an action while staying on the list report page
                              • Navigate to other objects and applications

                            The visibility and position in the table of a column that combines multiple fields can be changed.

                            Field Labels

                            By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                            You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                            Limitation on Export to Spreadsheet

                            When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                            Information

                            Write a short and meaningful message.


                            Smart Micro Chart

                            You can:

                            • Add an inline micro chart.
                            • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                            You can choose among the following micro chart types:

                            • Area micro chart
                            • Bullet micro chart
                            • Line micro chart
                            • Micro chart/smart micro chart
                            • Radial micro chart
                            • Stacked bar micro chart
                            Warning
                            The user cannot navigate to another page from the chart.

                            For more information on chart types, see: Choosing the Correct Chart Type.

                            Related Links

                            Table Types

                            The SAP Fiori elements templates support the features and settings for the different table types detailed below.

                            For design information, see the guidelines starting with Table Overview, and see the links below.

                            Feature Availability

                            Table Type

                            Responsive Table (Default)

                            Analytical

                            Grid

                            Tree

                            SAP Fiori Elements for OData Version

                            V2 & V4

                             V2 & V4

                             V2

                            V2

                            Devices
                            Desktop         
                            Tablet         
                            Phone          
                            Responsive
                            (hide column, popin support)
                                     
                            Density Mode

                            See Content Density.

                            See Analytical Table: Compact, Cozy, Condensed. See Grid Table: Compact, Cozy, Condensed. See Tree Table: Types.
                            Compact density            
                            Condensed density         
                            Cozy density         
                            Summarized cell           
                            Hierarchical data           
                            Large number of rows (> 200)         
                            Grouping         
                            Freeze columns         
                            Horizontal scrolling         
                            Merge duplicates          
                            Supported Inline Controls All Limited 
                            See Inline Controls for Non-Responsive Tables below.
                            Limited
                            See Inline Controls for Non-Responsive Tables below.
                            Limited
                            See Inline Controls for Non-Responsive Tables below.
                            Row-based         
                            Column-based         

                            Inline Controls for Non-Responsive Tables

                            These inline controls are supported for grid, analytical, and tree tables:

                            • Text
                            • Label
                            • ObjectStatus
                            • Icon
                            • Button
                            • Input
                            • DatePicker
                            • Select
                            • ComboBox
                            • MultiComboBox
                            • CheckBox
                            • Link
                            • Currency
                            • RatingIndicator
                            • ProgressIndicator

                            Also, the following when they are of a responsive or very small size:

                            • StackedBarMicroChart
                            • ComparisonMicroChart
                            • BulletMicroChart

                            Related Links

                            Elements and Controls

                            Implementation

                            Table Types

                            The SAP Fiori elements templates support the features and settings for the different table types detailed below.

                            For design information, see the guidelines starting with Table Overview, and see the links below.

                            Feature Availability

                            Table Type

                            Responsive Table (Default)

                            Analytical

                            Grid

                            Tree

                            SAP Fiori Elements for OData Version

                            V2 & V4

                             V2 & V4

                             V2

                            V2

                            Devices
                            Desktop         
                            Tablet         
                            Phone          
                            Responsive
                            (hide column, popin support)
                                     
                            Density Mode

                            See Content Density.

                            See Analytical Table: Compact, Cozy, Condensed. See Grid Table: Compact, Cozy, Condensed. See Tree Table: Types.
                            Condensed density         
                            Cozy density         
                            Summarized cell           
                            Hierarchical data           
                            Large number of rows (> 200)         
                            Grouping         
                            Freeze columns         
                            Horizontal scrolling         
                            Merge duplicates          
                            Supported Inline Controls All Limited 
                            See Inline Controls for Non-Responsive Tables below.
                            Limited
                            See Inline Controls for Non-Responsive Tables below.
                            Limited
                            See Inline Controls for Non-Responsive Tables below.
                            Row-based         
                            Column-based         

                            Inline Controls for Non-Responsive Tables

                            These inline controls are supported for grid, analytical, and tree tables:

                            • Text
                            • Label
                            • ObjectStatus
                            • Icon
                            • Button
                            • Input
                            • DatePicker
                            • Select
                            • ComboBox
                            • MultiComboBox
                            • CheckBox
                            • Link
                            • Currency
                            • RatingIndicator
                            • ProgressIndicator

                            Also, the following when they are of a responsive or very small size:

                            • StackedBarMicroChart
                            • ComparisonMicroChart
                            • BulletMicroChart

                            Related Links

                            Elements and Controls

                            Implementation

                            List Report – Content Area

                            The SAP Fiori elements list report template supports the three content area layouts detailed below.

                            For design information, see General Layout and the links below.

                            Simple Content Layout

                            The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                            • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                            • Automatic data loading
                            • One table toolbar
                            • Creation of business objects via a dialog
                            Warning
                            Although table-level view management is supported, we strongly recommend against it.
                            Simple content layout (default)
                            Simple content layout (default)

                            Multiple View Layout

                            For more complex scenarios, you can turn on the multiple view layout which supports: 

                            • Display of multiple views of a table that shows one business object, for example, each view of the same table can display different prefiltered states
                            • The segmented button for a maximum of three views or the select control for four or more views
                              Note that the SAP Fiori elements framework determines the switch control automatically based on the number of views.
                            • Display of the count or number of total rows in the view (must be enabled)
                            • One table toolbar
                            • Automatic data loading
                            • Creation of business objects via a dialog with SAP Fiori elements for OData V2
                            Warning
                            Although table-level view management is supported, we strongly recommend against it.
                            Multiple view layout - Segmented button
                            Multiple view layout - Segmented button
                            Muliple view layout - Select control
                            Muliple view layout - Select control

                            Multiple Content Layout

                            To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                            • Display of one or more business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can be filtered by a specific customer and a specific date
                            • Text-only icon tab bar to switch among the tabs
                            • Views with data visualization in either table or chart format with both SAP Fiori elements for OData V2 and V4
                            • Automatic data loading
                            • Different toolbars for each view
                            Warning
                            Creation of business objects via a dialog is not supported – it must be done in an object page.

                            Although table-level or chart-level view management is supported, we strongly recommend against it.

                            Do not use a mix of responsive and non-responsive tables.

                            Developer Hint
                            Application developers may be unfamiliar with the designer term “multiple content layout.”

                            For more information on implementing this feature, refer the development team to:

                            Multiple content layout
                            Multiple content layout

                            Related Links

                            Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                            Table Features

                            The SAP Fiori elements templates support the features and settings for a table detailed below.

                            For design information see the table guidelines, starting with Table Overview, and the links within this article.

                            Feature Availability

                             

                            Table Settings

                             

                            Availability

                            Column Heading Labels You set these.
                            Tooltips on Column Header Labels Available for exceptional use cases with SAP Fiori elements for OData V4
                            Clear All When the selection of multiple rows is enabled, the Clear All  checkbox is displayed by default for:

                            • Grid tables, analytical tables and tree tables in both list reports and object pages
                            • Responsive tables in a list report with SAP Fiori elements for OData V2

                            You can change the default options.

                            Select All With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table in an object page, the Select All  checkbox is displayed by default.

                            You can change the default.

                            Sticky Column Header Behavior Default, you can turn it off.
                            Column Width The default width depends on the column contents. You can change it.
                            Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                            You can change the level of importance.

                            Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                            Ascending Sort Order on a Column Default, you can change it.
                            Grouping Available in responsive and analytical tables
                            Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                            No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                            Message Strip above the Table You can display a custom message above the table in the:

                            • List report, object page, and analytical page with SAP Fiori elements for OData V2
                            • List report with SAP Fiori elements for OData V4

                            In the object page, by default, a message strip is displayed when there are errors in the table.

                            When there are multiple messages, the one with the highest severity is displayed.

                             

                            List Report and Analytical Page Only

                             

                            Availability

                            Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                             

                            Object Page Only

                             

                            Availability

                            Message Strip for Rows with Errors Default
                            Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

                            • Anchor bar navigation and a single section that contains only a grid table
                            • Tab bar navigation and a current tab that contains only a grid table

                            Table Settings


                            Tooltips on Column Header Labels

                            Warning
                            Available with SAP Fiori elements for OData V4, the tooltips on the column header label feature makes sense only when the users always work on a desktop with a mouse. The users must hover on the column header to see the tooltips.

                            Clear All / Select All

                            When the selection of multiple rows is enabled for a table, the Clear All checkbox is displayed by default in the table header for the selection column in most cases, as shown in the table below. The exception is for the responsive table in the object page.

                            Information
                            To select a range of items when the Clear All checkbox is displayed, users can select an item, press Shift, and select others.

                            Floorplan

                             Table Type

                            Selection Default

                            Number of Rows Users Can Select

                            List Report Grid table

                            Analytical table

                            Tree table

                            Clear All   Limited to 200 rows by default

                            You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                            List Report Responsive table Clear All   Limited to the number of rows displayed on the interface
                            Object Page Grid table

                            Analytical table

                            Tree table

                            Clear All   Limited to 200 rows by default

                            You can change the limit, but we recommend you consult the application team on how the change would impact  performance.

                            Object Page Responsive table Select All   Limited to the number of rows displayed on the interface

                            Select All Behavior

                            In a responsive table, when the users select the Select All  checkbox, a limited number of items in the table are selected, not all.

                            A message informs users that “Only the first n of the items you selected were added to the selection,” where “n” equals the number of items loaded on the interface.

                            Warning
                            For grid tables, analytical tables, and tree tables, changing the the default from the Clear All checkbox to the Select All  checkbox can result in significant performance issues because the Select All   loads all the table rows to the frontend.

                            Always ask the application developers about the impact on performance before you consider such a change.

                            Guidelines
                            When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                            Column Width

                            The default column width varies according to the column contents:

                            • Text: can range from 3 to 20 rem
                            • Image: 5 rem
                            • Rating or progress indicator: 6.875 rem
                            • Chart: 20 rem

                            You can can change the width.

                            Developer Hint
                            For more information, refer the development team to Setting the Default Column Width.

                            Column Importance in Responsive Tables

                            By default:

                            • Key fields have high importance in list reports.
                            • Other columns have the importance of none and are handled like columns assigned medium importance.

                            You can change the level of importance.

                            The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                            • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                            • The values in columns with low importance are first to be hidden.

                            When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                            You can also assign an importance to custom columns.

                            For more information, see:


                            Labels for Multiple Fields in a Column

                            By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                            You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                            Sort Order

                            By default, the sort order for a column is ascending.

                            You can:

                            • Set the default sort order to descending.
                            • Define other, customized sort orders.

                            For more information, see the sort guidelines according to table type:


                            Number of Table Rows Displayed at Once

                            By default, a responsive table loads the following number of rows at once:

                            • 20 rows in a list report.
                            • 10 rows in an object page with multiple sections.

                            When more rows exist, the users can click the More button at the end of the table to view additional rows.

                            With SAP Fiori elements for OData V2, you can change the default number.

                            For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                            Guidelines
                            Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                            Grouping

                            Grouping is available in responsive and analytical tables.

                            You can define the format of the grouping headers.

                            For more information, see:



                            No Data Found Text

                            By default, the following text is displayed when no data is found.

                            • When the user has not applied filters, the text is “No data found.”
                            • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                            Guidelines
                            Replace the generic text with text that’s meaningful to the user.

                            List Report and Analytical Page Only

                            Initial Expansion of Table Levels

                            By default, on initial load, the following expandable tables are expanded to this number of levels:

                            • Responsive table: 1 level
                            • Tree table: 1 level
                            • Analytical table: 0 levels

                            You can change the default value for the tree table and analytical tables.

                            Developer Hint
                            For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                            Object Page Only

                            Message Strip for Rows with Errors

                            When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                            Related Links

                            Object Page – Footer Bar

                            The SAP Fiori elements object page template supports the features and settings for the object page footer detailed below.

                            For design information, see the Object Page Floorplan guidelines and the links below.

                            Warning
                            Always build the object page using the dynamic page header.

                            Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                            Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                            Feature Availability

                             

                            Footer Bar Actions

                             

                            Availability

                            Finalizing Actions Available
                            Create Default in create mode
                            Save Default in edit mode
                            Close on Save Available with SAP Fiori elements for OData V2 only
                            Save and Edit Available, for non-draft applications with SAP Fiori elements for OData V2 only
                            Save and Next Available, with SAP Fiori elements for OData V2 only
                            Apply Available, for the subobject page in draft-enabled applications only
                            Message Popover Button Default, visible only when messages are present.
                            Discard Draft Default in edit mode for draft-enabled applications
                            Cancel Default in edit mode for applications without draft handling
                            Enabling / Disabling of Actions Available
                            Keyboard Shortcuts for Actions Available

                            Footer Bar Actions

                            In create and edit modes, the footer bar appears at the bottom of the screen.


                            Finalizing Actions

                            You can add finalizing actions to the footer bar.

                            A message toast is displayed when an operation is successful.

                            Finalizing actions complete the work on the current screen, by permanently changing the object state. You can also set them to navigate away from the object page.

                            Note that developers may call these actions determining actions.

                            Guidelines
                            Replace the generic placeholder text in the message toast with text that’s meaningful to the user.

                            Save

                            The action is displayed by default in edit mode.

                            After saving, the user stays on the object page for applications both with and without draft handling enabled.

                            You can enable users to automatically navigate back to the list report when they save with SAP Fiori elements for OData V2. To do this, ask your development team to add close logic to the Save action.


                            Save and Edit

                            You can enable this action in non-draft applications with SAP Fiori elements for OData V2.

                            With the Save and Edit action, users save current changes and stay on the object page to continue editing.


                            Save and Next

                            This action is enabled with SAP Fiori elements for OData V2 when the direct edit feature is enabled in the corresponding list report.

                            With the Save and Next action, users save current changes and navigate to the next editable object in the list report.

                            After they click Save and Next for the last editable object in the list report, they return to the list report.


                            Apply

                            You can enable this action in the footer bar of a subobject page in draft-enabled applications.

                            With the Apply action, users conclude the create or edit activity, save the draft, and navigate one step up in the object hierarchy to the object page.

                            Similarly, when the subobject page is open in flexible column layout with three column layout, clicking Apply now closes the column where the subobject is displayed and returns the user to the object page.


                            Message Popover Button

                            Turned on by default, the button is only visible when messages are present and allows the user to open the message popover. The color of the message button reflects the most crtical message level.

                            The message popover displays the count of error messages.

                            Messages without a criticality level are treated as information messages.

                            With SAP Fiori elements for OData V2, the messages in the message popover are grouped by section and table so users can easily locate where they need to take action.

                            For more information, see:


                            Discard Draft

                            Displayed by default in edit mode for applications with draft-handling, this action button lets the users leave the object page without saving the changes they’ve made in a draft version of the object.


                            Cancel

                            Displayed by default in edit mode for applications without draft-handling this action button lets users leave the object page without saving changes they’ve made to the object.


                            Enabling / Disabling of Actions

                            You can enable or disable footer bar actions according to certain conditions. For example, to prevent users from archiving a sales order that is still being processed, you can enable the Archive action only for sales orders with the status Delivered or Cancelled.

                            Note that even if you disable all footer bar actions, the footer bar still appears onscreen for the display of the message popover, described above.


                            Keyboard Shortcuts for Actions

                            Keyboard shortcuts are available for basic operations.

                            You can also enable custom shortcuts for application-defined actions.

                            Developer Hint
                            For more information, refer application developers to Keyboard Shortcuts.

                            Related Links

                            Object Page – Overview

                            The SAP Fiori elements object page template supports the features and settings for the overall object page behavior detailed below.

                            For design information, see the Object Page Floorplan guidelines and the links below.

                            Warning
                            Always build the object page using the dynamic page header.

                            Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                            Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                            Feature Availability

                               
                             

                            Features

                             

                            Availability

                            Illustrated Message for Unfound Page Default

                            See Illustrated Message.

                            Unsaved Changes Warning Default for the main object page in draft-enabled applications when the user navigates to:

                            • Another application without saving changes. You can turn it off.
                            • The previous page without saving changes.

                            Feature Details

                            Unsaved Changes Warning

                            By default, in draft-enabled applications, on the main object page, a message warns users of unsaved changes when the users navigate:

                            • Forward to another application without saving changes in edit mode or without entering data for a new object in create mode.

                            You can ask the application developers to turn the message off for forward navigation. The draft is kept for the user to return to later.

                            • Backward to the previous page without saving changes in edit mode or the data entered for a new object in create mode.
                            Information
                            No message is displayed when the user navigates backward without entering data for a new object in create mode. The object is discarded.

                            Depending on whether the object page is in edit or create mode, the message lets the users opt to:

                            • Save changes in edit mode
                            • Create the object in create mode
                            • Keep the draft
                            • Discard the draft
                            • Cancel the navigation
                            Warning for unsaved changes in edit mode
                            Warning for unsaved changes in edit mode
                            Warning for unsaved changes in create mode
                            Warning for unsaved changes in create mode

                            Worklist

                            With SAP Fiori elements, the worklist is a simplified list report without a filter bar and shares many features and settings with the list report that are described in the SAP Fiori elements list report articles.

                            The worklist features and settings that differ from those in the list report are detailed below.

                            For design information, see the Worklist Floorplan guidelines and the links below.


                            Feature Availability

                             

                            Worklist-Specific Features

                             

                            Availability

                            View Management Not Enabled Default,  you must assign a header title.
                            Page-Level View Management Available
                            Header Title Mandatory, if you do not enable page-level view management.
                            Filter Bar Unavailable
                            Table Title Default: The title contains the row count.
                            Table Behavior Default: Fixed layout and growing mode when the user scrolls.
                            Search Available in table toolbar
                            Personalization Actions Enabled: Sort, Filter, Group, and Column Settings Default, accessible via the Settings  icon
                             Export to Spreadsheet Available

                            Related Links

                            Elements and Controls

                            Chart

                            To present data graphically, you can add a chart to an object page section or a list report with the multiple content layout with SAP Fiori elements. Charts are also an integral part of applications based on the analytical list page

                            A chart displays measures and dimensions that categorize the measures. Aggregation calculations are performed on the measures.

                            Feature Availability


                            Feature Availability
                            Charts With SAP Fiori elements for OData V2, for business objects or services that are not draft enabled or that are read-only.

                            With SAP Fiori elements for OData V4 when a chart is defined for a draft-enabled business object. The chart displays only active data, not data entered for an unsaved draft record.

                            Chart Header Visible by default. You can disable it.
                            Personalization of Chart Settings Enabled by default to allow users to personalize chart settings.

                            With SAP Fiori elements for OData V4, you can:

                            • Control the visibility of chart personalization options for ColumnSort and Type.
                            • Turn off the personalization.
                            Views (Variant Management) Available. Enablement of the personalization of chart settings is a prerequisite for views.
                            Filter Option in Chart Personalization For an optimal user experience, we recommend against the enablement of filtering in the list report and the analytical list page.

                            For the filter option to be available via the chart settings personalization, the personalization of chart settings must be enabled.

                            By default, the filter option is:

                            • Disabled when views are not enabled.
                            • Disabled when views are enabled at the page level.
                            • Enabled when views are enabled at the chart level.
                            Custom Actions in Chart Toolbar Available. You can also determine when the action buttons are enabled or disabled.
                            Colors Based on Criticality

                            A chart’s colors can indicate the criticality of the data values displayed, for example:

                            • Green for success
                            • Yellow for warning
                            • Red for error

                            Related Links

                            Elements and Controls

                            Implementation

                            Object Page – Content Area

                            The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                            For design information, see the Object Page Floorplan guidelines and the links below.

                            Warning
                            Always build the object page using the dynamic page header.

                            Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                            Do not use the current implementation of the “page view management” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                            Feature Availability

                             

                            Content Area

                             

                            Availability

                            Draft Object Validation Default

                            Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                            Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                            Navigation Bar: Tab Bar Available
                            Sections and Subsections Available
                            Reuse Components as Sections Available
                             

                            Subsections

                             

                            Availability

                            Link Available

                            With SAP Fiori elements for OData V4, you can display an icon or image with the link.

                            With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                            Smart Link Contact Available, SAP Fiori elements for OData V2 only
                            Tables Available
                            Charts Available
                            Views for Tables and Charts Enabled by default for each table and chart in the page.

                            You can change the default.

                            Address Available
                            Display of Related Properties Together Available with SAP Fiori elements for OData for V4

                            The properties can also display as links.

                            Forms Available
                            Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

                            You can:

                            • Change the maximum
                            • Enable growing mode
                            • Show users the number of characters allowed in the text area
                            File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                            Dynamic Side Content Available with an extension
                             

                            Subsection Behavior

                             

                            Availability

                            Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                            Adjustment of the Width for Content Display in a Subsection Available
                             

                            Content Visibility

                             

                            Availability

                            Visible Sections, Subsections, Quickviews, and Tables Default
                            Hiding Section, Subsection, Quickview and Table Content Available
                            User-Controlled Visibility with Show More/Show Less Available
                            Visible Smart Form Fields Default, you can hide them in certain conditions.

                            Content Area

                            Navigation Bar

                            By default, the anchor bar is generated when the object page has at least one section.

                            It lets users navigate to the individual content area sections.

                            You can:

                            • Hide the anchor bar when you only have one section.
                            • Replace it with a tab bar.

                            With extensions, you can replace the buttons with another type of control.

                            For more information, see:

                            Sections and Subsections

                            You can add sections and subsections to the content area.

                            Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                            For more information, see: Sections and Subsections.

                            Reuse Components as Sections

                            You can embed a reuse component as a section in the object page.

                            Warning
                            A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                            Consult the development team on the requirements for the reuse component.

                            Subsections

                            With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                            The smart link contact can include a contact list and a quickview of the contact details.

                            For more information, see:

                            Tables

                            You can include a table in a subsection.

                            For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                            Charts

                            You can include a single chart facet in a subsection.

                            In the chart, you can:

                            • Display measures, their aggregation calculations, and dimensions to categorize the measures.
                            • Add custom actions to the toolbar for a chart and define whether they are enabled at all times or only after the user selects part of the chart for the action.
                            • Allow users to personalize the chart settings

                            SAP Fiori Elements for OData V2

                            Charts are only supported for business objects or services that are not draft enabled or are read-only.

                            SAP Fiori Elements for OData V4

                            You can define a chart for a draft-enabled business object. The chart only displays active data, not data entered into an unsaved draft record.

                            For more information, see Chart (VizFrame).

                            For more information on chart options, see Chart.

                            Developer Hint
                            For more information, refer application developers to Configuring Charts.

                            Views for Tables and Charts

                            By default, views are turned on for each table and chart on the page at the control level.

                            You can ask the application development team to turn it off.

                            For more information, see Views (Variant Management).

                            Address

                            You can add one or more address fields:

                            • As a separate subsection
                            • As part of a field group within a subsection
                            • To a quick view with smart link navigation

                            For more information, see:

                            Display of Related Properties Together

                            You can display two related properties side-by-side and with a single label in display mode.

                            For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

                            You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

                            In edit mode, the fields can be edited separately.

                            Side-by-side display of related properties
                            Side-by-side display of related properties

                            Related Properties as Links

                            The related properties can also display as links.

                            Developer Hint
                            Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
                            Related properties as links
                            Related properties as links

                            Forms

                            You can add action buttons to the toolbar for a form contained in a subsection.

                            With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                            The action types can be:

                            • Actions that occur in the system while the user stays on the object page.
                            • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                            Conditional Enablement of Navigation Buttons

                            You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                            For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                            Guidelines
                            Implement this feature only when the way to enable the button is obvious to end users.

                            Columns in a Form

                            To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                             

                            Column Number

                            Screen Size

                            1 Small
                            2 Medium
                            3 Large
                            6 Extra large
                            Guidelines
                            The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                            Groups in a Form

                            You can group fields in a form and assign a name to the group.

                            Note that the group name is displayed only when a group contains fields.

                            User-Controlled Load of Fields with Low Importance

                            To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                            After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                            Text Control

                            By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                            You can:

                            • Set a maximum number of lines for the text control that’s greater than four.
                            • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
                            • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

                            A notification is displayed if the users try to enter text beyond the limit.

                            In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                            File Upload

                            With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                            For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                            The application developers can define the file size and types allowed for upload.

                            Dynamic Side Content

                            You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                            With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                              Guidelines

                              • Do not use tables in the side content panel.
                              • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                              • For the best view of the dynamic side content, set it to display in 50% of the screen.

                              For more information, see:

                              Developer Hint

                              Subsection Behavior

                              Subsection Loading Behavior

                              By default, the subsection starts loading after the main object page elements are loaded.

                              You can change the loading behavior to load the subsection after the header data is loaded.

                              Example

                              When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                              Width for Content Display in a Subsection

                              When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                              Content Visibility

                              Sections, Subsections, Quickviews, and Tables

                              By default, the object page displays these components.

                              You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                              User-Controlled Visibility

                              You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                              • When the subsection is hidden, Show More is displayed.
                              • When the subsection shows, the Show Less link is displayed.

                              Visibility of Smart Form Fields

                              By default, all smart form fields have the high importance setting and show on all screen sizes.

                              You can lower the level of importance for the fields to hide them on smaller screens.

                              According to the importance assigned to the field, it is displayed as follows:

                              • High (default): On all (small, medium, and large) screen sizes.
                              • Medium: On large and medium screens only.
                              • Low: On large screens only

                              For more information, see Responsiveness.

                              Related Links

                              SAP Fiori Elements

                              SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                              • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                              • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                              The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                              Video: What is SAP Fiori elements?

                              Versions

                              Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                              Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                              • SAP Fiori elements for OData version 2 (V2)
                              • SAP Fiori elements for OData version 4 (V4)

                              Usage

                              Your use case should determine whether or not the application is developed with SAP Fiori elements:

                              • Do the SAP Fiori elements floorplans deliver all the features you need to provide to the users?
                              • If not, can you provide the features with extensions to the SAP Fiori elements floorplans?
                              • If not, can you provide the features by building a freestyle app within the SAP Fiori elements framework and using SAP Fiori elements OData V4 extension capabilities?

                              Although extensions require effort to develop and maintain, they also retain benefits of the SAP Fiori elements framework that save on other efforts.

                              Information
                              The analytical list page and the overview page are only available as SAP Fiori elements.

                              Supported Floorplans

                              The following floorplans are available as SAP Fiori elements templates:

                              List report
                              List report
                              Worklist
                              Worklist
                              Object page
                              Object page
                              Overview page
                              Overview page
                              Analytical list page
                              Analytical list page

                              Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                              Supported Features

                              Both SAP Fiori elements for OData V2 and for OData V4 offer:

                              • Message handling
                              • The global edit flow, which includes draft handling
                              • Keyboard shortcuts for basic operations
                              • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                              • Seamless navigation across applications with the:
                                • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                  With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                  However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                              Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                              Placeholder Texts

                              Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                               

                              Placeholder Text Replaced Text
                              List Report Create Object Create Sales Order
                              Object Page New Object New Sales Order
                              Overview Page Could not perform action Unable to approve the request

                              For more information, see: Replacing Placeholder Text.

                              Developer Hint
                              For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                              Extensions

                              SAP Fiori elements may not deliver all the features required by your use case so application developers can create extensions to bridge the gaps. They can:

                              • Extend the SAP Fiori elements floorplans
                              • Extend the SAP Fiori elements application
                              • Build a freestyle application within the SAP Fiori elements framework with SAP Fiori elements for OData V4 options for extensions

                              Although extensions require efforts in development and maintenance in subsequent releases, they also retain benefits offered by the SAP Fiori elements framework that save on effort, such as navigation, binding, and usage of building blocks in the freestyle code.

                              Some extensions only take minutes of additional development time so ask application developers to evaluate the effort for the extensions required for a good user experience.

                              Extensions with SAP Fiori Elements for OData V4

                              SAP Fiori elements for OData V4 provides various ways to extend applications.

                              The flexible programming model makes it easy for application developers to implement customizations. They’re free to use SAPUI5 coding or controls in extension points and can also take advantage of building blocks and controller extensions.

                              Building Blocks

                              Building blocks result in low-maintenance and timeless software. They allow application developers to create a visual representation of application data in a convenient way.

                              Building blocks are reusable artifacts that are consistently orchestrated by the framework to ensure SAP Fiori compliance and standard application behavior like draft handling and side effects.

                              For more information and list of building blocks available, see Flexible Programming Model Explorer.

                              Developer Hint
                              You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see

                              Related Links

                              Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                              Table Toolbar

                              The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

                              For design information, see the guidelines starting with Table Overview, and see the links below.

                              Feature Availability

                               

                              List Report and Object Page Features

                               

                              Availability

                              Title Visible by default

                              You can  hide it.

                              With SAP Fiori elements for OData V4, you can show the table row count next to the title.

                              Table Personalization Actions Default, you can turn them off.
                              Application-Specific Actions Available
                              Mass Edit Available in draft-enabled applications:

                              • In both the list report and object page with SAP Fiori elements for OData V4
                              • In the list report with SAP Fiori elements for OData V2
                              Show/Hide Details Available in responsive tables
                              Actions Disabled Before Row Selection Available
                              Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                              Requires an extension with SAP Fiori elements for OData V2

                              Messages for Critical Actions Available
                              Messages for Destructive Actions Available
                              Multiple Views on a Table Available
                               

                              List Report Only Features

                               

                              Availability

                              Toolbar Sticky Behavior Default, you can turn it off.
                              Standard ActionsCreateDelete, and Export to Spreadsheet Default, you can turn them off.
                              Object Creation via an Object Page Default, you can change it.
                              Object Creation via a Dialog Available in certain conditions
                              Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
                              Copy Available

                              You determine the label on the action button.

                              Hiding Actions in Multiple Content Layout Available
                              Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
                               

                              Object Page Only Features

                               

                              Availability

                              Search Available, when the data allows it.
                              Edit Default, when the data allows it.
                              Delete Default, when the data allows it.
                              Subobject Creation via Subobject Page Default, you can change it.
                              Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
                              Create Not Visible In certain conditions
                              Inline Creation Available, in draft-enabled applications for grid and responsive tables
                              Prefilling Fields for New Object Creation Available, in draft-enabled applications
                              Copy and Paste from Microsoft Excel Available, in draft-enabled applications for grid and responsive tables, in certain conditions
                              Export to Spreadsheet With SAP Fiori elements for OData V4:

                              • Available
                              • Default, when the copy and paste from Microsoft Excel feature is enabled
                              Export to PDF Available with SAP Fiori elements for OData V4
                              Full Screen Mode for Table Display Available, not recommended
                              Segmented Button for Switching Table Views Default for a table with a maximum of three views
                              Select Control for Switching Table Views Default for a table with four or more views

                              List Report and Object Page Features

                              The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


                              Table Personalization Actions

                              By default, Sort, Group and Order actions are enabled.

                              These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

                              For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

                              Table-level view management is not a prerequisite for personalization.

                              For more information, see Table Personalization (Overview).



                              Application-Specific Actions

                              You can define these actions and the text displayed on the buttons.

                              The application team can control when the action button is displayed and enabled.

                              For application-specific actions, application teams can define custom keyboard shortcuts.

                              For more information, see:

                              Developer Hint

                              For more information on shortcuts, refer application developers to Keyboard Shortcuts.


                              Mass Edit

                              You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

                              • List report and object page with SAP Fiori elements for OData V4
                              • List report with SAP Fiori elements for OData V2

                              List Report

                              Users cannot apply the mass edit to a draft record.

                              The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

                              By default, the Edit dialog contains all the table columns that are currently visible and editable.

                              Object Page

                              When it’s enabled for a table in the object page and the object page is in edit mode, users can apply the mass edit to subobjects.

                              For more information, see Mass Edit.

                              Developer Hint
                              For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


                              Show / Hide Details

                              The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

                              After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

                              The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                              • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                              • The values in columns with low importance are first to be hidden.

                              By default in responsive tables:

                              • Key fields have the importance set to high in list reports.
                              • Other columns have the importance set to none and are handled like columns assigned medium importance.

                              You can change the level of importance.


                              Actions Disabled Until the User Selects a Row

                              You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

                              Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

                              For more information, see UI Element States.


                              Conditional Enablement of Navigation Buttons

                              With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                              With SAP Fiori elements for OData V2, this feature requires extensions.

                              For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                              Guidelines
                              Implement this feature only when the way to enable the button is obvious to end users.

                              Messages for Critical Actions

                              For actions that you set as critical, you can display one of the following after the user triggers the action:

                              • A message toast confirmation
                              • A confirmation message box to ensure the user wants to proceed with specific critical actions

                              Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                              Guidelines

                              Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                              Ask the development team whether or not the backend requires confirmations for your use case.

                              Example


                              SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                              Default Text                          “Do you really want to execute the action <Action Label>?”

                              <Action Label> is the label shown on the button.

                              “Do you really want to perform this action?
                              Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


                              Messages for Destructive Actions

                              By default, a message is displayed for confirmation of an action that will delete or destroy important data.

                              Guidelines

                              Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                              Ask the development team whether or not the backend requires confirmations for your use case.

                              Example


                              SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                              Default Text The default message reuses the title and the description defined for the object in the table.

                              • In flexible column layout: Delete object <title> <description>?

                                For example, “Delete object 12345 (Sales Order)?”

                              • In full screen mode: Delete object <title>?

                                For example, “Delete object 12345?”

                              “Do you really want to perform this action?
                              Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


                              Multiple Views for a Table

                              You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

                              For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

                              With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

                              List Report Only Features

                              The information below relates only to table toolbar actions and settings in the list report floorplan.


                              Standard Actions

                              By default, Create, Delete, and Export to Spreadsheet are enabled.

                              You can disable them.

                              You can also enable or disable the Delete button based on conditions specified in the backend.

                              Example

                              You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

                              Warning
                              In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

                              Create Object Actions

                              By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

                              Via a Dialog

                              The action opens a dialog in modal view so the user can enter the data.

                              With SAP Fiori elements for OData V2, you can:

                              • Include a maximum of eight fields in the dialog
                              • Enable filter values saved in the filter bar to prefill fields in the dialog
                              Warning
                              When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

                              Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

                              With Default Values That Prefill Fields for the New Object

                              This feature is available with:

                              • SAP Fiori elements for OData V2 for applications without draft handling
                              • SAP Fiori elements for OData V4

                              Via a Dialog with a Reference to an Existing Object of the Same Type

                              With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

                              The user:

                              1. Clicks the action button.
                                You can name the button to suit your use case.
                              2. Selects the value of the existing object to reference in the dialog.
                              3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
                              4. Completes additional fields for the new object in the object page.
                              Create from existing object
                              Create from existing object
                              Developer Hint
                              For more information, refer application developers to:

                              Copy

                              You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the current object.

                              You set the label for the button according to your use case. Otherwise, the default label is Copy.

                              In the toolbar, the Copy button is displayed after the Create button.

                              Developer Hint
                              Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

                              Hiding Actions in Multiple Content Layout

                              You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

                              For more information, see:


                              Object Page Only Features

                              The information below relates only to table toolbar actions and settings in the object page floorplan.


                              Search

                              You can enable a search on the table.

                              For more information, see Search.


                              Edit

                              By default, Edit is displayed when the business object shown in the table is editable.


                              Delete

                              By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

                              You can enable or disable the Delete action to allow users to delete only in certain conditions.

                              For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

                              When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

                              Warning
                              In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

                              Subobject Creation

                              By default:

                              • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
                              • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

                              You can:

                              • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
                              • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
                              • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
                              • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
                              Guidelines
                              Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

                              For more information, see:


                              Create Action Visibility

                              Whether or not the Create action is visible in the table toolbar depends on:

                              • The object page mode.
                              • Whether the flow is global or local.
                              • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

                               

                              Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

                              Global Flow for Draft-Enabled

                              Applications with Fiori Elements for OData V2

                              • Navigation indicators   are visible (if required).
                              • Create button is not visible.
                              • Navigation indicators   are visible (if required).
                              • Create button is visible.
                              • Navigation indicators   are visible (if required).
                              • Create button is visible.

                              Local Flow for Non-Draft Enabled Applications

                              • Navigation indicators   are visible (if required).
                              • Create button is visible.
                              • Navigation indicators   are not visible.
                              • Create button is not visible.
                              Not Supported.

                              Inline Creation

                              You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

                              The inline creation adds a new row to the table where the users can enter the subobject data.

                              By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

                              You can:

                              • Work with the development team to define a custom sort order.
                              • Enable default values to prefill the fields for the new object.

                              For more information, see Add Items.


                              Prefilling Fields for a New Object

                              You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

                              The new object must be the main object on the object page.

                              You determine both the fields to prefill and the default values for the fields.


                              Copy and Paste from Microsoft Excel

                              By default, the table toolbar for responsive and grid tables displays Paste when the following are enabled:

                              • Draft-handling for the application.
                              • Inline creation for the object page table.

                              After users copy data from a spreadsheet, they can place the focus anywhere in the table except for the cells and trigger the browser paste with the keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

                              Limitations

                              • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
                              • If there are validation errors, a dialog displays an error message so the user can take remedial action.
                              • The greater the number of records copied, the longer the paste operation takes.
                              • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
                              • Users cannot paste data into custom columns of tables.
                              • This feature is not supported for custom tables.

                              Export to Spreadsheet

                              By default, Export to Spreadsheet is enabled with the copy and paste from spreadsheet feature above.

                              You can enable the button independently of the copy and paste from Microsoft Excel.

                              The Export to Spreadsheet button allows user to export the values in the table, including values in custom columns.

                              For more information see Export to Spreadsheet.


                              Full Screen Mode for Table Display

                              You can enable full screen mode for a table. However, it is generally not recommended.

                              Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

                              For more information on the restrictions for this feature, see Maximize/Minimize.


                              Content Switch for Table Views

                              The number of views defined for a table determines the UI control that lets users switch the table views:

                              By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

                              Related Links

                              List Report – Header

                              The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

                              For design information, see the List Report Floorplan guidelines and the links below.

                              Warning
                              Put all controls for searching and filtering data in the list report filter bar.

                              Do not include the search or filter options that are available in the table header.

                              Feature Availability

                               

                              Features

                               

                              Availability

                              Page-Level View Management Default, you can turn it off.
                              Share Menu Default
                              Manual Update Mode Default
                              Live Update Mode Available with SAP Fiori elements for OData V2 only
                              Search Available
                              Filter Bar Default
                              Initial State of Header Default:

                              • Expanded on large screens
                              • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
                              Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
                              Editing Status Filter Default for draft-enabled applications
                              Input Controls for Filters Default
                              Adapt Filters UI Element
                              • Default: dialog with SAP Fiori elements for OData V2
                              • Default: popover with SAP Fiori elements for OData V4

                              Feature Details


                              Page-Level View Management

                              By default, page-level view management is enabled and the header displays a page title.

                              You can disable it.

                              Guidelines
                              If you disable page-level view management, you must display a header title.

                              For more information, see Header Title.


                              Share Menu

                              By default, the header contains the generic Share menu with the global actions Send Email and Save as Tile. It can also include the:

                              • Share in SAP Jam menu item when SAP Jam integration is configured.
                              • Chat in Microsoft Teams menu item, when the required settings have been made by the system administrators of SAP S/4HANA Cloud.

                              This feature is part of collaborative ERP (enterprise resource planning), which integrates the best of SAP S/4HANA Cloud with Microsoft Teams. It’s not available for all users.

                              When available, the menu item opens a separate window where users can directly share a link to a business application in the SAP S/4HANA Cloud system with co-workers.

                                Developer Hint
                                For more information, refer application developers to: Integrating Microsoft Teams.

                                For more information, see:


                                Update Mode

                                By default, the update mode is manual.

                                You can enable live update mode instead with SAP Fiori elements for OData V2.

                                For more information, see Live Update / Manual Update.


                                Search

                                By default, the search is disabled.

                                You can enable it.

                                Guidelines
                                Work with the development team to define the searchable properties in the data.

                                For more information, see Search.


                                Filter Bar

                                SAP Fiori elements for OData V2 uses the smart filter bar.

                                SAP Fiori elements for OData V4 uses the filter bar.

                                With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

                                • Remove all filter values

                                • Reset the value in the Editing Status filter to All

                                Warning
                                Put all controls for searching and filtering data in the list report filter bar.

                                Do not include the search or filter options that are available in the table header.

                                Initial State of Header

                                The default behavior is shown below:

                                Screen Size

                                Application Starts with Data

                                Application Starts without Data

                                S Collapsed Expanded
                                M Collapsed Expanded
                                L Expanded Expanded
                                XL Expanded Expanded

                                Pin Button

                                With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

                                The pin option keeps the header collapsed or expanded when the user scrolls.

                                The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

                                For more information see, Pinning the Header Content.


                                Editing Status Filter

                                By default, the filter is enabled for draft-enabled applications.

                                The filter values and corresponding results are as follows:

                                • All (Default value):
                                  • All saved (or active) versions of the documents for which the current user has no drafts
                                  • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
                                • All (Hiding Drafts): Only the saved objects.
                                • Own DraftDrafts that the current user can display or edit.
                                • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
                                • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
                                • No Changes: Saved versions with no corresponding draft.

                                For more information, see Draft handling.


                                Input Controls for Filters

                                You can decide which filter/input controls to use and set the following for them:

                                • The properties available as a filter criterion
                                • The labels for the filter fields
                                • The default filter values
                                • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
                                • Type-ahead for values entered
                                • Value help lists

                                You can also:

                                • Decide on the selection controls for the filters
                                • Restrict the values accepted in the field. By default, the field accepts multiple values.
                                Guidelines
                                Date Picker and Date / Time Picker

                                By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

                                When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

                                For more information refer them to: Configuring Filter Fields.

                                For more information, see:


                                Adapt Filters

                                By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

                                You can configure the following:

                                • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
                                • Additional groups for the filters
                                • Show input fields: Visible by default. You can hide the Hide value/Show value button.

                                Users can add additional fields through views.

                                The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

                                By default, the Reset button is displayed, you cannot change this.

                                For more information, see: Adapt Filters.

                                Related Links

                                Elements and Controls

                                Terminology for SAP Fiori Elements

                                To help you better communicate with application developers, this article presents:

                                • Development terms () and what you, as a designer, need to understand about them
                                • Design terms ( ) that may be unfamiliar to application developers and ways to present design requirements that are meaningful to application developers
                                • Terms that both application developers and designers use ( ), but for different concepts, which sometimes results in misunderstanding

                                 

                                 

                                Term

                                 

                                Explanation

                                Action Placement

                                Action placement is an important focus in design. You place the action as close to the information that it acts upon so users find them where they need them.

                                 However, because the SAP Fiori elements framework determines where the action is displayed, application developers do not specify the placement with annotations.

                                For example, they may not be familiar with what you mean by a “finalizing action” in a list report. To implement this type of action, they use the annotation property determining=true.

                                Below, you can find additional examples of the differences between designer terminology for actions and how the application developers implement them.

                                 

                                Design Terminology Application Development Annotations
                                A finalizing action that leaves the current state or navigates away from the page. Determining = true
                                An action in a table row or line item that:

                                • Affects an individual table row or line item.
                                • Triggers functionality or toggle states.
                                Inline = true
                                A table action that:

                                • Affects the table.
                                • Is displayed in the table toolbar
                                Determining = false

                                False is the default value for the property.

                                A global action in the toolbar header that

                                • Changes a state or mode
                                • Opens other related apps or tools
                                Not applicable. Implementation requires an extension.

                                 

                                Annotations
                                  

                                Application developers configure the required controls and their behavior with annotations that provide information about the application data.

                                For example, annotations and their properties control the:

                                • Display and position of columns in a table
                                • Sort order for the table rows
                                • Measures, dimensions, and sort order in a chart
                                • Enablement of a navigation button always or only after the user has selected an item

                                Application developers can also configure the required controls and their behavior through the manifest file.

                                App States
                                  

                                App states include the:

                                • Inner app (iApp) state for navigating within the application
                                • External app (xApp) state for navigating from one app to another

                                IApp State

                                When a user navigates within an application, the iApp state stores all the information to retrieve for a specific URL when the user returns to it, for example:

                                • Filters applied
                                • Visible table columns
                                • Sort orders applied

                                The user can return to the URL via

                                • A refresh
                                • Back navigation
                                • A tile created with Save as Tile
                                • A link shared with Send email

                                XApp State

                                When a user navigates from one source app to another target app, the xApp state stores all the information from the source app to pass the target app, for example:

                                • Filter values
                                • Values of the fields in the selected rows
                                • Page context
                                • Sort order of the table in the source app
                                • Other aspects of the presentation

                                Also see: Navigation

                                Asynchronous Actions
                                  

                                Actions that the backend can execute sometime after the users initially trigger it.

                                Users can continue to work on the UI without any interruption to their flow.

                                Also see: Synchronous Actions

                                Column in a Table

                                  Application developers probably know this term, but may not connect it with the annotations required for columns.

                                To configure a table, application developers use the LineItem annotation and the datafield property, where each property displays as a column in the table.

                                For more information, you can refer them to Defining Line Items.

                                Content Switches

                                Icon tab bar
                                Segmented button
                                Select control

                                These design terms may not be meaningful to developers because they don’t specify the UI control that lets the user switch among views in a list report.

                                Instead, the SAP Fiori elements framework automatically renders the switch control based on the number of business objects shown in the views and the number of views:

                                Content Switch Number of Business Objects Number of Views Example
                                Segmented button 1 3 maximum Business object: sales orders

                                Each view shows the sales orders prefiltered according to a different status: draft, estimated, ordered, packed, delivered, completed

                                Select control 1 4 or more Business object: sales orders

                                Each view shows the sales orders prefiltered according to a different status: draft, estimated, ordered, packed, delivered, completed

                                Icon tab bar More than 1 More than 1 Business objects: customers, deliveries, invoices, payments

                                The list report shows a customer overview where each view shows the deliveries, invoices and payments.

                                For more information, see List Report – Content Area.

                                Entity
                                  

                                An entity in a data model corresponds to a business object in an application.

                                For example, for a sales order processing application, the sales order is an entity and the sales order item is its child entity in the data model.

                                This parent-child association in the data model lets users navigate from the sales order to the sales order item in the application interface.

                                Facet
                                 

                                As a designer, you use the word facet for a UI element specific to the object page header.

                                  Developers use the word facet more generically to describe a unit for building for the object page so don’t be surprised to hear application developers speaking about “facets” for parts of the object page outside of the header.

                                For example, they use the annotation ReferenceFacet for what designers call a subsection and CollectionFacet for a section that contains all the subsections.

                                When you talk to application developers about a “facet,” specify where you want it to display.

                                Manifest
                                  

                                The main configuration file for an application where application developers define settings for the application and the interface behavior.

                                For example, in the manifest, an application developer can configure:

                                • A filter field to be displayed on the UI as both a compact filter field in the filter bar and a visual filter.
                                • A table to allow the selection of one or more table rows.

                                Application developers can also configure the required controls and their behavior through annotations.

                                Navigation: Internal, External, Outbound, Inbound
                                  

                                • Internal navigation

                                Navigation within an app — for example, from a list report to an object page to a subobject page: The application uses an inner app (iApp) state to store the page state and context and restore the same page state and context:

                                  • After users navigate away from the page and, then, return to it with a back navigation.
                                  • When users go to the page from a tile created with Save as Tile or from a link shared with Send email.
                                • External navigation

                                Navigation across applications — for example, from Managing Sales Orders to Managing Deliveries — uses the external app (xApp) state to pass the context from the source app to the target app.

                                Just as an outbound train leaves the station and an inbound train arrives at the station:

                                  • Outbound navigation is when the user leaves an analytical list page, list report or object page in the current app for another app.
                                  • Inbound navigation is when the user arrives at the analytical list page, list report, or object page in the current app from another app.

                                OData Services
                                  

                                OData (Open Data Protocol) is a standard protocol used by the backend to communicate with the user interface.

                                OData services deliver one or more functionalities or capabilities on the backend system, such as the retrieval of data or execution of a series of actions. The code for the services can be reused for various purposes by different client applications.

                                SAP Fiori elements support different versions of OData, as their names indicate:

                                • SAP Fiori elements for OData version 2 (V2)
                                • SAP Fiori elements for OData version 4 (V4)

                                Paginator Buttons
                                  

                                Known by designers as paging buttons ( ) in the object page header toolbar, they let users navigate to the previous or next object page shown in the list report.

                                For more information, see: Header Toolbar

                                Section

                                 This designer term may not be meaningful to some application developers because they do not use it in their annotations.

                                Instead, to build an object page section, application developers use different types of facet annotations. They start with a facet, add a reference facet, and add other controls for a form, table, or chart.

                                For more information, you can refer them to Defining and Adapting Sections.

                                Semantic Key Field
                                  

                                This field is the unique identifier for an object used by the search to find the object.

                                SideEffects
                                  

                                When a user edits an object, changes to the object can impact other object properties.

                                For example, in an employee record, changing the value for City in the employee address makes the value in the State or Region field invalid.

                                Smart Controls and Control Library
                                  

                                These UI controls can read both the data from the backend and the annotations on that data.

                                Consequently, they take the annotations into account in their rendering and behavior.

                                For example, a smart field isn’t displayed on the UI if it’s marked with the annotation to hide it, UI.Hidden.

                                SAP Fiori elements for OData V2 uses smart controls.

                                SAP Fiori elements for OData V4 uses a different control library.

                                Synchronous Actions
                                  

                                An action that the backend executes immediately after the users trigger it and, thus, blocks them from performing other actions on the interface until the execution is complete.

                                Also see: Asynchronous Actions

                                textArrangement
                                  

                                An annotation property that controls the display of text associated with an ID field, such as country and country code. It can set the display of:

                                • Only the text: Germany
                                • First the text, then the ID: Germany (001)
                                • First the ID, then the text: 001 (Germany)

                                Table Rows

                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                Feature Availability

                                   
                                 

                                Actions

                                 

                                Availability

                                Inline Actions Available
                                Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                • Available with SAP Fiori elements for OData V4
                                • Requires an extension with SAP Fiori elements for OData V2
                                Single Item Selection Default
                                Multiple Item Selection Available
                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                Delete Available in responsive tables only
                                Custom Actions Available
                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                 

                                Display

                                 

                                Availability

                                Empty Rows Available for responsive and grid tables in an object page in create and edit modes.
                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                Rating Indicator Available
                                Progress Indicator Available
                                Quick Contact View Available
                                Avatar Available
                                Avatar Tooltip Available
                                Other Images Available with live box mode only
                                Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                                In edit mode, the multiple values are displayed, but not editable.

                                The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                Highlighting Line Items Based on Criticality Available
                                 

                                Responsive Table Only

                                 

                                Availability

                                Multiple Fields in a Single Column Available
                                Smart Micro Chart Available

                                Actions

                                Inline Actions

                                You can define actions for table rows or inline items. The action types can be:

                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                Direct Edit

                                You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                                This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                                Conditional Enablement of Navigation Buttons

                                In list reports and object pages:

                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                Guidelines
                                Implement this feature only when the way to enable the button is obvious to end users.

                                Item Selection

                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                • One table row for a toolbar action, using a radio button.
                                • Multiple table rows for a toolbar action, using checkboxes.
                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                  For complete information, see: Select All / Clear All.
                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                SAP Fiori elements for OData V2

                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                SAP Fiori elements for OData V4

                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                • In display mode, item selection is not possible.
                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                Instead, you can enable one of the following selection modes:

                                • None:
                                  • Display mode allows no item selection.
                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                • Single: Both display and edit modes allow single item selection.
                                • Multi: Both display and edit modes allow multiple item selection.
                                Warning
                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                For more information, see:

                                Developer Hint
                                For more information, refer the development team to:


                                Delete

                                In responsive tables only, you can:

                                • Display an inline delete action.
                                • Prevent the deletion of certain rows.

                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                For more information, see Delete Single Item Rows.


                                Custom Actions

                                You can define custom inline actions.

                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                Messages for Critical Actions

                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                • A message toast confirmation
                                • A confirmation message box to check the users want to proceed with specific critical actions

                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                Guidelines
                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                Ask the development team whether or not the backend requires confirmations for your use case.

                                Example


                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                Default Text “Do you really want to execute the action <Action Label>?”

                                <Action Label> is the label shown on the button.

                                “Do you really want to perform this action?
                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                Display

                                You can include the display features described below in a table row or inline item.


                                Empty Rows

                                With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display two empty rows where the user can enter data for subobjects. The purpose of displaying two empty rows is to give the user a choice between entering data for one column at a time or for one row at a time.

                                You can enable the feature at the table level in draft-enabled applications.

                                • Inline actions, such as delete or navigation to the item via the chevron are hidden on the empty rows.
                                • Sorting and grouping are not applicable for the empty rows because they don’t exist in a table on the back end.

                                As soon as the user has entered data in one field in an empty row and moved the focus away from that field:

                                • The row with the completed field is highlighted with a blue line to its left to show it’s a newly created draft.
                                • The row displays the navigation chevron. Deletion also supported for the row.
                                • A new empty row is added under the highlighted row so two empty rows are always available for data entry.

                                You can set default values to populate fields in the empty rows.

                                With both SAP Fiori elements for OData V2 and V4, the empty rows are displayed:

                                • At the end of a grid table.
                                  The Create button in the toolbar scrolls to the first empty row at the end of the table and puts the focus on the first editable field.
                                • At the top of the responsive table.
                                  The toolbar has no Create button.

                                Read-Only Field

                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                Editing Status

                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                You can also add the semantic key to the status.

                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                The user can change the placement of the column through table personalization.

                                For more information, see Tables.


                                Rating Indicator

                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                With extensions, you can enable editing of the rating indicator

                                For more information, see Rating Indicator.


                                Progress Indicator

                                You can:

                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                For more information, see Progress Indicator.


                                Quick Contact View

                                You can add a quick view to a contact to display key contact details in a popover.

                                For more information, see Quickview.


                                Avatar and Other Images

                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                Warning
                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                For more information, see Avatar.


                                Highlighting Line Items

                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                You can also define highlighting and icons for line items based on their criticality.

                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                • Green for success (criticality value 3)
                                • Yellow for warning (criticality value 2)
                                • Red for error (criticality value 1)
                                • No highlighting for no criticality (criticality value 0)

                                Display in Responsive Table Only

                                In a responsive table, you can include the display features described below in a table row or inline item.


                                Multiple Fields in a Single Column

                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                For example, you can display the following in a single column:

                                • Company name
                                • Company ID
                                • Items in Stock
                                • Progress Indicator for Items in Stock
                                • Overall value of the Items
                                • Multiple Action buttons that allow the user to both:
                                  • Execute an action while staying on the list report page
                                  • Navigate to other objects and applications

                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                Field Labels

                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                Limitation on Export to Spreadsheet

                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                Information

                                Write a short and meaningful message.


                                Smart Micro Chart

                                You can:

                                • Add an inline micro chart.
                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                You can choose among the following micro chart types:

                                • Area micro chart
                                • Bullet micro chart
                                • Line micro chart
                                • Micro chart/smart micro chart
                                • Radial micro chart
                                • Stacked bar micro chart
                                Warning
                                The user cannot navigate to another page from the chart.

                                For more information on chart types, see: Choosing the Correct Chart Type.

                                Related Links

                                Object Page – Header

                                The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                For design information, see the Object Page Floorplan guidelines and the links below.

                                Warning
                                Always build the object page using the dynamic page header.

                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                Feature Availability

                                 

                                Behavior and Interaction

                                 

                                Availability

                                Expanded State Default on initial load
                                Collapsed State Default on scroll

                                With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                Header Content Display in Display Mode In the header content area
                                Header Content Display in Edit and Create Modes When the header is editable:

                                • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                                • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                                Header Content Visible Default, you can hide it.
                                Header Content Hidden Available
                                Header Field Editability By default, in edit mode the header is:

                                • Not editable with SAP Fiori elements for OData V2
                                • Editable with SAP Fiori elements for OData V4

                                You can change the default.

                                Highlighting Values Based on Criticality Available
                                 

                                Components

                                 

                                Availability

                                Dynamic Page Header Mandatory, it must be configured.
                                Title Mandatory, you must define it.
                                Menu for Saved Version / Draft Default for draft-enabled applications
                                Breadcrumbs Default
                                Subtitle Available, you define the text.
                                Object Marker Default in draft-enabled applications
                                Image Available
                                Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                Paging Buttons on the First Subobject Page Default under certain conditions
                                Toolbar Available
                                 

                                Toolbar Actions

                                 

                                Availability

                                Edit and Delete Default, when the data allows these actions.

                                You can turn one or both actions off.

                                Copy Available with SAP Fiori elements for OData V2
                                Related Apps Menu Button Available

                                With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                Application-Specific Actions Available,  they must be configured.
                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                Requires an extension with SAP Fiori elements for OData V2

                                Order of Toolbar Actions Default

                                You can change the default order.

                                 

                                Additional Content (Optional)

                                 

                                Availability

                                Message Strip Available with SAP Fiori elements for OData V4 to provide information related to the object as a whole, such as the object status
                                Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                Plain Text Facets Available
                                Contact Facets Available
                                Micro Chart Facets Available
                                Form Facets Available
                                Address Facets Available
                                Header Field Group Available
                                Rating Indicator Facets Available
                                Progress Indicator Facet Available
                                Key Value Facet Available
                                Link Available

                                With SAP Fiori elements for OData V2:

                                • The default link shows the text and ID. You can remove the text or the ID from the link.
                                • You can include a link that navigates to a site external to the application.

                                Behavior and Interaction


                                Collapsed/Expanded State

                                When the object page header contains at least one facet:

                                • On the initial load of the object page, the header is expanded.
                                • When the user scrolls down the page, the header collapses.
                                • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                Next to the title, an arrow   button lets the users expand the header.

                                Summary Line for Object Page Header on Small Screens
                                Summary Line for Object Page Header on Small Screens

                                Display of Header Content

                                In display mode, the header content area displays all the header content.

                                In edit and create modes, when the header is:

                                • Editable
                                  • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                                The header section is only present in the edit and create modes.

                                  • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                                 

                                • Not Editable, the header is hidden.

                                Note that, by default, the header is

                                • Editable with SAP Fiori elements for OData V4
                                • Not editable with SAP Fiori elements for OData V2

                                You can ask the application developers to change the default.

                                For more information, see Dynamic Page Header (Mandatory).

                                Developer Hint
                                To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                Header Content Visibility

                                By default, header content is visible.

                                You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                • Entire header facets
                                • Content, such as fields, in a header facet
                                • Content in quick views

                                With Fiori elements for OData V2, you can set:

                                • The header to be displayed in edit mode.
                                • Header facets to be visible in edit mode.
                                Developer Hint
                                For more information on the features, refer the development team to:


                                Header Field Editability

                                By default, in edit mode the header is:

                                • Not editable with SAP Fiori elements for OData V2
                                • Editable with SAP Fiori elements for OData V4

                                You can change the default.

                                Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                                Developer Hint
                                To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                Highlighting Values Based on Criticality

                                You can assign colors and icons to text to indicate the criticality of a field value.

                                With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                                You can display the following microcharts in the header:

                                • Area micro chart
                                • Bullet chart
                                • Radial chart
                                • Column chart
                                • Line micro chart
                                • Harvey ball chart
                                • Stacked bar chart

                                Components


                                Title

                                By default, with:

                                •  SAP Fiori elements for OData V2, the title area is empty.
                                •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                Guidelines
                                Tell the developers which property to use as the title.

                                Menu for Saved Version / Draft

                                With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                Breadcrumbs

                                Breadcrumbs are displayed above the object title.

                                Guidelines
                                Limit the breadcrumbs to the drilldown levels within the object page.

                                Object Marker

                                The object marker indicates the object is locked by another user in draft-enabled applications.


                                Image

                                The image is an avatar control. By default, it has a square shape.

                                You can set:

                                • An image to display instead of the avatar.
                                • The avatar to a have a circular shape.

                                When no image is set or found for the avatar, the avatar initials are displayed.

                                If those are not set or found either, an icon for the avatar is displayed:

                                • A square avatar for a product
                                • A circular avatar for a person.

                                For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                Paging Buttons

                                By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                • The user has navigated from a table in the object page to the subobject.
                                • The table in the object page contains at least two items.

                                With SAP Fiori elements for OData V2, you can:

                                • Enable the paging buttons to show on the first object page opened from a list report.
                                • Disable the default display of the paging buttons on the subobject page.

                                Toolbar Actions


                                Edit and Delete

                                By default, these actions are displayed when the data in the object page allows them.

                                You can:

                                • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                • Disable the actions.

                                For more information, see:


                                Copy

                                You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                In the object page, the Copy button is displayed after the Delete button.

                                Developer Hint
                                Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                Related Apps Menu Button

                                You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                You can also:

                                • Hide specific actions in the menu.
                                • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                Generic Actions

                                By default, the Share button is displayed for saved objects and hidden for drafts.

                                For more information, see Share (Generic).


                                Application-Specific Actions

                                You can include the actions required for your use case.

                                The header toolbar displays application-specific actions to the left of the generic actions.

                                You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                Developer Hint
                                For more information, refer application developers to Keyboard Shortcuts.

                                Conditional Enablement of Navigation Buttons

                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                Guidelines
                                Implement this feature only when the way to enable the button is obvious to end users.

                                Order of Toolbar Actions

                                The default order — left to right — for actions in the object page toolbar is below:

                                • Edit
                                • Delete
                                • Copy with SAP Fiori elements for OData V2
                                • Application-specific action buttons
                                • Related Apps menu button
                                • Share

                                You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                For more information, see:

                                Additional Content


                                Message Strip

                                With SAP Fiori elements for OData V4, you can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                                The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                                When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                                The user can find the individual messages via the message popover in the footer bar.

                                For more information, see:

                                Simple Header Facets

                                With SAP Fiori elements for OData V2:

                                • You can use a simple header facet to show simple data points that align horizontally across the header.
                                • When form fields contain no value, they display the empty  state indicator (–).

                                Plain Text Facets

                                You can use the plain text facet to display a continuous text in the header.

                                For more information, see Plain Text Facet.


                                Contact Facets

                                You can enable a quick view for a contact.

                                With SAP Fiori elements for OData V4:

                                • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                                • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                                For more information, see Quick View.


                                Micro Chart Facets

                                For more information, see Micro Charts.


                                Form Facets

                                You can add a quick view to the form facet.

                                For more information, see Form Facet (Dataset).

                                Developer Hint
                                For more information, refer the development team to Form Facet.

                                Address Facets

                                You can display an address such as a shipping address.

                                Developer Hint
                                For more information, refer the development team to Address Facet in the Object Page Header.

                                Header Field Groups

                                You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                Rating Indicator Facets

                                You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                By default, the maximum rating is five stars.

                                You can:

                                • Change the maximum rating.
                                • Specify more descriptive text for the subtitle.

                                With extensions, you can make the rating editable.

                                Display Mode

                                The rating indicator shows with the:

                                • Title
                                • Subtitle with the total number of ratings
                                • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                Edit Mode

                                The rating indicator moves into the header facet and appears with only the title in edit mode.

                                For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                For more information, see:


                                Progress Indicator Facets

                                You can add a progress indicator facet to the object header.

                                For more information, see:


                                Key Value Facets

                                You can add a key value facet to highlight important data or KPIs.

                                For more information, see Key Value Facet.

                                Related Links

                                SAP Fiori Elements

                                SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                Video: What is SAP Fiori elements?

                                Versions

                                Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                • SAP Fiori elements for OData version 2 (V2)
                                • SAP Fiori elements for OData version 4 (V4)

                                Usage

                                Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                • Is the floorplan you want to use supported by SAP Fiori elements?
                                • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                Supported Floorplans

                                The following floorplans are available as SAP Fiori elements templates:

                                List report
                                List report
                                Worklist
                                Worklist
                                Object page
                                Object page
                                Overview page
                                Overview page
                                Analytical list page
                                Analytical list page

                                Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                Supported Features

                                Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                • Message handling
                                • The global edit flow, which includes draft handling
                                • Keyboard shortcuts for basic operations
                                • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                • Seamless navigation across applications with the:
                                  • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                  • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                    With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                    However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                Placeholder Texts

                                Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                 

                                Placeholder Text Replaced Text
                                List Report Create Object Create Sales Order
                                Object Page New Object New Sales Order
                                Overview Page Could not perform action Unable to approve the request

                                For more information, see: Replacing Placeholder Text.

                                Developer Hint
                                For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                Extensions

                                It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                Developer Hint
                                You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                Related Links

                                Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                Table Rows

                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                Feature Availability

                                   
                                 

                                Actions

                                 

                                Availability

                                Inline Actions Available
                                Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                • Available with SAP Fiori elements for OData V4
                                • Requires an extension with SAP Fiori elements for OData V2
                                Single Item Selection Default
                                Multiple Item Selection Available
                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                Delete Available in responsive tables only
                                Custom Actions Available
                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                 

                                Display

                                 

                                Availability

                                Empty Rows Available for responsive and grid tables in an object page in create and edit modes.
                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                Rating Indicator Available
                                Progress Indicator Available
                                Quick Contact View Available
                                Avatar Available
                                Avatar Tooltip Available
                                Other Images Available with live box mode only
                                Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                                In edit mode, the multiple values are displayed, but not editable.

                                The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                Highlighting Line Items Based on Criticality Available
                                 

                                Responsive Table Only

                                 

                                Availability

                                Multiple Fields in a Single Column Available
                                Smart Micro Chart Available

                                Actions

                                Inline Actions

                                You can define actions for table rows or inline items. The action types can be:

                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                Direct Edit

                                You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                                This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                                Conditional Enablement of Navigation Buttons

                                In list reports and object pages:

                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                Guidelines
                                Implement this feature only when the way to enable the button is obvious to end users.

                                Item Selection

                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                • One table row for a toolbar action, using a radio button.
                                • Multiple table rows for a toolbar action, using checkboxes.
                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                  For complete information, see: Select All / Clear All.
                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                SAP Fiori elements for OData V2

                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                SAP Fiori elements for OData V4

                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                • In display mode, item selection is not possible.
                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                Instead, you can enable one of the following selection modes:

                                • None:
                                  • Display mode allows no item selection.
                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                • Single: Both display and edit modes allow single item selection.
                                • Multi: Both display and edit modes allow multiple item selection.
                                Warning
                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                For more information, see:

                                Developer Hint
                                For more information, refer the development team to:


                                Delete

                                In responsive tables only, you can:

                                • Display an inline delete action.
                                • Prevent the deletion of certain rows.

                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                For more information, see Delete Single Item Rows.


                                Custom Actions

                                You can define custom inline actions.

                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                Messages for Critical Actions

                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                • A message toast confirmation
                                • A confirmation message box to check the users want to proceed with specific critical actions

                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                Guidelines
                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                Ask the development team whether or not the backend requires confirmations for your use case.

                                Example


                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                Default Text “Do you really want to execute the action <Action Label>?”

                                <Action Label> is the label shown on the button.

                                “Do you really want to perform this action?
                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                Display

                                You can include the display features described below in a table row or inline item.


                                Empty Rows

                                With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display two empty rows where the user can enter data for subobjects. The purpose of displaying two empty rows is to give the user a choice between entering data for one column at a time or for one row at a time.

                                You can enable the feature at the table level in draft-enabled applications.

                                • Inline actions, such as delete or navigation to the item via the chevron are hidden on the empty rows.
                                • Sorting and grouping are not applicable for the empty rows because they don’t exist in a table on the back end.

                                As soon as the user has entered data in one field in an empty row and moved the focus away from that field:

                                • The row with the completed field is highlighted with a blue line to its left to show it’s a newly created draft.
                                • The row displays the navigation chevron. Deletion also supported for the row.
                                • A new empty row is added under the highlighted row so two empty rows are always available for data entry.

                                You can set default values to populate fields in the empty rows.

                                With both SAP Fiori elements for OData V2 and V4, the empty rows are displayed:

                                • At the end of a grid table.
                                  The Create button in the toolbar scrolls to the first empty row at the end of the table and puts the focus on the first editable field.
                                • At the top of the responsive table.
                                  The toolbar has no Create button.

                                Read-Only Field

                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                Editing Status

                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                You can also add the semantic key to the status.

                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                The user can change the placement of the column through table personalization.

                                For more information, see Tables.


                                Rating Indicator

                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                With extensions, you can enable editing of the rating indicator

                                For more information, see Rating Indicator.


                                Progress Indicator

                                You can:

                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                For more information, see Progress Indicator.


                                Quick Contact View

                                You can add a quick view to a contact to display key contact details in a popover.

                                For more information, see Quickview.


                                Avatar and Other Images

                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                Warning
                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                For more information, see Avatar.


                                Highlighting Line Items

                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                You can also define highlighting and icons for line items based on their criticality.

                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                • Green for success (criticality value 3)
                                • Yellow for warning (criticality value 2)
                                • Red for error (criticality value 1)
                                • No highlighting for no criticality (criticality value 0)

                                Display in Responsive Table Only

                                In a responsive table, you can include the display features described below in a table row or inline item.


                                Multiple Fields in a Single Column

                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                For example, you can display the following in a single column:

                                • Company name
                                • Company ID
                                • Items in Stock
                                • Progress Indicator for Items in Stock
                                • Overall value of the Items
                                • Multiple Action buttons that allow the user to both:
                                  • Execute an action while staying on the list report page
                                  • Navigate to other objects and applications

                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                Field Labels

                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                Limitation on Export to Spreadsheet

                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                Information

                                Write a short and meaningful message.


                                Smart Micro Chart

                                You can:

                                • Add an inline micro chart.
                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                You can choose among the following micro chart types:

                                • Area micro chart
                                • Bullet micro chart
                                • Line micro chart
                                • Micro chart/smart micro chart
                                • Radial micro chart
                                • Stacked bar micro chart
                                Warning
                                The user cannot navigate to another page from the chart.

                                For more information on chart types, see: Choosing the Correct Chart Type.

                                Related Links

                                List Report – Header

                                The SAP Fiori elements list report template supports the features and settings for the list report header detailed below.

                                For design information, see the List Report Floorplan guidelines and the links below.

                                Warning
                                Put all controls for searching and filtering data in the list report filter bar.

                                Do not include the search or filter options that are available in the table header.

                                Feature Availability

                                 

                                Features

                                 

                                Availability

                                Page-Level Variant Management Default, you can turn it off.
                                Share Menu Default
                                Manual Update Mode Default
                                Live Update Mode Available with SAP Fiori elements for OData V2 only
                                Search Available
                                Filter Bar Default
                                Initial State of Header Default:

                                • Expanded on large screens
                                • Collapsed on medium and small screens when the application is configured to load the list report data on app launch
                                Pin Button With SAP Fiori elements for OData V4, turned on when the list report contains at least one responsive table.
                                Editing Status Filter Default for draft-enabled applications
                                Input Controls for Filters Default
                                Adapt Filters UI Element
                                • Default: dialog with SAP Fiori elements for OData V2
                                • Default: popover with SAP Fiori elements for OData V4

                                Feature Details


                                Page-Level Variant Management

                                By default, page-level variant management is enabled and the header displays a page title.

                                You can disable it.

                                Guidelines
                                If you disable page-level variant management, you must display a header title.

                                For more information, see Header Title.


                                Share Menu

                                By default, the header contains:

                                • The generic Share menu with the global actions Send Email and Save as Tile.  
                                • Share in SAP Jam, when SAP Jam integration is configured.

                                For more information, see:


                                Update Mode

                                By default, the update mode is manual.

                                You can enable live update mode instead with SAP Fiori elements for OData V2.

                                For more information, see Live Update / Manual Update.


                                Search

                                By default, the search is disabled.

                                You can enable it.

                                Guidelines
                                Work with the development team to define the searchable properties in the data.

                                For more information, see Search.


                                Filter Bar

                                SAP Fiori elements for OData V2 uses the smart filter bar.

                                SAP Fiori elements for OData V4 uses the filter bar.

                                With SAP Fiori elements for OData V4, you can also show a Clear button on the filter bar to let users:

                                • Remove all filter values

                                • Reset the value in the Editing Status filter to All

                                Warning
                                Put all controls for searching and filtering data in the list report filter bar.

                                Do not include the search or filter options that are available in the table header.

                                Initial State of Header

                                The default behavior is shown below:

                                Screen Size

                                Application Starts with Data

                                Application Starts without Data

                                S Collapsed Expanded
                                M Collapsed Expanded
                                L Expanded Expanded
                                XL Expanded Expanded

                                Pin Button

                                With SAP Fiori elements for OData V4, the Pin  /Unpin   buttons are displayed under the header when a list report contains at least one responsive table,

                                The pin option keeps the header collapsed or expanded when the user scrolls.

                                The grid table and the analytical tables are not scrollable so the Pin  /Unpin  buttons are not displayed when the list report contains only these types of table.

                                For more information see, Pinning the Header Content.


                                Editing Status Filter

                                By default, the filter is enabled for draft-enabled applications.

                                The filter values and corresponding results are as follows:

                                • All (Default value):
                                  • All saved (or active) versions of the documents for which the current user has no drafts
                                  • All the users own drafts of unsaved changes to existing documents. The version last saved before the user began editing the draft is not shown in the results.
                                • All (Hiding Drafts): Only the saved objects.
                                • Own DraftDrafts that the current user can display or edit.
                                • Locked by Another User: Saved versions that are locked by other users. The current user cannot edit these versions.
                                • Unsaved Changes by Another User: Saved versions that were edited by another user but are no longer locked. The current user can edit and overwrite these versions, and the previous draft will be overwritten.
                                • No Changes: Saved versions with no corresponding draft.

                                For more information, see Draft handling.


                                Input Controls for Filters

                                You can decide which filter/input controls to use and set the following for them:

                                • The properties available as a filter criterion
                                • The labels for the filter fields
                                • The default filter values
                                • Mandatory filters: Marked by an asterisk (*), they always show in the filter bar.
                                • Type-ahead for values entered
                                • Value help lists

                                You can also:

                                • Decide on the selection controls for the filters
                                • Restrict the values accepted in the field. By default, the field accepts multiple values.
                                Guidelines
                                Date Picker and Date / Time Picker

                                By default, filter fields for the date picker (sap.m.DatePicker)and date/time picker (sap.m.DateTimePicker) result in a control that opens a dialog for adding multiple dates.

                                When your use case requires a date/time picker for a single value, specify this to the the application developers because it requires explicit configuration.

                                For more information refer them to: Configuring Filter Fields.

                                For more information, see:


                                Adapt Filters

                                By default, SAP Fiori elements for OData V2 uses the Adapt Filters dialog and SAP Fiori elements for OData V4 uses the Adapt Filters popover.

                                You can configure the following:

                                • Filters that are initially visible in the expanded filter bar. When you set filters to be visible by default, they are displayed under the Basic group in the dialog.
                                • Additional groups for the filters
                                • Show input fields: Visible by default. You can hide the Hide value/Show value button.

                                Users can add additional fields through variants.

                                The OK and Cancel buttons are displayed when the application team or the user has chosen manual update mode for the filter bar.

                                By default, the Reset button is displayed, you cannot change this.

                                For more information, see: Adapt Filters.

                                Related Links

                                Elements and Controls

                                Object Page – Content Area

                                The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                For design information, see the Object Page Floorplan guidelines and the links below.

                                Feature Availability

                                 

                                Content Area

                                 

                                Availability

                                Draft Object Validation Default

                                Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                                Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                Navigation Bar: Tab Bar Available
                                Sections and Subsections Available
                                Reuse Components as Sections Available
                                 

                                Subsections

                                 

                                Availability

                                Link Available

                                With SAP Fiori elements for OData V4, you can display an icon or image with the link.

                                With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                Tables Available
                                Smart Charts Available
                                Variant Management for Tables and Charts Enabled by default  for each table and chart in the page.

                                You can change the default.

                                Address Available
                                Display of Related Properties Together Available with SAP Fiori elements for OData for V4

                                The properties can also display as links.

                                Forms Available
                                Text Control With SAP Fiori elements V4, in edit mode, the default length of the text entry area allows for four lines of text.

                                You can:

                                • Change the maximum
                                • Enable growing mode
                                • Show users the number of characters allowed in the text area
                                File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                Dynamic Side Content Available with an extension
                                 

                                Subsection Behavior

                                 

                                Availability

                                Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                Adjustment of the Width for Content Display in a Subsection Available
                                 

                                Content Visibility

                                 

                                Availability

                                Visible Sections, Subsections, Quickviews, and Tables Default
                                Hiding Section, Subsection, Quickview and Table Content Available
                                User-Controlled Visibility with Show More/Show Less Available
                                Visible Smart Form Fields Default, you can hide them in certain conditions.

                                Content Area

                                Navigation Bar

                                By default, the anchor bar is generated when the object page has at least one section.

                                It lets users navigate to the individual content area sections.

                                You can:

                                • Hide the anchor bar when you only have one section.
                                • Replace it with a tab bar.

                                With extensions, you can replace the buttons with another type of control.

                                For more information, see:

                                Sections and Subsections

                                You can add sections and subsections to the content area.

                                Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                For more information, see: Sections and Subsections.

                                Reuse Components as Sections

                                You can embed a reuse component as a section in the object page.

                                Warning
                                A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                Consult the development team on the requirements for the reuse component.

                                Subsections

                                With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                The smart link contact can include a contact list and a quickview of the contact details.

                                For more information, see:

                                Tables

                                You can include a table in a subsection.

                                For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                                Smart Charts

                                You can include a single smart chart facet in a subsection.

                                In a smart chart, you can:

                                • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                For more information, see Smart Chart.

                                Variant Management for Tables and Charts

                                By default, variant management is turned on for each table and chart on the page at the control level.

                                You can ask the application development team to turn it off.

                                For more information, see Views (Variant Management).

                                Address

                                You can add one or more address fields:

                                • As a separate subsection
                                • As part of a field group within a subsection
                                • To a quick view with smart link navigation

                                For more information, see:

                                Display of Related Properties Together

                                You can display two related properties side-by-side and with a single label in display mode.

                                For example, the label Date Time can display with the properties date and time side-by-side, even when they are distinct properties in the back end.

                                You can separate the values with a delimiter such as a slash (/) or a hyphen (-).

                                In edit mode, the fields can be edited separately.

                                Side-by-side display of related properties
                                Side-by-side display of related properties

                                Related Properties as Links

                                The related properties can also display as links.

                                Developer Hint
                                Application developers call the related properties semantically connected fields. For more information on this feature, you can refer them to Grouping of Fields.
                                Related properties as links
                                Related properties as links

                                Forms

                                You can add action buttons to the toolbar for a form contained in a subsection.

                                With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                The action types can be:

                                • Actions that occur in the system while the user stays on the object page.
                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                Conditional Enablement of Navigation Buttons

                                You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                Guidelines
                                Implement this feature only when the way to enable the button is obvious to end users.

                                Columns in a Form

                                To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                                 

                                Column Number

                                Screen Size

                                1 Small
                                2 Medium
                                3 Large
                                6 Extra large
                                Guidelines
                                The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                                Groups in a Form

                                You can group fields in a form and assign a name to the group.

                                Note that the group name is displayed only when a group contains fields.

                                User-Controlled Load of Fields with Low Importance

                                To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                                After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                                Text Control

                                By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                You can:

                                • Set a maximum number of lines for the text control that’s greater than four.
                                • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.
                                • Display below the text area the number of characters allowed in it. As the users enter text, the number decreases to show how many characters remain.

                                A notification is displayed if the users try to enter text beyond the limit.

                                In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                File Upload

                                With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                                The application developers can define the file size and types allowed for upload.

                                Dynamic Side Content

                                You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                  Guidelines

                                  • Do not use tables in the side content panel.
                                  • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                  • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                  For more information, see:

                                  Developer Hint

                                  Subsection Behavior

                                  Subsection Loading Behavior

                                  By default, the subsection starts loading after the main object page elements are loaded.

                                  You can change the loading behavior to load the subsection after the header data is loaded.

                                  Example

                                  When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                                  Width for Content Display in a Subsection

                                  When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                  Content Visibility

                                  Sections, Subsections, Quickviews, and Tables

                                  By default, the object page displays these components.

                                  You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                                  User-Controlled Visibility

                                  You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                                  • When the subsection is hidden, Show More is displayed.
                                  • When the subsection shows, the Show Less link is displayed.

                                  Visibility of Smart Form Fields

                                  By default, all smart form fields have the high importance setting and show on all screen sizes.

                                  You can lower the level of importance for the fields to hide them on smaller screens.

                                  According to the importance assigned to the field, it is displayed as follows:

                                  • High (default): On all (small, medium, and large) screen sizes.
                                  • Medium: On large and medium screens only.
                                  • Low: On large screens only

                                  For more information, see Responsiveness.

                                  Related Links

                                  Object Page – Header

                                  The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                  For design information, see the Object Page Floorplan guidelines and the links below.

                                  Warning
                                  Always build the object page using the dynamic page header.

                                  Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                  Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                  Feature Availability

                                   

                                  Behavior and Interaction

                                   

                                  Availability

                                  Expanded State Default on initial load
                                  Collapsed State Default on scroll

                                  With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                  Header Content Display in Display Mode In the header content area
                                  Header Content Display in Edit and Create Modes When the header is editable:

                                  • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                                  • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                                  Header Content Visible Default, you can hide it.
                                  Header Content Hidden Available
                                  Header Field Editability By default, in edit mode the header is:

                                  • Not editable with SAP Fiori elements for OData V2
                                  • Editable with SAP Fiori elements for OData V4

                                  You can change the default.

                                  Highlighting Values Based on Criticality Available
                                   

                                  Components

                                   

                                  Availability

                                  Dynamic Page Header Mandatory, it must be configured.
                                  Title Mandatory, you must define it.
                                  Menu for Saved Version / Draft Default for draft-enabled applications
                                  Breadcrumbs Default
                                  Subtitle Available, you define the text.
                                  Object Marker Default in draft-enabled applications
                                  Image Available
                                  Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                  Paging Buttons on the First Subobject Page Default under certain conditions
                                  Toolbar Available
                                   

                                  Toolbar Actions

                                   

                                  Availability

                                  Edit and Delete Default, when the data allows these actions.

                                  You can turn one or both actions off.

                                  Copy Available with SAP Fiori elements for OData V2
                                  Related Apps Menu Button Available

                                  With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                  Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                  Application-Specific Actions Available,  they must be configured.
                                  Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                  Requires an extension with SAP Fiori elements for OData V2

                                  Order of Toolbar Actions Default

                                  You can change the default order.

                                   

                                  Additional Content (Optional)

                                   

                                  Availability

                                  Message Strip Available with SAP Fiori elements for OData V4 to provide information related to the object as a whole, such as the object status
                                  Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                  Plain Text Facets Available
                                  Contact Facets Available
                                  Micro Chart Facets Available
                                  Form Facets Available
                                  Address Facets Available
                                  Header Field Group Available
                                  Rating Indicator Facets Available
                                  Progress Indicator Facet Available
                                  Key Value Facet Available
                                  Link Available

                                  With SAP Fiori elements for OData V2:

                                  • The default link shows the text and ID. You can remove the text or the ID from the link.
                                  • You can include a link that navigates to a site external to the application.

                                  Behavior and Interaction


                                  Collapsed/Expanded State

                                  When the object page header contains at least one facet:

                                  • On the initial load of the object page, the header is expanded.
                                  • When the user scrolls down the page, the header collapses.
                                  • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                  When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                  With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                  Next to the title, an arrow   button lets the users expand the header.

                                  Summary Line for Object Page Header on Small Screens
                                  Summary Line for Object Page Header on Small Screens

                                  Display of Header Content

                                  In display mode, the header content area displays all the header content.

                                  In edit and create modes, when the header is:

                                  • Editable
                                    • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                                  The header section is only present in the edit and create modes.

                                    • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                                   

                                  • Not Editable, the header is hidden.

                                  Note that, by default, the header is

                                  • Editable with SAP Fiori elements for OData V4
                                  • Not editable with SAP Fiori elements for OData V2

                                  You can ask the application developers to change the default.

                                  For more information, see Dynamic Page Header (Mandatory).

                                  Developer Hint
                                  To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                  Header Content Visibility

                                  By default, header content is visible.

                                  You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                  • Entire header facets
                                  • Content, such as fields, in a header facet
                                  • Content in quick views

                                  With Fiori elements for OData V2, you can set:

                                  • The header to be displayed in edit mode.
                                  • Header facets to be visible in edit mode.
                                  Developer Hint
                                  For more information on the features, refer the development team to:


                                  Header Field Editability

                                  By default, in edit mode the header is:

                                  • Not editable with SAP Fiori elements for OData V2
                                  • Editable with SAP Fiori elements for OData V4

                                  You can change the default.

                                  Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                                  Developer Hint
                                  To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                  Highlighting Values Based on Criticality

                                  You can assign colors and icons to text to indicate the criticality of a field value.

                                  With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                                  You can display the following microcharts in the header:

                                  • Area micro chart
                                  • Bullet chart
                                  • Radial chart
                                  • Column chart
                                  • Line micro chart
                                  • Harvey ball chart
                                  • Stacked bar chart

                                  Components


                                  Title

                                  By default, with:

                                  •  SAP Fiori elements for OData V2, the title area is empty.
                                  •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                  Guidelines
                                  Tell the developers which property to use as the title.

                                  Menu for Saved Version / Draft

                                  With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                  Breadcrumbs

                                  Breadcrumbs are displayed above the object title.

                                  Guidelines
                                  Limit the breadcrumbs to the drilldown levels within the object page.

                                  Object Marker

                                  The object marker indicates the object is locked by another user in draft-enabled applications.


                                  Image

                                  The image is an avatar control. By default, it has a square shape.

                                  You can set:

                                  • An image to display instead of the avatar.
                                  • The avatar to a have a circular shape.

                                  When no image is set or found for the avatar, the avatar initials are displayed.

                                  If those are not set or found either, an icon for the avatar is displayed:

                                  • A square avatar for a product
                                  • A circular avatar for a person.

                                  For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                  Paging Buttons

                                  By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                  • The user has navigated from a table in the object page to the subobject.
                                  • The table in the object page contains at least two items.

                                  With SAP Fiori elements for OData V2, you can:

                                  • Enable the paging buttons to show on the first object page opened from a list report.
                                  • Disable the default display of the paging buttons on the subobject page.

                                  Toolbar Actions


                                  Edit and Delete

                                  By default, these actions are displayed when the data in the object page allows them.

                                  You can:

                                  • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                  • Disable the actions.

                                  For more information, see:


                                  Copy

                                  You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                  You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                  In the object page, the Copy button is displayed after the Delete button.

                                  Developer Hint
                                  Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                  Related Apps Menu Button

                                  You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                  You can also:

                                  • Hide specific actions in the menu.
                                  • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                  Generic Actions

                                  By default, the Share button is displayed for saved objects and hidden for drafts.

                                  For more information, see Share (Generic).


                                  Application-Specific Actions

                                  You can include the actions required for your use case.

                                  The header toolbar displays application-specific actions to the left of the generic actions.

                                  You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                  Developer Hint
                                  For more information, refer application developers to Keyboard Shortcuts.

                                  Conditional Enablement of Navigation Buttons

                                  With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                  With SAP Fiori elements for OData V2, this feature requires extensions.

                                  For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                  Guidelines
                                  Implement this feature only when the way to enable the button is obvious to end users.

                                  Order of Toolbar Actions

                                  The default order — left to right — for actions in the object page toolbar is below:

                                  • Edit
                                  • Delete
                                  • Copy with SAP Fiori elements for OData V2
                                  • Application-specific action buttons
                                  • Related Apps menu button
                                  • Share

                                  You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                  For more information, see:

                                  Additional Content


                                  Message Strip

                                  With SAP Fiori elements for OData V4, you can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                                  The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                                  When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                                  The user can find the individual messages via the message popover in the footer bar.

                                  For more information, see:

                                  Simple Header Facets

                                  With SAP Fiori elements for OData V2:

                                  • You can use a simple header facet to show simple data points that align horizontally across the header.
                                  • When form fields contain no value, they display the empty  state indicator (–).

                                  Plain Text Facets

                                  You can use the plain text facet to display a continuous text in the header.

                                  For more information, see Plain Text Facet.


                                  Contact Facets

                                  You can enable a quick view for a contact.

                                  With SAP Fiori elements for OData V4:

                                  • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                                  • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                                  For more information, see Quick View.


                                  Micro Chart Facets

                                  For more information, see Micro Charts.


                                  Form Facets

                                  You can add a quick view to the form facet.

                                  For more information, see Form Facet (Dataset).

                                  Developer Hint
                                  For more information, refer the development team to Form Facet.

                                  Address Facets

                                  You can display an address such as a shipping address.

                                  Developer Hint
                                  For more information, refer the development team to Address Facet in the Object Page Header.

                                  Header Field Groups

                                  You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                  Rating Indicator Facets

                                  You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                  By default, the maximum rating is five stars.

                                  You can:

                                  • Change the maximum rating.
                                  • Specify more descriptive text for the subtitle.

                                  With extensions, you can make the rating editable.

                                  Display Mode

                                  The rating indicator shows with the:

                                  • Title
                                  • Subtitle with the total number of ratings
                                  • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                  Edit Mode

                                  The rating indicator moves into the header facet and appears with only the title in edit mode.

                                  For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                  For more information, see:


                                  Progress Indicator Facets

                                  You can add a progress indicator facet to the object header.

                                  For more information, see:


                                  Key Value Facets

                                  You can add a key value facet to highlight important data or KPIs.

                                  For more information, see Key Value Facet.

                                  Related Links

                                  Object Page – Overview

                                  The SAP Fiori elements object page template supports the features and settings for the overall object page behavior detailed below.

                                  For design information, see the Object Page Floorplan guidelines and the links below.

                                  Warning
                                  Always build the object page using the dynamic page header.

                                  Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                  Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                  Feature Availability

                                   

                                     
                                   

                                  Features

                                   

                                  Availability

                                  Illustrated Message for Unfound Page Default

                                  See Illustrated Message.

                                  Unsaved Changes Warning Default for the main object page in draft-enabled applications when the user navigates to:

                                  • Another application without saving changes. You can turn it off.
                                  • The previous page without saving changes.

                                  Feature Details

                                  Unsaved Changes Warning

                                  By default, in draft-enabled applications, on the main object page, a message warns users of unsaved changes when the users navigate:

                                  • Forward to another application without saving changes in edit mode or without entering data for a new object in create mode.

                                  You can ask the application developers to turn the message off for forward navigation. The draft is kept for the user to return to later.

                                  • Backward to the previous page without saving changes in edit mode or the data entered for a new object in create mode.
                                  Information
                                  No message is displayed when the user navigates backward without entering data for a new object in create mode. The object is discarded.

                                  Depending on whether the object page is in edit or create mode, the message lets the users opt to:

                                  • Save changes in edit mode
                                  • Create the object in create mode
                                  • Keep the draft
                                  • Discard the draft
                                  • Cancel the navigation
                                  Warning for unsaved changes in edit mode
                                  Warning for unsaved changes in edit mode
                                  Warning for unsaved changes in create mode
                                  Warning for unsaved changes in create mode

                                  Object Page – Content Area

                                  The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                  For design information, see the Object Page Floorplan guidelines and the links below.

                                  Feature Availability

                                   

                                  Content Area

                                   

                                  Availability

                                  Draft Object Validation Default, users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.
                                  Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                  Navigation Bar: Tab Bar Available
                                  Sections and Subsections Available
                                  Reuse Components as Sections Available
                                   

                                  Subsections

                                   

                                  Availability

                                  Link Available

                                  With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                  Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                  Tables Available
                                  Smart Charts Available
                                  Variant Management for Tables and Charts Available
                                  Address Available
                                  Side-by-Side Display of Related Fields Available with SAP Fiori elements V4
                                  Display of Related Fields as Links Available with SAP Fiori elements V4
                                  Forms Available
                                  Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                  You can enable growing mode and set the maximum number of lines to display with this mode.

                                  File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                  Dynamic Side Content Available with an extension
                                   

                                  Subsection Behavior

                                   

                                  Availability

                                  Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                  Adjustment of the Width for Content Display in a Subsection Available
                                   

                                  Content Visibility

                                   

                                  Availability

                                  Visible Sections, Subsections, Quickviews, and Tables Default
                                  Hiding Section, Subsection, Quickview and Table Content Available
                                  User-Controlled Visibility with Show More/Show Less Available
                                  Visible Smart Form Fields Default, you can hide them in certain conditions.

                                  Content Area

                                  Navigation Bar

                                  By default, the anchor bar is generated when the object page has at least one section.

                                  It lets users navigate to the individual content area sections.

                                  You can:

                                  • Hide the anchor bar when you only have one section.
                                  • Replace it with a tab bar.

                                  With extensions, you can replace the buttons with another type of control.

                                  For more information, see:

                                  Sections and Subsections

                                  You can add sections and subsections to the content area.

                                  Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                  For more information, see: Sections and Subsections.

                                  Reuse Components as Sections

                                  You can embed a reuse component as a section in the object page.

                                  Warning
                                  A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                  Consult the development team on the requirements for the reuse component.

                                  Subsections

                                  With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                  The smart link contact can include a contact list and a quickview of the contact details.

                                  For more information, see:

                                  Tables

                                  You can include a table in a subsection.

                                  For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                                  Smart Charts

                                  You can include a single smart chart facet in a subsection.

                                  In a smart chart, you can:

                                  • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                  • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                  For more information, see Smart Chart.

                                  Variant Management for Tables and Charts

                                  You can turn variant management on for:

                                  • All the tables and charts on the page
                                  • Individual tables and charts

                                  For more information, see Views (Variant Management).

                                  Address

                                  You can add one or more address fields:

                                  • As a separate subsection
                                  • As part of a field group within a subsection
                                  • To a quick view with smart link navigation

                                  For more information, see:

                                  Side-by-Side Display of Related Fields

                                  In display mode, you can display two related fields side by side with a single label, even when they correspond to separate properties on the backend. Application developers call such fields semantically connected fields.

                                  For example, you can display the properties:

                                  • Date and time with the label Date / Time
                                  • Length and width with the label Area (Length * Width)

                                  A delimiter separates the values for the two properties.

                                  A number of delimiters are available, including the forward slash (/), hyphen (-), and asterix (*).

                                  Select the delimiter that makes sense for the properties and use the same delimiter in the label.

                                  Side-by-side display of related fields
                                  Side-by-side display of related fields

                                  Display of Related Fields as Links

                                  In display mode, the related properties can also be displayed as links to separate navigation targets.

                                  Related fields as links
                                  Related fields as links
                                  Developer Hint
                                  For information on how to display related fields side by side and as links, refer Application Developers to: Grouping of Fields.

                                  Forms

                                  You can add action buttons to the toolbar for a form contained in a subsection.

                                  With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                  The action types can be:

                                  • Actions that occur in the system while the user stays on the object page.
                                  • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                  Conditional Enablement of Navigation Buttons

                                  You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                  For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                  Guidelines
                                  Implement this feature only when the way to enable the button is obvious to end users.

                                  Columns in a Form

                                  To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                                   

                                  Column Number

                                  Screen Size

                                  1 Small
                                  2 Medium
                                  3 Large
                                  6 Extra large
                                  Guidelines
                                  The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                                  Groups in a Form

                                  You can group fields in a form and assign a name to the group.

                                  Note that the group name is displayed only when a group contains fields.

                                  User-Controlled Load of Fields with Low Importance

                                  To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                                  After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                                  Text Control

                                  By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                  You can:

                                  • Set a maximum number of lines for the text control that’s greater than four.
                                  • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.

                                  In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                  File Upload

                                  With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                  For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                                  The application developers can define the file size and types allowed for upload.

                                  Dynamic Side Content

                                  You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                  With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                    Guidelines

                                    • Do not use tables in the side content panel.
                                    • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                    • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                    For more information, see:

                                    Developer Hint

                                    Subsection Behavior

                                    Subsection Loading Behavior

                                    By default, the subsection starts loading after the main object page elements are loaded.

                                    You can change the loading behavior to load the subsection after the header data is loaded.

                                    Example

                                    When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                                    Width for Content Display in a Subsection

                                    When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                    Content Visibility

                                    Sections, Subsections, Quickviews, and Tables

                                    By default, the object page displays these components.

                                    You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                                    User-Controlled Visibility

                                    You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                                    • When the subsection is hidden, Show More is displayed.
                                    • When the subsection shows, the Show Less link is displayed.

                                    Visibility of Smart Form Fields

                                    By default, all smart form fields have the high importance setting and show on all screen sizes.

                                    You can lower the level of importance for the fields to hide them on smaller screens.

                                    According to the importance assigned to the field, it is displayed as follows:

                                    • High (default): On all (small, medium, and large) screen sizes.
                                    • Medium: On large and medium screens only.
                                    • Low: On large screens only

                                    For more information, see Responsiveness.

                                    Related Links

                                    Table Features

                                    The SAP Fiori elements templates support the features and settings for a table detailed below.

                                    For design information see the table guidelines, starting with Table Overview, and the links within this article.

                                    Feature Availability

                                     

                                    Table Settings

                                     

                                    Availability

                                    Column Heading Labels You set these.
                                    Tooltips on Column Header Labels Available for exceptional use cases with SAP Fiori elements for OData V4
                                    Clear All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

                                    • Grid tables, analytical tables and tree tables in both list reports and object pages
                                    • Responsive tables in a list report

                                    With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

                                    You can change the default.

                                    Select All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

                                    With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

                                    You can change the default.

                                    Sticky Column Header Behavior Default, you can turn it off.
                                    Column Width The default width depends on the column contents. You can change it.
                                    Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                                    You can change the level of importance.

                                    Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                                    Ascending Sort Order on a Column Default, you can change it.
                                    Grouping Available in responsive and analytical tables
                                    Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                                    No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                                    Message Strip above the Table You can display a custom message above the table in the:

                                    • List report, object page, and analytical page with SAP Fiori elements for OData V2
                                    • List report with SAP Fiori elements for OData V4

                                    In the object page, by default, a message strip is displayed when there are errors in the table.

                                    When there are multiple messages, the one with the highest severity is displayed.

                                     

                                    List Report and Analytical Page Only

                                     

                                    Availability

                                    Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                                     

                                    Object Page Only

                                     

                                    Availability

                                    Message Strip for Rows with Errors Default
                                    Rows Displayed in a Grid Table Depends on the table height, which adjusts to the available onscreen space for an object page with:

                                    • Anchor bar navigation and a single section that contains only a grid table
                                    • Tab bar navigation and a current tab that contains only a grid table

                                    Table Settings


                                    Tooltips on Column Header Labels

                                    Warning
                                    Available with SAP Fiori elements for OData V4, the tooltips on the column header label feature makes sense only when the users always work on a desktop with a mouse. The users must hover on the column header to see the tooltips.

                                    Clear All / Select All

                                    When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements:

                                    • Display by default either the Clear All checkbox or Select All  checkbox in the header of the selection column, as detailed in the next sections
                                    • Allow you to set which checkbox displays for all the tables on an object page, or for specific tables only

                                    When the Select All action is hidden, the user can still select a range of multiple items, by selecting an item, pressing Shift, and selecting others.

                                    For  grid tables, analytical tables and tree tables, the default limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                    SAP Fiori elements for OData V2 Defaults

                                    When the selection of multiple rows (or multiselect) is enabled, the selection column header displays by default:

                                    • The Clear All checkbox for:
                                      • Grid tables, analytical tables and tree tables in both list reports and object pages
                                      • Responsive tables in a list report
                                    • The Select All  checkbox for a responsive table in an object page

                                    You can change the default.

                                    SAP Fiori elements for OData V4

                                    When the selection of multiple rows (or multi mode) is enabled, the selection column header displays by default the Clear All checkbox for all tables but a responsive table in an object page with anchor bar mode. In this case, the responsive table displays the Select All  checkbox because the user can scroll to all the section content.

                                    You can change the default.

                                    Warning
                                    For an optimal user experience only display the Select All checkbox for a small number of items because:

                                    • When the user clicks Select All, all the items or rows load from the backend. Loading many items can require multiple requests to the system and, consequently, take time.
                                    • When a responsive table contains so many rows that they cannot all be displayed onscreen, many users expect the Select All to select all the rows in the table. In fact, it selects all the rows currently displayed on the interface.

                                    Guidelines
                                    When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                                    Column Width

                                    The default column width varies according to the column contents:

                                    • Text: can range from 3 to 20 rem
                                    • Image: 5 rem
                                    • Rating or progress indicator: 6.875 rem
                                    • Chart: 20 rem

                                    You can can change the width.

                                    Developer Hint
                                    For more information, refer the development team to Setting the Default Column Width.

                                    Column Importance in Responsive Tables

                                    By default:

                                    • Key fields have high importance in list reports.
                                    • Other columns have the importance of none and are handled like columns assigned medium importance.

                                    You can change the level of importance.

                                    The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                                    • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                                    • The values in columns with low importance are first to be hidden.

                                    When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                                    You can also assign an importance to custom columns.

                                    For more information, see:


                                    Labels for Multiple Fields in a Column

                                    By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                    You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                                    Sort Order

                                    By default, the sort order for a column is ascending.

                                    You can:

                                    • Set the default sort order to descending.
                                    • Define other, customized sort orders.

                                    For more information, see the sort guidelines according to table type:


                                    Number of Table Rows Displayed at Once

                                    By default, a responsive table loads the following number of rows at once:

                                    • 20 rows in a list report.
                                    • 10 rows in an object page with multiple sections.

                                    When more rows exist, the users can click the More button at the end of the table to view additional rows.

                                    With SAP Fiori elements for OData V2, you can change the default number.

                                    For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                                    Guidelines
                                    Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                                    Grouping

                                    Grouping is available in responsive and analytical tables.

                                    You can define the format of the grouping headers.

                                    For more information, see:



                                    No Data Found Text

                                    By default, the following text is displayed when no data is found.

                                    • When the user has not applied filters, the text is “No data found.”
                                    • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                                    Guidelines
                                    Replace the generic text with text that’s meaningful to the user.

                                    List Report and Analytical Page Only

                                    Initial Expansion of Table Levels

                                    By default, on initial load, the following expandable tables are expanded to this number of levels:

                                    • Responsive table: 1 level
                                    • Tree table: 1 level
                                    • Analytical table: 0 levels

                                    You can change the default value for the tree table and analytical tables.

                                    Developer Hint
                                    For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                                    Object Page Only

                                    Message Strip for Rows with Errors

                                    When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                                    Related Links

                                    List Report – Content Area

                                    The SAP Fiori elements list report template supports the three content area layouts detailed below.

                                    For design information, see General Layout and the links below.

                                    Simple Content Layout

                                    The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                                    • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                                    • Automatic data loading
                                    • One table toolbar
                                    • Creation of business objects via a dialog
                                    Warning
                                    Although table-level variant management is supported, we strongly recommend against it.
                                    Simple content layout (default)
                                    Simple content layout (default)

                                    Multiple View Layout

                                    For more complex scenarios, you can turn on the multiple view layout which supports: 

                                    • Display of multiple views of a table that shows one business object, for example, each view of the same table can display different prefiltered states
                                    • The segmented button for a maximum of three views or the select control for four or more views
                                      Note that the SAP Fiori elements framework determines the switch control automatically based on the number of views.
                                    • Display of the count or number of total rows in the view (must be enabled)
                                    • One table toolbar
                                    • Automatic data loading
                                    • Creation of business objects via a dialog with SAP Fiori elements for OData V2
                                    Warning
                                    Although table-level variant management is supported, we strongly recommend against it.
                                    Multiple view layout - Segmented button
                                    Multiple view layout - Segmented button
                                    Muliple view layout - Select control
                                    Muliple view layout - Select control

                                    Multiple Content Layout

                                    To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                                    • Display of one or more business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can all be filtered by a specific customer and a specific date
                                    • Text-only icon tab bar to switch among the tabs
                                    • Views with data visualization in a chart instead of a table with both SAP Fiori elements for OData V2 and V4
                                    • Views with data visualization in both a chart and a table with SAP Fiori elements for OData V4
                                    • Automatic data loading
                                    • Different toolbars for each view
                                    Warning
                                    Creation of business objects via a dialog is not supported – it must be done in an object page.

                                    Although table-level variant management is supported, we strongly recommend against it.

                                    Do not use a mix of responsive and non-responsive tables.

                                    Developer Hint
                                    Application developers may be unfamiliar with the designer term “multiple content layout.”

                                    For more information on implementing this feature, refer the development team to:

                                    Multiple content layout
                                    Multiple content layout

                                    Related Links

                                    Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Guidelines
                                    Always define keyboard shortcuts based on the guidelines for Fiori Keyboard Interactions.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                     

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request
                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                     

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request
                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                     

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request
                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request

                                     

                                    For more information, see: Replacing Placeholder Text.

                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Localization of UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                     

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request
                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    SAP Fiori Elements

                                    SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                    • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                    • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                    The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                    Video: What is SAP Fiori elements?

                                    Versions

                                    Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                    Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                    • SAP Fiori elements for OData version 2 (V2)
                                    • SAP Fiori elements for OData version 4 (V4)

                                    Usage

                                    Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                    • Is the floorplan you want to use supported by SAP Fiori elements?
                                    • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                    Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                    Supported Floorplans

                                    The following floorplans are available as SAP Fiori elements templates:

                                    List report
                                    List report
                                    Worklist
                                    Worklist
                                    Object page
                                    Object page
                                    Overview page
                                    Overview page
                                    Analytical list page
                                    Analytical list page

                                    Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                    Supported Features

                                    Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                    • Message handling
                                    • The global edit flow, which includes draft handling
                                    • Keyboard shortcuts for basic operations
                                    • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                    • Seamless navigation across applications with the:
                                      • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                      • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                        With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                        However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                    Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                    Placeholder Texts

                                    Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                     

                                    Placeholder Text Replaced Text
                                    List Report Create Object Create Sales Order
                                    Object Page New Object New Sales Order
                                    Overview Page Could not perform action Unable to approve the request
                                    Developer Hint
                                    For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                    Extensions

                                    It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                    Developer Hint
                                    You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                    Related Links

                                    Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                    Object Page – Header

                                    The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                    For design information, see the Object Page Floorplan guidelines and the links below.

                                    Warning
                                    Always build the object page using the dynamic page header.

                                    Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                    Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                    Feature Availability

                                     

                                    Behavior and Interaction

                                     

                                    Availability

                                    Expanded State Default on initial load
                                    Collapsed State Default on scroll

                                    With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                    Header Content Display in Display Mode In the header content area
                                    Header Content Display in Edit and Create Modes When the header is editable:

                                    • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                                    • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                                    Header Content Visible Default, you can hide it.
                                    Header Content Hidden Available
                                    Header Field Editability By default, in edit mode the header is:

                                    • Not editable with SAP Fiori elements for OData V2
                                    • Editable with SAP Fiori elements for OData V4

                                    You can change the default.

                                    Highlighting Values Based on Criticality Available
                                     

                                    Components

                                     

                                    Availability

                                    Dynamic Page Header Mandatory, it must be configured.
                                    Title Mandatory, you must define it.
                                    Menu for Saved Version / Draft Default for draft-enabled applications
                                    Breadcrumbs Default
                                    Subtitle Available, you define the text.
                                    Object Marker Default in draft-enabled applications
                                    Image Available
                                    Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                    Paging Buttons on the First Subobject Page Default under certain conditions
                                    Toolbar Available
                                     

                                    Toolbar Actions

                                     

                                    Availability

                                    Edit and Delete Default, when the data allows these actions.

                                    You can turn one or both actions off.

                                    Copy Available with SAP Fiori elements for OData V2
                                    Related Apps Menu Button Available

                                    With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                    Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                    Application-Specific Actions Available,  they must be configured.
                                    Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                    Requires an extension with SAP Fiori elements for OData V2

                                    Order of Toolbar Actions Default

                                    You can change the default order.

                                     

                                    Additional Content (Optional)

                                     

                                    Availability

                                    Message Strip Available with SAP Fiori elements for OData V4 to provide information related to the object as a whole, such as the object status
                                    Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                    Plain Text Facets Available
                                    Contact Facets Available
                                    Micro Chart Facets Available
                                    Form Facets Available
                                    Address Facets Available
                                    Header Field Group Available
                                    Rating Indicator Facets Available
                                    Progress Indicator Facet Available
                                    Key Value Facet Available
                                    Link Available

                                    With SAP Fiori elements for OData V2:

                                    • The default link shows the text and ID. You can remove the text or the ID from the link.
                                    • You can include a link that navigates to a site external to the application.

                                    Behavior and Interaction


                                    Collapsed/Expanded State

                                    When the object page header contains at least one facet:

                                    • On the initial load of the object page, the header is expanded.
                                    • When the user scrolls down the page, the header collapses.
                                    • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                    When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                    With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                    Next to the title, an arrow   button lets the users expand the header.

                                    Summary Line for Object Page Header on Small Screens
                                    Summary Line for Object Page Header on Small Screens

                                    Display of Header Content

                                    In display mode, the header content area displays all the header content.

                                    In edit and create modes, when the header is:

                                    • Editable
                                      • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                                    The header section is only present in the edit and create modes.

                                      • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                                     

                                    • Not Editable, the header is hidden.

                                    Note that, by default, the header is

                                    • Editable with SAP Fiori elements for OData V4
                                    • Not editable with SAP Fiori elements for OData V2

                                    You can ask the application developers to change the default.

                                    For more information, see Dynamic Page Header (Mandatory).

                                    Developer Hint
                                    To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                    Header Content Visibility

                                    By default, header content is visible.

                                    You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                    • Entire header facets
                                    • Content, such as fields, in a header facet
                                    • Content in quick views

                                    With Fiori elements for OData V2, you can set:

                                    • The header to be displayed in edit mode.
                                    • Header facets to be visible in edit mode.
                                    Developer Hint
                                    For more information on the features, refer the development team to:


                                    Header Field Editability

                                    By default, in edit mode the header is:

                                    • Not editable with SAP Fiori elements for OData V2
                                    • Editable with SAP Fiori elements for OData V4

                                    You can change the default.

                                    Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                                    Developer Hint
                                    To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                    Highlighting Values Based on Criticality

                                    You can assign colors and icons to text to indicate the criticality of a field value.

                                    With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                                    You can display the following microcharts in the header:

                                    • Area micro chart
                                    • Bullet chart
                                    • Radial chart
                                    • Column chart
                                    • Line micro chart
                                    • Harvey ball chart
                                    • Stacked bar chart

                                    Components


                                    Title

                                    By default, with:

                                    •  SAP Fiori elements for OData V2, the title area is empty.
                                    •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                    Guidelines
                                    Tell the developers which property to use as the title.

                                    Menu for Saved Version / Draft

                                    With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                    Breadcrumbs

                                    Breadcrumbs are displayed above the object title.

                                    Guidelines
                                    Limit the breadcrumbs to the drilldown levels within the object page.

                                    Object Marker

                                    The object marker indicates the object is locked by another user in draft-enabled applications.


                                    Image

                                    The image is an avatar control. By default, it has a square shape.

                                    You can set:

                                    • An image to display instead of the avatar.
                                    • The avatar to a have a circular shape.

                                    When no image is set or found for the avatar, the avatar initials are displayed.

                                    If those are not set or found either, an icon for the avatar is displayed:

                                    • A square avatar for a product
                                    • A circular avatar for a person.

                                    For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                    Paging Buttons

                                    By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                    • The user has navigated from a table in the object page to the subobject.
                                    • The table in the object page contains at least two items.

                                    With SAP Fiori elements for OData V2, you can:

                                    • Enable the paging buttons to show on the first object page opened from a list report.
                                    • Disable the default display of the paging buttons on the subobject page.

                                    Toolbar Actions


                                    Edit and Delete

                                    By default, these actions are displayed when the data in the object page allows them.

                                    You can:

                                    • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                    • Disable the actions.

                                    For more information, see:


                                    Copy

                                    You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                    You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                    In the object page, the Copy button is displayed after the Delete button.

                                    Developer Hint
                                    Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                    Related Apps Menu Button

                                    You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                    You can also:

                                    • Hide specific actions in the menu.
                                    • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                    Generic Actions

                                    By default, the Share button is displayed for saved objects and hidden for drafts.

                                    For more information, see Share (Generic).


                                    Application-Specific Actions

                                    You can include the actions required for your use case.

                                    The header toolbar displays application-specific actions to the left of the generic actions.

                                    You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                    Developer Hint
                                    For more information, refer application developers to Keyboard Shortcuts.

                                    Conditional Enablement of Navigation Buttons

                                    With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                    With SAP Fiori elements for OData V2, this feature requires extensions.

                                    For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                    Guidelines
                                    Implement this feature only when the way to enable the button is obvious to end users.

                                    Order of Toolbar Actions

                                    The default order — left to right — for actions in the object page toolbar is below:

                                    • Edit
                                    • Delete
                                    • Copy with SAP Fiori elements for OData V2
                                    • Application-specific action buttons
                                    • Related Apps menu button
                                    • Share

                                    You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                    For more information, see:

                                    Additional Content


                                    Message Strip

                                    With SAP Fiori elements for OData V4, you can add a message strip in the header to provide information related to the object as a whole, such as the object status.

                                    The message strip is displayed under the object page title and optional subtitle. When the header is collapsed, the message strip remains visible.

                                    When more than one message is relevant for the object as a whole, the message strip displays the text “The object contains errors / warnings / information.”

                                    The user can find the individual messages via the message popover in the footer bar.

                                    For more information, see:

                                    Simple Header Facets

                                    With SAP Fiori elements for OData V2:

                                    • You can use a simple header facet to show simple data points that align horizontally across the header.
                                    • When form fields contain no value, they display the empty  state indicator (–).

                                    Plain Text Facets

                                    You can use the plain text facet to display a continuous text in the header.

                                    For more information, see Plain Text Facet.


                                    Contact Facets

                                    You can enable a quick view for a contact.

                                    With SAP Fiori elements for OData V4:

                                    • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                                    • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                                    For more information, see Quick View.


                                    Micro Chart Facets

                                    For more information, see Micro Charts.


                                    Form Facets

                                    You can add a quick view to the form facet.

                                    For more information, see Form Facet (Dataset).

                                    Developer Hint
                                    For more information, refer the development team to Form Facet.

                                    Address Facets

                                    You can display an address such as a shipping address.

                                    Developer Hint
                                    For more information, refer the development team to Address Facet in the Object Page Header.

                                    Header Field Groups

                                    You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                    Rating Indicator Facets

                                    You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                    By default, the maximum rating is five stars.

                                    You can:

                                    • Change the maximum rating.
                                    • Specify more descriptive text for the subtitle.

                                    With extensions, you can make the rating editable.

                                    Display Mode

                                    The rating indicator shows with the:

                                    • Title
                                    • Subtitle with the total number of ratings
                                    • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                    Edit Mode

                                    The rating indicator moves into the header facet and appears with only the title in edit mode.

                                    For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                    For more information, see:


                                    Progress Indicator Facets

                                    You can add a progress indicator facet to the object header.

                                    For more information, see:


                                    Key Value Facets

                                    You can add a key value facet to highlight important data or KPIs.

                                    For more information, see Key Value Facet.

                                    Related Links

                                    Object Page – Content Area

                                    The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                    For design information, see the Object Page Floorplan guidelines and the links below.

                                    Feature Availability

                                     

                                     

                                    Content Area

                                     

                                    Availability

                                    Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                    Navigation Bar: Tab Bar Available
                                    Sections and Subsections Available
                                    Reuse Components as Sections Available
                                     

                                    Subsections

                                     

                                    Availability

                                    Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                    Tables Available
                                    Smart Charts Available
                                    Variant Management for Tables and Charts Available
                                    Address Available, SAP Fiori elements for OData V2 only
                                    Forms Available
                                     

                                    Subsection Behavior

                                     

                                    Availability

                                    Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                    Adjustment of the Width for Content Display in a Subsection Available
                                     

                                    Content Visibility

                                     

                                    Availability

                                    Visible Sections, Subsections, Quickviews, and Tables Default
                                    Hiding Section, Subsection, Quickview and Table Content Available
                                    User Control of Visibility with See More/See Less Links Available:

                                    • With SAP Fiori elements for OData V2, the links are See More/See Less.
                                    • With SAP Fiori elements for OData V4, the links are Show More/Show Less.
                                    Visible Smart Form Fields Default, you can hide them in certain conditions.

                                    Content Area


                                    Navigation Bar

                                    By default, the anchor bar is generated when the object page has at least one section.

                                    It lets users navigate to the individual content area sections.

                                    You can:

                                    • Hide the anchor bar when you only have one section.
                                    • Replace it with a tab bar.

                                    With extensions, you can replace the buttons with another type of control.

                                    For more information, see:


                                    Sections and Subsections

                                    You can add sections and subsections to the content area.

                                    Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                    For more information, see: Sections and Subsections.


                                    Reuse Components as Sections

                                    You can embed a reuse component as a section in the object page.

                                    Warning
                                    A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                    Consult the development team on the requirements for the reuse component.


                                    Subsections


                                    Smart Link Contact

                                    With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                    The smart link contact can include a contact list and a quickview of the contact details.

                                    For more information, see:


                                    Tables

                                    You can include a table in a subsection.

                                    For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                    Smart Charts

                                    You can include a single smart chart facet in a subsection.

                                    In a smart chart, you can:

                                    • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                    • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                    For more information, see Smart Chart.


                                    Variant Management for Tables and Charts

                                    You can turn variant management on for:

                                    • All the tables and charts on the page
                                    • Individual tables and charts

                                    For more information, see Variant Management.


                                    Address

                                    With SAP Fiori elements for OData V2, you can add one or more address fields:

                                    • As a separate subsection
                                    • As part of a field group within a subsection
                                    • To a quick view with smart link navigation

                                    For more information, see:


                                    Forms

                                    You can add action buttons to the toolbar for a form contained in a subsection.

                                    In the subsection toolbar, the action types can be:

                                    • Actions that occur in the system while the user stays on the object page.
                                    • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                    Subsection Behavior


                                    Subsection Loading Behavior

                                    By default, the subsection starts loading after the main object page elements are loaded.

                                    You can change the loading behavior to load the subsection after the header data is loaded.

                                    Example

                                    When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                    Width for Content Display in a Subsection

                                    When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                    Content Visibility


                                    Sections, Subsections, Quickviews, and Tables

                                    By default, the object page displays these components.

                                    You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                    User Control of Visibility

                                    You can turn on these links to allow users to control the display of subsections with the:

                                    • See More/See Less link with SAP Fiori elements for OData V2.
                                    • Show More/Show Less link with SAP Fiori elements for OData V4.

                                    The links display in the bottom right corner of the section:

                                    • When the subsection is hidden, the See More or Show More link is displayed.
                                    • When the subsection shows, the See Less or Show Less link is displayed.

                                    Visibility of Smart Form Fields

                                    By default, all smart form fields have the high importance setting and show on all screen sizes.

                                    You can lower the level of importance for the fields to hide them on smaller screens.

                                    According to the importance assigned to the field, it is displayed as follows:

                                    • High (default): On all (small, medium, and large) screen sizes.
                                    • Medium: On large and medium screens only.
                                    • Low: On large screens only

                                    For more information, see Responsiveness.

                                    Related Links

                                    Elements and Controls

                                    Object Page – Content Area

                                    The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                    For design information, see the Object Page Floorplan guidelines and the links below.

                                    Feature Availability

                                     

                                    Content Area

                                     

                                    Availability

                                    Draft Object Validation Default, with SAP Fiori elements for OData V2.

                                    Users can trigger the validation by pressing the Enter key while their cursor is in a field on the object or subobject page.

                                    Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                    Navigation Bar: Tab Bar Available
                                    Sections and Subsections Available
                                    Reuse Components as Sections Available
                                     

                                    Subsections

                                     

                                    Availability

                                    Link Available

                                    With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                    Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                    Tables Available
                                    Smart Charts Available
                                    Variant Management for Tables and Charts Available
                                    Address Available
                                    Forms Available
                                    Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                    You can enable growing mode and set the maximum number of lines to display with this mode.

                                    File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                    Dynamic Side Content Available with an extension
                                     

                                    Subsection Behavior

                                     

                                    Availability

                                    Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                    Adjustment of the Width for Content Display in a Subsection Available
                                     

                                    Content Visibility

                                     

                                    Availability

                                    Visible Sections, Subsections, Quickviews, and Tables Default
                                    Hiding Section, Subsection, Quickview and Table Content Available
                                    User-Controlled Visibility with Show More/Show Less Available
                                    Visible Smart Form Fields Default, you can hide them in certain conditions.

                                    Content Area

                                    Navigation Bar

                                    By default, the anchor bar is generated when the object page has at least one section.

                                    It lets users navigate to the individual content area sections.

                                    You can:

                                    • Hide the anchor bar when you only have one section.
                                    • Replace it with a tab bar.

                                    With extensions, you can replace the buttons with another type of control.

                                    For more information, see:

                                    Sections and Subsections

                                    You can add sections and subsections to the content area.

                                    Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                    For more information, see: Sections and Subsections.

                                    Reuse Components as Sections

                                    You can embed a reuse component as a section in the object page.

                                    Warning
                                    A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                    Consult the development team on the requirements for the reuse component.

                                    Subsections

                                    With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                    The smart link contact can include a contact list and a quickview of the contact details.

                                    For more information, see:

                                    Tables

                                    You can include a table in a subsection.

                                    For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.

                                    Smart Charts

                                    You can include a single smart chart facet in a subsection.

                                    In a smart chart, you can:

                                    • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                    • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                    For more information, see Smart Chart.

                                    Variant Management for Tables and Charts

                                    You can turn variant management on for:

                                    • All the tables and charts on the page
                                    • Individual tables and charts

                                    For more information, see Views (Variant Management).

                                    Address

                                    You can add one or more address fields:

                                    • As a separate subsection
                                    • As part of a field group within a subsection
                                    • To a quick view with smart link navigation

                                    For more information, see:

                                    Forms

                                    You can add action buttons to the toolbar for a form contained in a subsection.

                                    With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                    The action types can be:

                                    • Actions that occur in the system while the user stays on the object page.
                                    • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                    Conditional Enablement of Navigation Buttons

                                    You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                    For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                    Guidelines
                                    Implement this feature only when the way to enable the button is obvious to end users.

                                    Columns in a Form

                                    To optimize onscreen space, the default number of columns in a form depends on the screen size, as follows:

                                     

                                    Column Number

                                    Screen Size

                                    1 Small
                                    2 Medium
                                    3 Large
                                    6 Extra large
                                    Guidelines
                                    The default column number for each screen size complies with the SAP Fiori Design Guidelines for forms in Object Page floorplan. We recommended against changing it.

                                    Groups in a Form

                                    You can group fields in a form and assign a name to the group.

                                    Note that the group name is displayed only when a group contains fields.

                                    User-Controlled Load of Fields with Low Importance

                                    To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                                    After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                                    Text Control

                                    By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                    You can:

                                    • Set a maximum number of lines for the text control that’s greater than four.
                                    • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.

                                    In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                    File Upload

                                    With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                    For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                                    The application developers can define the file size and types allowed for upload.

                                    Dynamic Side Content

                                    You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                    With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                      Guidelines

                                      • Do not use tables in the side content panel.
                                      • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                      • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                      For more information, see:

                                      Developer Hint

                                      Subsection Behavior

                                      Subsection Loading Behavior

                                      By default, the subsection starts loading after the main object page elements are loaded.

                                      You can change the loading behavior to load the subsection after the header data is loaded.

                                      Example

                                      When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.

                                      Width for Content Display in a Subsection

                                      When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                      Content Visibility

                                      Sections, Subsections, Quickviews, and Tables

                                      By default, the object page displays these components.

                                      You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.

                                      User-Controlled Visibility

                                      You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                                      • When the subsection is hidden, Show More is displayed.
                                      • When the subsection shows, the Show Less link is displayed.

                                      Visibility of Smart Form Fields

                                      By default, all smart form fields have the high importance setting and show on all screen sizes.

                                      You can lower the level of importance for the fields to hide them on smaller screens.

                                      According to the importance assigned to the field, it is displayed as follows:

                                      • High (default): On all (small, medium, and large) screen sizes.
                                      • Medium: On large and medium screens only.
                                      • Low: On large screens only

                                      For more information, see Responsiveness.

                                      Related Links

                                      Object Page – Content Area

                                      The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                      For design information, see the Object Page Floorplan guidelines and the links below.

                                      Feature Availability

                                       

                                      Content Area

                                       

                                      Availability

                                      Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                      Navigation Bar: Tab Bar Available
                                      Sections and Subsections Available
                                      Reuse Components as Sections Available
                                       

                                      Subsections

                                       

                                      Availability

                                      Link Available

                                      With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                      Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                      Tables Available
                                      Smart Charts Available
                                      Variant Management for Tables and Charts Available
                                      Address Available
                                      Forms Available
                                      Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                      You can enable growing mode and set the maximum number of lines to display with this mode.

                                      File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                      Dynamic Side Content Available with an extension
                                       

                                      Subsection Behavior

                                       

                                      Availability

                                      Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                      Adjustment of the Width for Content Display in a Subsection Available
                                       

                                      Content Visibility

                                       

                                      Availability

                                      Visible Sections, Subsections, Quickviews, and Tables Default
                                      Hiding Section, Subsection, Quickview and Table Content Available
                                      User-Controlled Visibility with Show More/Show Less Available
                                      Visible Smart Form Fields Default, you can hide them in certain conditions.

                                      Content Area


                                      Navigation Bar

                                      By default, the anchor bar is generated when the object page has at least one section.

                                      It lets users navigate to the individual content area sections.

                                      You can:

                                      • Hide the anchor bar when you only have one section.
                                      • Replace it with a tab bar.

                                      With extensions, you can replace the buttons with another type of control.

                                      For more information, see:


                                      Sections and Subsections

                                      You can add sections and subsections to the content area.

                                      Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                      For more information, see: Sections and Subsections.


                                      Reuse Components as Sections

                                      You can embed a reuse component as a section in the object page.

                                      Warning
                                      A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                      Consult the development team on the requirements for the reuse component.


                                      Subsections

                                      Smart Link Contact

                                      With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                      The smart link contact can include a contact list and a quickview of the contact details.

                                      For more information, see:


                                      Tables

                                      You can include a table in a subsection.

                                      For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                      Smart Charts

                                      You can include a single smart chart facet in a subsection.

                                      In a smart chart, you can:

                                      • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                      • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                      For more information, see Smart Chart.


                                      Variant Management for Tables and Charts

                                      You can turn variant management on for:

                                      • All the tables and charts on the page
                                      • Individual tables and charts

                                      For more information, see Views (Variant Management).


                                      Address

                                      You can add one or more address fields:

                                      • As a separate subsection
                                      • As part of a field group within a subsection
                                      • To a quick view with smart link navigation

                                      For more information, see:


                                      Forms

                                      You can add action buttons to the toolbar for a form contained in a subsection.

                                      With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                      The action types can be:

                                      • Actions that occur in the system while the user stays on the object page.
                                      • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                      Conditional Enablement of Navigation Buttons

                                      You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                      For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                      Guidelines
                                      Implement this feature only when the way to enable the button is obvious to end users.

                                      Groups in a Form

                                      You can group fields in a form and assign a name to the group.

                                      Note that the group name is displayed only when a group contains fields.

                                      User-Controlled Load of Fields with Low Importance

                                      To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                                      After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                                      Text Control

                                      By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                      You can:

                                      • Set a maximum number of lines for the text control that’s greater than four.
                                      • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.

                                      In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                      File Upload

                                      With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                      For example, the sales order object can have a property for a contract and users can upload the contract file to the property.

                                      The application developers can define the file size and types allowed for upload.


                                      Dynamic Side Content

                                      You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                      With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                        Guidelines

                                        • Do not use tables in the side content panel.
                                        • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                        • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                        For more information, see:

                                        Developer Hint

                                        Subsection Behavior


                                        Subsection Loading Behavior

                                        By default, the subsection starts loading after the main object page elements are loaded.

                                        You can change the loading behavior to load the subsection after the header data is loaded.

                                        Example

                                        When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                        Width for Content Display in a Subsection

                                        When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                        Content Visibility


                                        Sections, Subsections, Quickviews, and Tables

                                        By default, the object page displays these components.

                                        You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                        User-Controlled Visibility

                                        You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                                        • When the subsection is hidden, Show More is displayed.
                                        • When the subsection shows, the Show Less link is displayed.

                                        Visibility of Smart Form Fields

                                        By default, all smart form fields have the high importance setting and show on all screen sizes.

                                        You can lower the level of importance for the fields to hide them on smaller screens.

                                        According to the importance assigned to the field, it is displayed as follows:

                                        • High (default): On all (small, medium, and large) screen sizes.
                                        • Medium: On large and medium screens only.
                                        • Low: On large screens only

                                        For more information, see Responsiveness.

                                        Related Links

                                        Object Page – Content Area

                                        The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                        For design information, see the Object Page Floorplan guidelines and the links below.

                                        Feature Availability

                                         

                                        Content Area

                                         

                                        Availability

                                        Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                        Navigation Bar: Tab Bar Available
                                        Sections and Subsections Available
                                        Reuse Components as Sections Available
                                         

                                        Subsections

                                         

                                        Availability

                                        Link Available

                                        With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                        Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                        Tables Available
                                        Smart Charts Available
                                        Variant Management for Tables and Charts Available
                                        Address Available
                                        Forms Available
                                        Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                        You can enable growing mode and set the maximum number of lines to display with this mode.

                                        File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                        Dynamic Side Content Available with an extension
                                         

                                        Subsection Behavior

                                         

                                        Availability

                                        Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                        Adjustment of the Width for Content Display in a Subsection Available
                                         

                                        Content Visibility

                                         

                                        Availability

                                        Visible Sections, Subsections, Quickviews, and Tables Default
                                        Hiding Section, Subsection, Quickview and Table Content Available
                                        User-Controlled Visibility with Show More/Show Less Available
                                        Visible Smart Form Fields Default, you can hide them in certain conditions.

                                        Content Area


                                        Navigation Bar

                                        By default, the anchor bar is generated when the object page has at least one section.

                                        It lets users navigate to the individual content area sections.

                                        You can:

                                        • Hide the anchor bar when you only have one section.
                                        • Replace it with a tab bar.

                                        With extensions, you can replace the buttons with another type of control.

                                        For more information, see:


                                        Sections and Subsections

                                        You can add sections and subsections to the content area.

                                        Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                        For more information, see: Sections and Subsections.


                                        Reuse Components as Sections

                                        You can embed a reuse component as a section in the object page.

                                        Warning
                                        A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                        Consult the development team on the requirements for the reuse component.


                                        Subsections

                                        Smart Link Contact

                                        With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                        The smart link contact can include a contact list and a quickview of the contact details.

                                        For more information, see:


                                        Tables

                                        You can include a table in a subsection.

                                        For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                        Smart Charts

                                        You can include a single smart chart facet in a subsection.

                                        In a smart chart, you can:

                                        • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                        • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                        For more information, see Smart Chart.


                                        Variant Management for Tables and Charts

                                        You can turn variant management on for:

                                        • All the tables and charts on the page
                                        • Individual tables and charts

                                        For more information, see Variant Management.


                                        Address

                                        You can add one or more address fields:

                                        • As a separate subsection
                                        • As part of a field group within a subsection
                                        • To a quick view with smart link navigation

                                        For more information, see:


                                        Forms

                                        You can add action buttons to the toolbar for a form contained in a subsection.

                                        With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                        The action types can be:

                                        • Actions that occur in the system while the user stays on the object page.
                                        • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                        Conditional Enablement of Navigation Buttons

                                        You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                        For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                        Guidelines
                                        Implement this feature only when the way to enable the button is obvious to end users.

                                        Groups in a Form

                                        You can group fields in a form and assign a name to the group.

                                        Note that the group name is displayed only when a group contains fields.

                                        User-Controlled Load of Fields with Low Importance

                                        To improve the performance on application startup, you can prevent form fields with low importance from loading until the user clicks Show Details with SAP Fiori element for OData V4.

                                        After the user clicks the button, the fields are loaded and the Hide Details button is displayed.

                                        Text Control

                                        By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                        You can:

                                        • Set a maximum number of lines for the text control that’s greater than four.
                                        • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.

                                        In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                        File Upload

                                        With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                        For example, the sales order object can have a property for a contract and users can upload the contract file to the property.


                                        Dynamic Side Content

                                        You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                        With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                          Guidelines

                                          • Do not use tables in the side content panel.
                                          • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                          • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                          For more information, see:

                                          Developer Hint

                                          Subsection Behavior


                                          Subsection Loading Behavior

                                          By default, the subsection starts loading after the main object page elements are loaded.

                                          You can change the loading behavior to load the subsection after the header data is loaded.

                                          Example

                                          When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                          Width for Content Display in a Subsection

                                          When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                          Content Visibility


                                          Sections, Subsections, Quickviews, and Tables

                                          By default, the object page displays these components.

                                          You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                          User-Controlled Visibility

                                          You can enable the Show More/Show Less button in the bottom right corner of a section to let users control the display of subsection content.

                                          • When the subsection is hidden, Show More is displayed.
                                          • When the subsection shows, the Show Less link is displayed.

                                          Visibility of Smart Form Fields

                                          By default, all smart form fields have the high importance setting and show on all screen sizes.

                                          You can lower the level of importance for the fields to hide them on smaller screens.

                                          According to the importance assigned to the field, it is displayed as follows:

                                          • High (default): On all (small, medium, and large) screen sizes.
                                          • Medium: On large and medium screens only.
                                          • Low: On large screens only

                                          For more information, see Responsiveness.

                                          Related Links

                                          Elements and Controls

                                          Object Page – Content Area

                                          The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                          For design information, see the Object Page Floorplan guidelines and the links below.

                                          Feature Availability

                                           

                                           

                                          Content Area

                                           

                                          Availability

                                          Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                          Navigation Bar: Tab Bar Available
                                          Sections and Subsections Available
                                          Reuse Components as Sections Available
                                           

                                          Subsections

                                           

                                          Availability

                                          Link Available

                                          With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                          Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                          Tables Available
                                          Smart Charts Available
                                          Variant Management for Tables and Charts Available
                                          Address Available
                                          Forms Available
                                          Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                          You can enable growing mode and set the maximum number of lines to display with this mode.

                                          File Upload With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete it.
                                          Dynamic Side Content Available with an extension
                                           

                                          Subsection Behavior

                                           

                                          Availability

                                          Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                          Adjustment of the Width for Content Display in a Subsection Available
                                           

                                          Content Visibility

                                           

                                          Availability

                                          Visible Sections, Subsections, Quickviews, and Tables Default
                                          Hiding Section, Subsection, Quickview and Table Content Available
                                          User Control of Visibility with See More/See Less Links Available:

                                          • With SAP Fiori elements for OData V2, the links are See More/See Less.
                                          • With SAP Fiori elements for OData V4, the links are Show More/Show Less.
                                          Visible Smart Form Fields Default, you can hide them in certain conditions.

                                          Content Area


                                          Navigation Bar

                                          By default, the anchor bar is generated when the object page has at least one section.

                                          It lets users navigate to the individual content area sections.

                                          You can:

                                          • Hide the anchor bar when you only have one section.
                                          • Replace it with a tab bar.

                                          With extensions, you can replace the buttons with another type of control.

                                          For more information, see:


                                          Sections and Subsections

                                          You can add sections and subsections to the content area.

                                          Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                          For more information, see: Sections and Subsections.


                                          Reuse Components as Sections

                                          You can embed a reuse component as a section in the object page.

                                          Warning
                                          A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                          Consult the development team on the requirements for the reuse component.


                                          Subsections

                                          Smart Link Contact

                                          With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                          The smart link contact can include a contact list and a quickview of the contact details.

                                          For more information, see:


                                          Tables

                                          You can include a table in a subsection.

                                          For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                          Smart Charts

                                          You can include a single smart chart facet in a subsection.

                                          In a smart chart, you can:

                                          • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                          • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                          For more information, see Smart Chart.


                                          Variant Management for Tables and Charts

                                          You can turn variant management on for:

                                          • All the tables and charts on the page
                                          • Individual tables and charts

                                          For more information, see Variant Management.


                                          Address

                                          You can add one or more address fields:

                                          • As a separate subsection
                                          • As part of a field group within a subsection
                                          • To a quick view with smart link navigation

                                          For more information, see:


                                          Forms

                                          You can add action buttons to the toolbar for a form contained in a subsection.

                                          With SAP Fiori elements for OData V4, you can also add an action next to the form header.

                                          The action types can be:

                                          • Actions that occur in the system while the user stays on the object page.
                                          • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                          Conditional Enablement of Navigation Buttons

                                          You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                          For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                          Guidelines
                                          Implement this feature only when the way to enable the button is obvious to end users.

                                          Groups in a Form

                                          You can group fields in a form and assign a name to the group.

                                          Note that the group name is displayed only when a group contains fields.

                                          Text Control

                                          By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                          You can:

                                          • Set a maximum number of lines for the text control that’s greater than four.
                                          • Enable growing mode: The length of the text control on first load allows for four lines. After the user has entered that number of lines, the length grows by one line at a time until it reaches the maximum number. A scrollbar is displayed next to the text entry area.

                                          In display mode, the text is truncated to 100 characters and a More link allows the user to display the full text. Alternatively, you can set the full text to display in a popover when the the user clicks More.

                                          File Upload

                                          With SAP Fiori elements for OData V4, users can upload a file to an object page property and delete the file.

                                          For example, the sales order object can have a property for a contract and users can upload the contract file to the property.


                                          Dynamic Side Content

                                          You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                          With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                            Guidelines

                                            • Do not use tables in the side content panel.
                                            • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                            • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                            For more information, see:

                                            Developer Hint

                                            Subsection Behavior


                                            Subsection Loading Behavior

                                            By default, the subsection starts loading after the main object page elements are loaded.

                                            You can change the loading behavior to load the subsection after the header data is loaded.

                                            Example

                                            When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                            Width for Content Display in a Subsection

                                            When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                            Content Visibility


                                            Sections, Subsections, Quickviews, and Tables

                                            By default, the object page displays these components.

                                            You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                            User Control of Visibility

                                            You can turn on these links to allow users to control the display of subsections with the:

                                            • See More/See Less link with SAP Fiori elements for OData V2.
                                            • Show More/Show Less link with SAP Fiori elements for OData V4.

                                            The links display in the bottom right corner of the section:

                                            • When the subsection is hidden, the See More or Show More link is displayed.
                                            • When the subsection shows, the See Less or Show Less link is displayed.

                                            Visibility of Smart Form Fields

                                            By default, all smart form fields have the high importance setting and show on all screen sizes.

                                            You can lower the level of importance for the fields to hide them on smaller screens.

                                            According to the importance assigned to the field, it is displayed as follows:

                                            • High (default): On all (small, medium, and large) screen sizes.
                                            • Medium: On large and medium screens only.
                                            • Low: On large screens only

                                            For more information, see Responsiveness.

                                            Related Links

                                            Elements and Controls

                                            Object Page – Content Area

                                            The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                            For design information, see the Object Page Floorplan guidelines and the links below.

                                            Feature Availability

                                             

                                             

                                            Content Area

                                             

                                            Availability

                                            Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                            Navigation Bar: Tab Bar Available
                                            Sections and Subsections Available
                                            Reuse Components as Sections Available
                                             

                                            Subsections

                                             

                                            Availability

                                            Link Available

                                            With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                            Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                            Tables Available
                                            Smart Charts Available
                                            Variant Management for Tables and Charts Available
                                            Address Available
                                            Forms Available
                                            Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                            You can change the default and enable growing mode.

                                            Dynamic Side Content Available with an extension
                                             

                                            Subsection Behavior

                                             

                                            Availability

                                            Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                            Adjustment of the Width for Content Display in a Subsection Available
                                             

                                            Content Visibility

                                             

                                            Availability

                                            Visible Sections, Subsections, Quickviews, and Tables Default
                                            Hiding Section, Subsection, Quickview and Table Content Available
                                            User Control of Visibility with See More/See Less Links Available:

                                            • With SAP Fiori elements for OData V2, the links are See More/See Less.
                                            • With SAP Fiori elements for OData V4, the links are Show More/Show Less.
                                            Visible Smart Form Fields Default, you can hide them in certain conditions.

                                            Content Area


                                            Navigation Bar

                                            By default, the anchor bar is generated when the object page has at least one section.

                                            It lets users navigate to the individual content area sections.

                                            You can:

                                            • Hide the anchor bar when you only have one section.
                                            • Replace it with a tab bar.

                                            With extensions, you can replace the buttons with another type of control.

                                            For more information, see:


                                            Sections and Subsections

                                            You can add sections and subsections to the content area.

                                            Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                            For more information, see: Sections and Subsections.


                                            Reuse Components as Sections

                                            You can embed a reuse component as a section in the object page.

                                            Warning
                                            A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                            Consult the development team on the requirements for the reuse component.


                                            Subsections

                                            With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                            The smart link contact can include a contact list and a quickview of the contact details.

                                            For more information, see:


                                            Tables

                                            You can include a table in a subsection.

                                            For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                            Smart Charts

                                            You can include a single smart chart facet in a subsection.

                                            In a smart chart, you can:

                                            • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                            • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                            For more information, see Smart Chart.


                                            Variant Management for Tables and Charts

                                            You can turn variant management on for:

                                            • All the tables and charts on the page
                                            • Individual tables and charts

                                            For more information, see Variant Management.


                                            Address

                                            You can add one or more address fields:

                                            • As a separate subsection
                                            • As part of a field group within a subsection
                                            • To a quick view with smart link navigation

                                            For more information, see:


                                            Forms

                                            You can add action buttons to the toolbar for a form contained in a subsection.

                                            In the subsection toolbar, the action types can be:

                                            • Actions that occur in the system while the user stays on the object page.
                                            • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                            Conditional Enablement of Navigation Buttons

                                            You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                            For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                            Guidelines
                                            Implement this feature only when the way to enable the button is obvious to end users.

                                            Groups in a Form

                                            You can group fields in a form and assign a name to the group.

                                            Note that the group name is displayed only when a group contains fields.

                                            Growing Text Control

                                            By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                            You can:

                                            • Change the defaullt number.
                                            • Enable growing mode so the length of the text control on first load allows for the number of lines that you specificy. After the user has entered that number of lines, the length grows by the same number of lines and a scrollbar is displayed next to the text entry area.

                                            Dynamic Side Content

                                            You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                            With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                              Guidelines

                                              • Do not use tables in the side content panel.
                                              • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                              • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                              For more information, see:

                                              Developer Hint

                                              Subsection Behavior


                                              Subsection Loading Behavior

                                              By default, the subsection starts loading after the main object page elements are loaded.

                                              You can change the loading behavior to load the subsection after the header data is loaded.

                                              Example

                                              When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                              Width for Content Display in a Subsection

                                              When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                              Content Visibility


                                              Sections, Subsections, Quickviews, and Tables

                                              By default, the object page displays these components.

                                              You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                              User Control of Visibility

                                              You can turn on these links to allow users to control the display of subsections with the:

                                              • See More/See Less link with SAP Fiori elements for OData V2.
                                              • Show More/Show Less link with SAP Fiori elements for OData V4.

                                              The links display in the bottom right corner of the section:

                                              • When the subsection is hidden, the See More or Show More link is displayed.
                                              • When the subsection shows, the See Less or Show Less link is displayed.

                                              Visibility of Smart Form Fields

                                              By default, all smart form fields have the high importance setting and show on all screen sizes.

                                              You can lower the level of importance for the fields to hide them on smaller screens.

                                              According to the importance assigned to the field, it is displayed as follows:

                                              • High (default): On all (small, medium, and large) screen sizes.
                                              • Medium: On large and medium screens only.
                                              • Low: On large screens only

                                              For more information, see Responsiveness.

                                              Related Links

                                              Elements and Controls

                                              Object Page – Content Area

                                              The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                              For design information, see the Object Page Floorplan guidelines and the links below.

                                              Feature Availability

                                               

                                               

                                              Content Area

                                               

                                              Availability

                                              Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                              Navigation Bar: Tab Bar Available
                                              Sections and Subsections Available
                                              Reuse Components as Sections Available
                                               

                                              Subsections

                                               

                                              Availability

                                              Link Available

                                              With SAP Fiori elements for OData V2, the default link shows the text and ID. You can remove the text or the ID.

                                              Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                              Tables Available
                                              Smart Charts Available
                                              Variant Management for Tables and Charts Available
                                              Address Available
                                              Forms Available
                                              Growing Text Control With SAP Fiori elements V4, the default length of the text entry area allows for four lines of text.

                                              You can change the default and enable growing mode.

                                              Dynamic Side Content Available with an extension
                                               

                                              Subsection Behavior

                                               

                                              Availability

                                              Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                              Adjustment of the Width for Content Display in a Subsection Available
                                               

                                              Content Visibility

                                               

                                              Availability

                                              Visible Sections, Subsections, Quickviews, and Tables Default
                                              Hiding Section, Subsection, Quickview and Table Content Available
                                              User Control of Visibility with See More/See Less Links Available:

                                              • With SAP Fiori elements for OData V2, the links are See More/See Less.
                                              • With SAP Fiori elements for OData V4, the links are Show More/Show Less.
                                              Visible Smart Form Fields Default, you can hide them in certain conditions.

                                              Content Area


                                              Navigation Bar

                                              By default, the anchor bar is generated when the object page has at least one section.

                                              It lets users navigate to the individual content area sections.

                                              You can:

                                              • Hide the anchor bar when you only have one section.
                                              • Replace it with a tab bar.

                                              With extensions, you can replace the buttons with another type of control.

                                              For more information, see:


                                              Sections and Subsections

                                              You can add sections and subsections to the content area.

                                              Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                              For more information, see: Sections and Subsections.


                                              Reuse Components as Sections

                                              You can embed a reuse component as a section in the object page.

                                              Warning
                                              A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                              Consult the development team on the requirements for the reuse component.


                                              Subsections

                                              With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                              The smart link contact can include a contact list and a quickview of the contact details.

                                              For more information, see:


                                              Tables

                                              You can include a table in a subsection.

                                              For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                              Smart Charts

                                              You can include a single smart chart facet in a subsection.

                                              In a smart chart, you can:

                                              • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                              • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                              For more information, see Smart Chart.


                                              Variant Management for Tables and Charts

                                              You can turn variant management on for:

                                              • All the tables and charts on the page
                                              • Individual tables and charts

                                              For more information, see Variant Management.


                                              Address

                                              You can add one or more address fields:

                                              • As a separate subsection
                                              • As part of a field group within a subsection
                                              • To a quick view with smart link navigation

                                              For more information, see:


                                              Forms

                                              You can add action buttons to the toolbar for a form contained in a subsection.

                                              In the subsection toolbar, the action types can be:

                                              • Actions that occur in the system while the user stays on the object page.
                                              • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                              Conditional Enablement of Navigation Buttons

                                              You can enable buttons that navigate the user to another page or application based on the value of a specific field with SAP Fiori elements for OData V4. To achieve this with SAP Fiori elements for OData V2 requires extensions.

                                              For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                              Guidelines
                                              Implement this feature only when the way to enable the button is obvious to end users.

                                              Groups in a Form

                                              You can group fields in a form and assign a name to the group.

                                              Note that the group name is displayed only when a group contains fields.

                                              Growing Text Control

                                              By default, with SAP Fiori elements for OData V4, in edit mode, the default length of the text control allows for the entry of four lines of text.

                                              You can:

                                              • Change the defaullt number.
                                              • Enable growing mode so the length of the text control on first load allows for the number of lines that you specificy. After the user has entered that number of lines, the length grows by the same number of lines and a scrollbar is displayed next to the text entry area.

                                              Dynamic Side Content

                                              You can display additional content to the right of an object page subsection. Consult with the development team on doing this with a standard extension.

                                              With this feature, the subsection toolbar contains a Show Details/Hide Details action for users to control the display of the dynamic side content. By default, the side content is hidden. You can show it instead. You can also rename the action to make it meaningful to the end user.

                                                Guidelines

                                                • Do not use tables in the side content panel.
                                                • Do not add content that may introduce a horizontal scroll bar to the dynamic side content.
                                                • For the best view of the dynamic side content, set it to display in 50% of the screen.

                                                For more information, see:

                                                Developer Hint

                                                Subsection Behavior


                                                Subsection Loading Behavior

                                                By default, the subsection starts loading after the main object page elements are loaded.

                                                You can change the loading behavior to load the subsection after the header data is loaded.

                                                Example

                                                When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                                Width for Content Display in a Subsection

                                                When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                                Content Visibility


                                                Sections, Subsections, Quickviews, and Tables

                                                By default, the object page displays these components.

                                                You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                                User Control of Visibility

                                                You can turn on these links to allow users to control the display of subsections with the:

                                                • See More/See Less link with SAP Fiori elements for OData V2.
                                                • Show More/Show Less link with SAP Fiori elements for OData V4.

                                                The links display in the bottom right corner of the section:

                                                • When the subsection is hidden, the See More or Show More link is displayed.
                                                • When the subsection shows, the See Less or Show Less link is displayed.

                                                Visibility of Smart Form Fields

                                                By default, all smart form fields have the high importance setting and show on all screen sizes.

                                                You can lower the level of importance for the fields to hide them on smaller screens.

                                                According to the importance assigned to the field, it is displayed as follows:

                                                • High (default): On all (small, medium, and large) screen sizes.
                                                • Medium: On large and medium screens only.
                                                • Low: On large screens only

                                                For more information, see Responsiveness.

                                                Related Links

                                                Elements and Controls

                                                Object Page – Content Area

                                                The SAP Fiori elements object page template supports the features and settings for the object page content area detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Feature Availability

                                                 

                                                 

                                                Content Area

                                                 

                                                Availability

                                                Navigation Bar: Anchor Bar Default, you can turn it off when you only have one section.
                                                Navigation Bar: Tab Bar Available
                                                Sections and Subsections Available
                                                Reuse Components as Sections Available
                                                 

                                                Subsections

                                                 

                                                Availability

                                                Smart Link Contact Available, SAP Fiori elements for OData V2 only
                                                Tables Available
                                                Smart Charts Available
                                                Variant Management for Tables and Charts Available
                                                Address Available, SAP Fiori elements for OData V2 only
                                                Forms Available
                                                 

                                                Subsection Behavior

                                                 

                                                Availability

                                                Subsection Starts Loading After the Object Page Elements Are Loaded Default, you can change the behavior.
                                                Adjustment of the Width for Content Display in a Subsection Available
                                                 

                                                Content Visibility

                                                 

                                                Availability

                                                Visible Sections, Subsections, Quickviews, and Tables Default
                                                Hiding Section, Subsection, Quickview and Table Content Available
                                                User Control of Visibility with See More/See Less Links Available:

                                                • With SAP Fiori elements for OData V2, the links are See More/See Less.
                                                • With SAP Fiori elements for OData V4, the links are Show More/Show Less.
                                                Visible Smart Form Fields Default, you can hide them in certain conditions.

                                                Content Area


                                                Navigation Bar

                                                By default, the anchor bar is generated when the object page has at least one section.

                                                It lets users navigate to the individual content area sections.

                                                You can:

                                                • Hide the anchor bar when you only have one section.
                                                • Replace it with a tab bar.

                                                With extensions, you can replace the buttons with another type of control.

                                                For more information, see:


                                                Sections and Subsections

                                                You can add sections and subsections to the content area.

                                                Sections contain only subsections. You build the subsection content with tables, charts, and forms.

                                                For more information, see: Sections and Subsections.


                                                Reuse Components as Sections

                                                You can embed a reuse component as a section in the object page.

                                                Warning
                                                A reuse component that is used in an SAP Fiori elements-based application cannot be used in a freestyle application.

                                                Consult the development team on the requirements for the reuse component.


                                                Subsections


                                                Smart Link Contact

                                                With SAP Fiori elements for OData V2, you can include one or more smart link contacts in the subsections.

                                                The smart link contact can include a contact list and a quickview of the contact details.

                                                For more information, see:


                                                Tables

                                                You can include a table in a subsection.

                                                For more information on SAP Fiori elements capabilities for tables, see the articles under SAP Fiori Elements: Table, starting with Table Types.


                                                Smart Charts

                                                You can include a single smart chart facet in a subsection.

                                                In a smart chart, you can:

                                                • Display measures, aggregations calculations, and dimension categories as labels in the chart.
                                                • Add actions to the toolbar for a smart chart and define whether they are enabled always or only after the user selects part of the chart for the action.

                                                For more information, see Smart Chart.


                                                Variant Management for Tables and Charts

                                                You can turn variant management on for:

                                                • All the tables and charts on the page
                                                • Individual tables and charts

                                                For more information, see Variant Management.


                                                Address

                                                With SAP Fiori elements for OData V2, you can add one or more address fields:

                                                • As a separate subsection
                                                • As part of a field group within a subsection
                                                • To a quick view with smart link navigation

                                                For more information, see:


                                                Forms

                                                You can add action buttons to the toolbar for a form contained in a subsection.

                                                In the subsection toolbar, the action types can be:

                                                • Actions that occur in the system while the user stays on the object page.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order.

                                                Subsection Behavior


                                                Subsection Loading Behavior

                                                By default, the subsection starts loading after the main object page elements are loaded.

                                                You can change the loading behavior to load the subsection after the header data is loaded.

                                                Example

                                                When the subsection contains a table or chart and you want to allow the user to filter in the header before subsection data loads.


                                                Width for Content Display in a Subsection

                                                When you mix content — such as forms and tables — in one subsection, you can adjust the width allotted to each content type to display a table next to a form.

                                                Content Visibility


                                                Sections, Subsections, Quickviews, and Tables

                                                By default, the object page displays these components.

                                                You can set the entire components or selected content in the components to be displayed or hidden in the content area, according to the object’s state. For example, you can hide the Delivery section in a Sales Order until the order has a status where the delivery is planned.


                                                User Control of Visibility

                                                You can turn on these links to allow users to control the display of subsections with the:

                                                • See More/See Less link with SAP Fiori elements for OData V2.
                                                • Show More/Show Less link with SAP Fiori elements for OData V4.

                                                The links display in the bottom right corner of the section:

                                                • When the subsection is hidden, the See More or Show More link is displayed.
                                                • When the subsection shows, the See Less or Show Less link is displayed.

                                                Visibility of Smart Form Fields

                                                By default, all smart form fields have the high importance setting and show on all screen sizes.

                                                You can lower the level of importance for the fields to hide them on smaller screens.

                                                According to the importance assigned to the field, it is displayed as follows:

                                                • High (default): On all (small, medium, and large) screen sizes.
                                                • Medium: On large and medium screens only.
                                                • Low: On large screens only

                                                For more information, see Responsiveness.

                                                Related Links

                                                Elements and Controls

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                   
                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Empty Rows Available for responsive and grid tables in an object page
                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                                                In edit mode, the multiple values are displayed, but not editable.

                                                The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions

                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Direct Edit

                                                You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                                                This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                                • One table row for a toolbar action, using a radio button.
                                                • Multiple table rows for a toolbar action, using checkboxes.
                                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                                  For complete information, see: Select All / Clear All.
                                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                                SAP Fiori elements for OData V4

                                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                                • In display mode, item selection is not possible.
                                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable one of the following selection modes:

                                                • None:
                                                  • Display mode allows no item selection.
                                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                                • Single: Both display and edit modes allow single item selection.
                                                • Multi: Both display and edit modes allow multiple item selection.
                                                Warning
                                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to:


                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Empty Rows

                                                With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display two empty rows where the user can enter data for subobjects. The purpose of displaying two empty rows is to give the user a choice between entering data for one column at a time or for one row at a time.

                                                You can enable the feature at the table level in draft-enabled applications.

                                                The empty rows cannot be deleted.

                                                As soon as the user has entered data in one field in an empty row and moved the focus away from that field:

                                                • The row with the completed field is highlighted with a blue line to its left to show it’s a newly created draft.
                                                • The row displays the navigation chevron. Deletion also supported for the row.
                                                • A new empty row is added under the highlighted row so two empty rows are always available for data entry.

                                                With both SAP Fiori elements for OData V2 and V4, the empty rows are displayed:

                                                • At the end of a grid table.
                                                  The Create button in the toolbar scrolls to the first empty row at the end of the table and puts the focus on the first editable field.
                                                • At the top of the responsive table.
                                                  The toolbar has no Create button.

                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                                Field Labels

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                                Limitation on Export to Spreadsheet

                                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                                Information

                                                Write a short and meaningful message.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                   
                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Empty Rows Available for responsive and grid tables in an object page
                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                                                In edit mode, the multiple values are displayed, but not editable.

                                                The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions

                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Direct Edit

                                                You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                                                This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                                • One table row for a toolbar action, using a radio button.
                                                • Multiple table rows for a toolbar action, using checkboxes.
                                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                                  For complete information, see: Select All / Clear All.
                                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                                SAP Fiori elements for OData V4

                                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                                • In display mode, item selection is not possible.
                                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable one of the following selection modes:

                                                • None:
                                                  • Display mode allows no item selection.
                                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                                • Single: Both display and edit modes allow single item selection.
                                                • Multi: Both display and edit modes allow multiple item selection.
                                                Warning
                                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to:


                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Empty Rows

                                                With this feature, when the object page is in create or edit mode, responsive tables and grid tables automatically display two empty rows where the user can enter data for subobjects. The purpose of displaying two empty rows is to give the user a choice between entering data for one column at a time or for one row at a time.

                                                You can enable the feature at the table level in draft-enabled applications.

                                                • Inline actions, such as delete or navigation to the item via the chevron are hidden on the empty rows.
                                                • Sorting and grouping are not applicable for the empty rows because they don’t exist in a table on the back end.

                                                As soon as the user has entered data in one field in an empty row and moved the focus away from that field:

                                                • The row with the completed field is highlighted with a blue line to its left to show it’s a newly created draft.
                                                • The row displays the navigation chevron. Deletion also supported for the row.
                                                • A new empty row is added under the highlighted row so two empty rows are always available for data entry.

                                                You can set default values to populate fields in the empty rows.

                                                With both SAP Fiori elements for OData V2 and V4, the empty rows are displayed:

                                                • At the end of a grid table.
                                                  The Create button in the toolbar scrolls to the first empty row at the end of the table and puts the focus on the first editable field.
                                                • At the top of the responsive table.
                                                  The toolbar has no Create button.

                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                                Field Labels

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                                Limitation on Export to Spreadsheet

                                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                                Information

                                                Write a short and meaningful message.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                   
                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Direct Edit Available for responsive and grid tables with SAP Fiori elements for OData V2
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Table Cells with Multiple Values Available with SAP Fiori elements for OData V4

                                                In edit mode, the multiple values are displayed, but not editable.

                                                The cells that displayed multiple values in the table onscreen are empty when exported to a spreadsheet.

                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .

                                                Direct Edit

                                                You can enable this action to let users navigate from the table row to the corresponding object page in edit mode with the Edit icon  with SAP Fiori elements for OData V2.

                                                This feature is available for responsive and grid tables. When it’s enabled, the object page footer displays the Save and Next  button.


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                                • One table row for a toolbar action, using a radio button.
                                                • Multiple table rows for a toolbar action, using checkboxes.
                                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                                  For complete information, see: Select All / Clear All.
                                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                                SAP Fiori elements for OData V4

                                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                                • In display mode, item selection is not possible.
                                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable one of the following selection modes:

                                                • None:
                                                  • Display mode allows no item selection.
                                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                                • Single: Both display and edit modes allow single item selection.
                                                • Multi: Both display and edit modes allow multiple item selection.
                                                Warning
                                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to:


                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                                Field Labels

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                                Limitation on Export to Spreadsheet

                                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                                Information

                                                Write a short and meaningful message.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default for grid tables, analytical tables and tree tables. You can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                Both versions of SAP Fiori elements allow you to determine whether users can select:

                                                • One table row for a toolbar action, using a radio button.
                                                • Multiple table rows for a toolbar action, using checkboxes.
                                                  For an object page, you can enable selection of multiple rows for all the tables on the page, or for specific tables only.
                                                  For an analytical table, grid table, or tree table, ask the development team to use the Multi-Selection Plugin.

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements have the following defaults that you can change:

                                                • Display of either the Select All or Clear All checkbox in the header of the selection column. The two versions differ in the way they do this.
                                                  For complete information, see: Select All / Clear All.
                                                • A limit of 200 rows that the user can select at once for grid tables, analytical tables and tree tables.
                                                  You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled for a table. You can enable multiple item selection, known by application developers as multiselect.

                                                SAP Fiori elements for OData V4

                                                With the default auto mode, the application checks whether any table toolbar actions depend on item selection to be enabled. If not:

                                                • In display mode, item selection is not possible.
                                                • In edit mode, when the delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable one of the following selection modes:

                                                • None:
                                                  • Display mode allows no item selection.
                                                  • Edit mode allows multiple item selection when a Delete action is available in the table toolbar.
                                                • Single: Both display and edit modes allow single item selection.
                                                • Multi: Both display and edit modes allow multiple item selection.
                                                Warning
                                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to:


                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility and position in the table of a column that combines multiple fields can be changed.

                                                Field Labels

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. Then, the field group label is displayed as the column title in the header.

                                                Limitation on Export to Spreadsheet

                                                When users export a table with a column that contains multiple fields to a spreadsheet, only the first piece of information displayed in the column is exported.

                                                Information

                                                Write a short and meaningful message.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default for grid tables, tree tables and analytical tables, you can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled and allows users to select one table row for a toolbar action, using a radio button.

                                                You can enable users to select multiple table rows for a toolbar action, using checkboxes, known by application developers as multiselect.

                                                For  grid tables, analytical tables and tree tables, the maximum limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V4

                                                With the default “auto” mode, the application checks whether any actions in the table toolbar depend on item selection to be enabled. If not:

                                                • In display mode, item selection is not possible.
                                                • In edit mode, when the Delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable one of the following selection modes:

                                                • None: No item selection in display mode, and multiple item selection in edit mode, when a Delete action is available in the table toolbar.
                                                • Single: Single item selection in both display and edit modes.
                                                • Multi: Multiple item selection in both display and edit modes. When multi mode is enabled, the Clear All checkbox is enabled by default. When users select the Clear all checkbox, all the previously selected items are deselected.

                                                The only exception is for a responsive table on an object page with anchor bar mode, where the user can scroll to all the section content. The responsive table displays the Select All checkbox by default.

                                                By default, the maximum number of items that the user can select at one time is set to 200. You can change the maximum.

                                                Guidelines
                                                Only enable the Select All checkbox for a responsive table exceptionally because users find its behavior to be counter-intuitive in a table with many rows. When they select the checkbox, many users expect all the rows in the table to be selected, Instead, the selection is limited to all the rows currently displayed on the interface.

                                                Both Versions of SAP Fiori Elements: Object Page

                                                In an object page, you can enable multiple selection for all the tables on the page, or for specific tables only with both SAP Fiori elements for OData V2 and V4.

                                                Warning
                                                When  you enable multiple selection for the table, do not enable a delete action in the table rows. The application will fail to load when both these features are enabled.

                                                Instead, enable a delete action for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to Enabling Multiple Selection in Tables.

                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility of a column that combines multiple fields and its position in the table can be changed.

                                                Limitation

                                                When users export to a spreadsheet, only the first piece of information displayed in the column is exported.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default, you can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled and allows users to select one table row for a toolbar action, using a radio button.

                                                You can enable multiple item selection so users can select multiple table rows for a toolbar action, using checkboxes.By default, the maximum number of items that the user can select at one time is set to 200. You can change the maximum.

                                                SAP Fiori elements for OData V4

                                                With the default “auto” mode, the application checks whether any actions in the table toolbar depend on item selection to be enabled. If not, in display mode, item selection is not possible. In edit mode, when the Delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable:

                                                • Single item selection in both display and edit modes, called “single” mode.
                                                • Multiple item selection in both display and edit modes, called “multi” mode. When this mode is enabled, the Select All checkbox is also enabled by default.
                                                • No item selection in display mode, and multiple item selection in edit mode, when a Delete action is available in the table toolbar. This is mode is called “none.”

                                                By default, the maximum number of items that the user can select at one time is set to 200. You can change the maximum.

                                                Both Versions of SAP Fiori Elements: Object Page

                                                In an object page, you can enable multiple selection for all the tables on the page, or for specific tables only with both SAP Fiori elements for OData V2 and V4.

                                                Warning
                                                Do not enable a delete action in the table rows with multiple selection for the table. The application will fail to load.

                                                Instead, enable a delete action for the table with multiple selection for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to Enabling Multiple Selection in Tables.

                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility of a column that combines multiple fields and its position in the table can be changed.

                                                Limitation

                                                When users export to a spreadsheet, only the first piece of information displayed in the column is exported.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Conditional Enablement of Navigation Buttons For list report and object pages:

                                                • Available with SAP Fiori elements for OData V4
                                                • Requires an extension with SAP Fiori elements for OData V2
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Item Limit for Multiple Selection 200 by default, you can change the limit.
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Restrict Field to Read Only in a Table Available with SAP Fiori elements for OData V4
                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Avatar Tooltip Available
                                                Other Images Available with live box mode only
                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Conditional Enablement of Navigation Buttons

                                                In list reports and object pages:

                                                • With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.
                                                • With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Item Selection

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled and allows users to select one table row for a toolbar action, using a radio button.

                                                You can enable multiple item selection so users can select multiple table rows for a toolbar action, using checkboxes.By default, the maximum number of items that the user can select at one time is set to 200. You can change the maximum.

                                                SAP Fiori elements for OData V4

                                                With the default “auto” mode, the application checks whether any actions in the table toolbar depend on item selection to be enabled. If not, in display mode, item selection is not possible. In edit mode, when the Delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable:

                                                • Single item selection in both display and edit modes, called “single” mode.
                                                • Multiple item selection in both display and edit modes, called “multi” mode. When this mode is enabled, the Select All checkbox is also enabled by default.
                                                • No item selection in display mode, and multiple item selection in edit mode, when a Delete action is available in the table toolbar. This is mode is called “none.”

                                                By default, the maximum number of items that the user can select at one time is set to 200. You can change the maximum.

                                                Both Versions of SAP Fiori Elements: Object Page

                                                In an object page, you can enable multiple selection for all the tables on the page, or for specific tables only with both SAP Fiori elements for OData V2 and V4.

                                                Warning
                                                Do not enable a delete action in the table rows with multiple selection for the table. The application will fail to load.

                                                Instead, enable a delete action for the table with multiple selection for the table. The delete action is then available in the table toolbar.

                                                For more information, see:

                                                Developer Hint
                                                For more information, refer the development team to Enabling Multiple Selection in Tables.

                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Read-Only Field

                                                With SAP Fiori elements for OData V4, you can set a field to display as read-only in a table, but set it as editable in another place on the UI.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row and set a tooltip that displays when the focus is on the avatar.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility of a column that combines multiple fields and its position in the table can be changed.

                                                Limitation

                                                When users export to a spreadsheet, only the first piece of information displayed in the column is exported.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Rows

                                                The SAP Fiori elements templates support the features and settings for table rows or inline items detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links below.

                                                Feature Availability

                                                 

                                                Actions

                                                 

                                                Availability

                                                Inline Actions Available
                                                Single Item Selection Default
                                                Multiple Item Selection Available
                                                Delete Available in responsive tables only
                                                Custom Actions Available
                                                Messages for Critical Actions Default, replace the generic placeholder text with meaningful text for the user.
                                                 

                                                Display

                                                 

                                                Availability

                                                Editing Status: Displayed in First Column Default for draft-enabled applications
                                                Rating Indicator Available
                                                Progress Indicator Available
                                                Quick Contact View Available
                                                Avatar Available
                                                Other Images Available with live box mode only
                                                Highlighting New Line Items Available with SAP Fiori elements for OData V2

                                                Default with SAP Fiori elements for OData V4 for grid and responsive tables in draft-enabled applications

                                                Highlighting Line Items Based on Criticality Available
                                                 

                                                Responsive Table Only

                                                 

                                                Availability

                                                Multiple Fields in a Single Column Available
                                                Smart Micro Chart Available

                                                Actions


                                                Inline Actions

                                                You can define actions for table rows or inline items. The action types can be:

                                                • Actions that occur in the system while the user stays on the list report screen, for example Approve or Reject.
                                                • Actions that navigate to a different application, for example, when the user can open a purchase requisition from a specific purchase order in the table.

                                                When a page contains a grid table, an analytical table, or tree table that leads to object or subobject pages, users can navigate to the object or subject page at row level. The Show Detail button is not displayed in these tables. Instead, users can click the navigation indicator:   .


                                                Item Selection

                                                SAP Fiori elements for OData V2

                                                By default, single selection is enabled and allows users to select one table row for a toolbar action, using a radio button.

                                                You can enable multiple item selection and allow users to select multiple table rows for a toolbar action, using checkboxes.

                                                SAP Fiori elements for OData V4

                                                With the default “auto” mode, the application checks whether any actions in the table toolbar depend on item selection to be enabled. If not, in display mode, item selection is not possible. In edit mode, when the Delete action is enabled, multiple selection is also enabled.

                                                Instead, you can enable:

                                                • Single item selection in both display and edit modes, called “single” mode.
                                                • Multiple item selection in both display and edit modes, called “multi” mode. When this mode is enabled, the Select All checkbox is also enabled by default.
                                                • No item selection in display mode, and multiple item selection in edit mode, when a Delete action is available in the table toolbar. This is mode is called “none.”

                                                Both Versions of SAP Fiori Elements: Object Page

                                                In an object page, you can enable multiple selection for all the tables on the page, or for specific tables only with both SAP Fiori elements for OData V2 and V4.

                                                Warning
                                                Do not enable a delete action in the table rows with multiple selection for the table. The application will fail to load.

                                                Instead, enable a delete action for the table with multiple selection for the table. The delete action is then available in the table toolbar.

                                                Developer Hint
                                                For more information, refer the development team to: Enabling Multiple Selection in Tables.

                                                For more information, see:


                                                Delete

                                                In responsive tables only, you can:

                                                • Display an inline delete action.
                                                • Prevent the deletion of certain rows.

                                                In support of best design practices, SAP Fiori elements does not allow you to combine an inline delete action with a central delete action in the toolbar.

                                                For more information, see Delete Single Item Rows.


                                                Custom Actions

                                                You can define custom inline actions.

                                                Because custom inline actions are grouped, you cannot control their exact display order. However, you can control which columns display the groups.


                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to check the users want to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines
                                                Replace the generic placeholder text in the messages with text that’s meaningful to the users, as shown in the example below. You do this by providing the new text to the develoment team for update in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”

                                                For more information, see UI Text Guidelines for SAP Fiori Apps.


                                                Display

                                                You can include the display features described below in a table row or inline item.


                                                Editing Status

                                                By default, the table displays the editing status in the first column for draft-enabled applications.

                                                You can also add the semantic key to the status.

                                                The editing status reflects the state of the object or item in the processing cycle. For example, it can give the user information about the state of completion for the item or whether it’s currently available.

                                                • For Unsaved Changes and Locked statuses, a popover displays the full name or technical name of the user who last changed the object  when the name is available. “Another user” is displayed when it’s not.
                                                • For Draft, Unsaved Changes and Locked statuses, a popover displays the user who last changed the item and the time of the change.

                                                The user can change the placement of the column through table personalization.

                                                For more information, see Tables.


                                                Rating Indicator

                                                You can add an inline, read-only rating indicator and define a maximum rating of up to five stars. By default, five stars is the maximum.

                                                The number of stars displayed depends on the value of a field in the backend. Decimal values are rounded up or down and when the value after the decimal point falls between x.25 and x.74, it is represented by a half star.

                                                With extensions, you can enable editing of the rating indicator

                                                For more information, see Rating Indicator.


                                                Progress Indicator

                                                You can:

                                                • Enable an inline progress indicator to visually represent the level of completion of a project or goal, for example.
                                                • Set the progress measure as a percentage or an absolute number, for example 3 or 8.
                                                • Configure the progress bar to reflect the state of progress with color, based on the criticality of the progress.

                                                For more information, see Progress Indicator.


                                                Quick Contact View

                                                You can add a quick view to a contact to display key contact details in a popover.

                                                For more information, see: Quickview.


                                                Avatar and Other Images

                                                You can display an avatar in the row.

                                                Warning
                                                Other images are not displayed correctly within the table borders. Only use them with live box mode.

                                                For more information, see: Avatar.


                                                Highlighting Line Items

                                                By default with SAP Fiori elements for OData V4, in draft-enabled applications, a newly created item in draft status is always highlighted in blue in grid and responsive tables.

                                                Highlighting of new line items in draft-enabled applications is available with both SAP Fiori elements for OData V2 and V4.

                                                You can also define highlighting and icons for line items based on their criticality.

                                                After a newly created item is saved, it is highlighted according to the criticality, as follows:

                                                • Green for success (criticality value 3)
                                                • Yellow for warning (criticality value 2)
                                                • Red for error (criticality value 1)
                                                • No highlighting for no criticality (criticality value 0)

                                                Display in Responsive Table Only

                                                In a responsive table, you can include the display features described below in a table row or inline item.


                                                Multiple Fields in a Single Column

                                                You can combine multiple IDs, descriptions, and action buttons in a single column in a responsive table.

                                                For example, you can display the following in a single column:

                                                • Company name
                                                • Company ID
                                                • Items in Stock
                                                • Progress Indicator for Items in Stock
                                                • Overall value of the Items
                                                • Multiple Action buttons that allow the user to both:
                                                  • Execute an action while staying on the list report page
                                                  • Navigate to other objects and applications

                                                The visibility of a column that combines multiple fields and its position in the table can be changed.

                                                Limitation

                                                When users export to Microsoft Excel, only the first piece of information displayed in the column is exported.


                                                Smart Micro Chart

                                                You can:

                                                • Add an inline micro chart.
                                                • Set the chart to indicate the criticality of the data shown in the chart relative to target values or value ranges.

                                                You can choose among the following micro chart types:

                                                • Area micro chart
                                                • Bullet micro chart
                                                • Line micro chart
                                                • Micro chart/smart micro chart
                                                • Radial micro chart
                                                • Stacked bar micro chart
                                                Warning
                                                The user cannot navigate to another page from the chart.

                                                For more information on chart types, see: Choosing the Correct Chart Type.

                                                Related Links

                                                Table Features

                                                The SAP Fiori elements templates support the features and settings for a table detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links within this article.

                                                Feature Availability

                                                 

                                                Table Settings

                                                 

                                                Availability

                                                Column Heading Labels You set these.
                                                Tooltips on Column Header Labels Available for exceptional use cases with SAP Fiori elements for OData V4
                                                Clear All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

                                                • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                • Responsive tables in a list report

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

                                                You can change the default.

                                                Select All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

                                                You can change the default.

                                                Sticky Column Header Behavior Default, you can turn it off.
                                                Column Width The default width depends on the column contents. You can change it.
                                                Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                                                You can change the level of importance.

                                                Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                                                Ascending Sort Order on a Column Default, you can change it.
                                                Grouping Available in responsive and analytical tables
                                                Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                                                No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                                                Message Strip for the Table Available, a message strip above the table can display all the messages related to the table in order of their severity.

                                                With SAP Fiori elements for OData V2, an extension lets you set a custom message to display in the message strip above the table in the list report, analytical page, and object page.

                                                 

                                                List Report and Analytical Page Only

                                                 

                                                Availability

                                                Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                                                 

                                                Object Page Only

                                                 

                                                Availability

                                                Message Strip for Rows with Errors Default

                                                Table Settings


                                                Tooltips on Column Header Labels

                                                Warning
                                                Available with SAP Fiori elements for OData V4, the tooltips on the column header label feature makes sense only when the users always work on a desktop with a mouse. The users must hover on the column header to see the tooltips.

                                                Clear All / Select All

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements:

                                                • Display by default either the Clear All checkbox or Select All  checkbox in the header of the selection column, as detailed in the next sections
                                                • Allow you to set which checkbox displays for all the tables on an object page, or for specific tables only

                                                When the Select All action is hidden, the user can still select a range of multiple items, by selecting an item, pressing Shift, and selecting others.

                                                For  grid tables, analytical tables and tree tables, the default limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2 Defaults

                                                When the selection of multiple rows (or multiselect) is enabled, the selection column header displays by default:

                                                • The Clear All checkbox for:
                                                  • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                  • Responsive tables in a list report
                                                • The Select All  checkbox for a responsive table in an object page

                                                You can change the default.

                                                SAP Fiori elements for OData V4

                                                When the selection of multiple rows (or multi mode) is enabled, the selection column header displays by default the Clear All checkbox for all tables but a responsive table in an object page with anchor bar mode. In this case, the responsive table displays the Select All  checkbox because the user can scroll to all the section content.

                                                You can change the default.

                                                Warning
                                                For an optimal user experience only display the Select All checkbox for a small number of items because:

                                                • When the user clicks Select All, all the items or rows load from the backend. Loading many items can require multiple requests to the system and, consequently, take time.
                                                • When a responsive table contains so many rows that they cannot all be displayed onscreen, many users expect the Select All to select all the rows in the table. In fact, it selects all the rows currently displayed on the interface.

                                                Guidelines
                                                When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                                                Column Width

                                                The default column width varies according to the column contents:

                                                • Text: can range from 3 to 20 rem
                                                • Image: 5 rem
                                                • Rating or progress indicator: 6.875 rem
                                                • Chart: 20 rem

                                                You can can change the width.

                                                Developer Hint
                                                For more information, refer the development team to Setting the Default Column Width.

                                                Column Importance in Responsive Tables

                                                By default:

                                                • Key fields have high importance in list reports.
                                                • Other columns have the importance of none and are handled like columns assigned medium importance.

                                                You can change the level of importance.

                                                The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                                                • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                                                • The values in columns with low importance are first to be hidden.

                                                When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                                                You can also assign an importance to custom columns.

                                                For more information, see:


                                                Labels for Multiple Fields in a Column

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                                                Sort Order

                                                By default, the sort order for a column is ascending.

                                                You can:

                                                • Set the default sort order to descending.
                                                • Define other, customized sort orders.

                                                For more information, see the sort guidelines according to table type:


                                                Number of Table Rows Displayed at Once

                                                By default, a responsive table loads the following number of rows at once:

                                                • 20 rows in a list report.
                                                • 10 rows in an object page with multiple sections.

                                                When more rows exist, the users can click the More button at the end of the table to view additional rows.

                                                With SAP Fiori elements for OData V2, you can change the default number.

                                                For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                                                Guidelines
                                                Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                                                Grouping

                                                Grouping is available in responsive and analytical tables.

                                                You can define the format of the grouping headers.

                                                For more information, see:



                                                No Data Found Text

                                                By default, the following text is displayed when no data is found.

                                                • When the user has not applied filters, the text is “No data found.”
                                                • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                                                Guidelines
                                                Replace the generic text with text that’s meaningful to the user.

                                                List Report and Analytical Page Only

                                                Initial Expansion of Table Levels

                                                By default, on initial load, the following expandable tables are expanded to this number of levels:

                                                • Responsive table: 1 level
                                                • Tree table: 1 level
                                                • Analytical table: 0 levels

                                                You can change the default value for the tree table and analytical tables.

                                                Developer Hint
                                                For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                                                Object Page Only

                                                Message Strip for Rows with Errors

                                                When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                                                Related Links

                                                Object Page – Header

                                                The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                Behavior and Interaction

                                                 

                                                Availability

                                                Expanded State Default on initial load
                                                Collapsed State Default on scroll

                                                With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                                Header Content Display in Display Mode In the header content area
                                                Header Content Display in Edit and Create Modes When the header is editable:

                                                • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.
                                                • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.
                                                Header Content Visible Default, you can hide it.
                                                Header Content Hidden Available
                                                Header Field Editability By default, in edit mode the header is:

                                                • Not editable with SAP Fiori elements for OData V2
                                                • Editable with SAP Fiori elements for OData V4

                                                You can change the default.

                                                Highlighting Values Based on Criticality Available
                                                 

                                                Components

                                                 

                                                Availability

                                                Dynamic Page Header Mandatory, it must be configured.
                                                Title Mandatory, you must define it.
                                                Menu for Saved Version / Draft Default for draft-enabled applications
                                                Breadcrumbs Default
                                                Subtitle Available, you define the text.
                                                Object Marker Default in draft-enabled applications
                                                Image Available
                                                Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                                Paging Buttons on the First Subobject Page Default under certain conditions
                                                Toolbar Available
                                                 

                                                Toolbar Actions

                                                 

                                                Availability

                                                Edit and Delete Default, when the data allows these actions.

                                                You can turn one or both actions off.

                                                Copy Available with SAP Fiori elements for OData V2
                                                Related Apps Menu Button Available

                                                With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                                Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                                Application-Specific Actions Available,  they must be configured.
                                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                                Requires an extension with SAP Fiori elements for OData V2

                                                Order of Toolbar Actions Default

                                                You can change the default order.

                                                 

                                                Additional Content (Optional)

                                                 

                                                Availability

                                                Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                                Plain Text Facets Available
                                                Contact Facets Available
                                                Micro Chart Facets Available
                                                Form Facets Available
                                                Address Facets Available
                                                Header Field Group Available
                                                Rating Indicator Facets Available
                                                Progress Indicator Facet Available
                                                Key Value Facet Available
                                                Link Available

                                                With SAP Fiori elements for OData V2:

                                                • The default link shows the text and ID. You can remove the text or the ID from the link.
                                                • You can include a link that navigates to a site external to the application.

                                                Behavior and Interaction


                                                Collapsed/Expanded State

                                                When the object page header contains at least one facet:

                                                • On the initial load of the object page, the header is expanded.
                                                • When the user scrolls down the page, the header collapses.
                                                • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                                When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                                With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                                Next to the title, an arrow   button lets the users expand the header.

                                                Summary Line for Object Page Header on Small Screens
                                                Summary Line for Object Page Header on Small Screens

                                                Display of Header Content

                                                In display mode, the header content area displays all the header content.

                                                In edit and create modes, when the header is:

                                                • Editable
                                                  • The first dynamic section in the content area, the header section, displays all the fields in the header that can be rendered in a form — both editable and uneditable fields.

                                                The header section is only present in the edit and create modes.

                                                  • UI elements in the header that cannot be rendered in a form, such as micro charts, are not shown.

                                                 

                                                • Not Editable, the header is hidden.

                                                Note that, by default, the header is

                                                • Editable with SAP Fiori elements for OData V4
                                                • Not editable with SAP Fiori elements for OData V2

                                                You can ask the application developers to change the default.

                                                For more information, see Dynamic Page Header (Mandatory).

                                                Developer Hint
                                                To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                                Header Content Visibility

                                                By default, header content is visible.

                                                You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                                • Entire header facets
                                                • Content, such as fields, in a header facet
                                                • Content in quick views

                                                With Fiori elements for OData V2, you can set:

                                                • The header to be displayed in edit mode.
                                                • Header facets to be visible in edit mode.
                                                Developer Hint
                                                For more information on the features, refer the development team to:


                                                Header Field Editability

                                                By default, in edit mode the header is:

                                                • Not editable with SAP Fiori elements for OData V2
                                                • Editable with SAP Fiori elements for OData V4

                                                You can change the default.

                                                Even when the header is editable, certain fields or facets in the header may not be editable, for example, micro chart facets or text fields marked as ReadOnly.

                                                Developer Hint
                                                To change the default for the editability of the header, you can refer the application developers to: Toggling the Editability of Header Fields.

                                                Highlighting Values Based on Criticality

                                                You can assign colors and icons to text to indicate the criticality of a field value.

                                                With SAP Fiori elements for OData V4, you can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link so users know the quick view is available.

                                                You can display the following microcharts in the header:

                                                • Area micro chart
                                                • Bullet chart
                                                • Radial chart
                                                • Column chart
                                                • Line micro chart
                                                • Harvey ball chart
                                                • Stacked bar chart

                                                Components


                                                Title

                                                By default, with:

                                                •  SAP Fiori elements for OData V2, the title area is empty.
                                                •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                                Guidelines
                                                Tell the developers which property to use as the title.

                                                Menu for Saved Version / Draft

                                                With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                                Breadcrumbs

                                                Breadcrumbs are displayed above the object title.

                                                Guidelines
                                                Limit the breadcrumbs to the drilldown levels within the object page.

                                                Object Marker

                                                The object marker indicates the object is locked by another user in draft-enabled applications.


                                                Image

                                                The image is an avatar control. By default, it has a square shape.

                                                You can set:

                                                • An image to display instead of the avatar.
                                                • The avatar to a have a circular shape.

                                                When no image is set or found for the avatar, the avatar initials are displayed.

                                                If those are not set or found either, an icon for the avatar is displayed:

                                                • A square avatar for a product
                                                • A circular avatar for a person.

                                                For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                                Paging Buttons

                                                By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                                • The user has navigated from a table in the object page to the subobject.
                                                • The table in the object page contains at least two items.

                                                With SAP Fiori elements for OData V2, you can:

                                                • Enable the paging buttons to show on the first object page opened from a list report.
                                                • Disable the default display of the paging buttons on the subobject page.

                                                Toolbar Actions


                                                Edit and Delete

                                                By default, these actions are displayed when the data in the object page allows them.

                                                You can:

                                                • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                                • Disable the actions.

                                                For more information, see:


                                                Copy

                                                You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                                You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                                In the object page, the Copy button is displayed after the Delete button.

                                                Developer Hint
                                                Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                                Related Apps Menu Button

                                                You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                                You can also:

                                                • Hide specific actions in the menu.
                                                • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                                Generic Actions

                                                By default, the Share button is displayed for saved objects and hidden for drafts.

                                                For more information, see Share (Generic).


                                                Application-Specific Actions

                                                You can include the actions required for your use case.

                                                The header toolbar displays application-specific actions to the left of the generic actions.

                                                You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                                Developer Hint
                                                For more information, refer application developers to Keyboard Shortcuts.

                                                Conditional Enablement of Navigation Buttons

                                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Order of Toolbar Actions

                                                The default order — left to right — for actions in the object page toolbar is below:

                                                • Edit
                                                • Delete
                                                • Copy with SAP Fiori elements for OData V2
                                                • Application-specific action buttons
                                                • Related Apps menu button
                                                • Share

                                                You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                                For more information, see:

                                                Additional Content


                                                Simple Header Facets

                                                With SAP Fiori elements for OData V2:

                                                • You can use a simple header facet to show simple data points that align horizontally across the header.
                                                • When form fields contain no value, they display the empty  state indicator (–).

                                                Plain Text Facets

                                                You can use the plain text facet to display a continuous text in the header.

                                                For more information, see Plain Text Facet.


                                                Contact Facets

                                                You can enable a quick view for a contact.

                                                With SAP Fiori elements for OData V4:

                                                • When a quick view detail contains no value, the empty  state indicator (–) is displayed.
                                                • You can add a quick view to text that’s been set to display in a color to indicate the criticality of its value. The text is displayed underlined as a link, so users know the quick view is available.

                                                For more information, see Quick View.


                                                Micro Chart Facets

                                                For more information, see Micro Charts.


                                                Form Facets

                                                You can add a quick view to the form facet.

                                                For more information, see Form Facet (Dataset).

                                                Developer Hint
                                                For more information, refer the development team to Form Facet.

                                                Address Facets

                                                You can display an address such as a shipping address.

                                                Developer Hint
                                                For more information, refer the development team to Address Facet in the Object Page Header.

                                                Header Field Groups

                                                You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                                Rating Indicator Facets

                                                You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                                By default, the maximum rating is five stars.

                                                You can:

                                                • Change the maximum rating.
                                                • Specify more descriptive text for the subtitle.

                                                With extensions, you can make the rating editable.

                                                Display Mode

                                                The rating indicator shows with the:

                                                • Title
                                                • Subtitle with the total number of ratings
                                                • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                                Edit Mode

                                                The rating indicator moves into the header facet and appears with only the title in edit mode.

                                                For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                                For more information, see:


                                                Progress Indicator Facets

                                                You can add a progress indicator facet to the object header.

                                                For more information, see:


                                                Key Value Facets

                                                You can add a key value facet to highlight important data or KPIs.

                                                For more information, see Key Value Facet.

                                                Related Links

                                                Object Page – Overview

                                                The SAP Fiori elements object page template supports the features and settings for the overall object page behavior detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                   
                                                 

                                                Features

                                                 

                                                Availability

                                                Unsaved Changes Warning Default for the main object page in draft-enabled applications when the user navigates to:

                                                • Another application without saving changes. You can turn it off.
                                                • The previous page without saving changes.

                                                Feature Details

                                                Unsaved Changes Warning

                                                By default, in draft-enabled applications, on the main object page, a message warns users of unsaved changes when the users navigate:

                                                • Forward to another application without saving changes in edit mode or without entering data for a new object in create mode.

                                                You can ask the application developers to turn the message off for forward navigation. The draft is kept for the user to return to later.

                                                • Backward to the previous page without saving changes in edit mode or the data entered for a new object in create mode.
                                                Information
                                                No message is displayed when the user navigates backward without entering data for a new object in create mode. The object is discarded.

                                                Depending on whether the object page is in edit or create mode, the message lets the users opt to:

                                                • Save changes in edit mode
                                                • Create the object in create mode
                                                • Keep the draft
                                                • Discard the draft
                                                • Cancel the navigation
                                                Warning for unsaved changes in edit mode
                                                Warning for unsaved changes in edit mode
                                                Warning for unsaved changes in create mode
                                                Warning for unsaved changes in create mode

                                                Table Features

                                                The SAP Fiori elements templates support the features and settings for a table detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links within this article.

                                                Feature Availability

                                                 

                                                Table Settings

                                                 

                                                Availability

                                                Column Heading Labels You set these.
                                                Clear All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

                                                • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                • Responsive tables in a list report

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

                                                You can change the default.

                                                Select All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

                                                You can change the default.

                                                Sticky Column Header Behavior Default, you can turn it off.
                                                Column Width The default width depends on the column contents. You can change it.
                                                Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                                                You can change the level of importance.

                                                Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                                                Ascending Sort Order on a Column Default, you can change it.
                                                Grouping Available in responsive and analytical tables
                                                Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                                                No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                                                Message Strip for the Table Available, a message strip above the table can display all the messages related to the table in order of their severity.

                                                With SAP Fiori elements for OData V2, an extension lets you set a custom message to display in the message strip above the table in the list report, analytical page, and object page.

                                                 

                                                List Report and Analytical Page Only

                                                 

                                                Availability

                                                Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                                                 

                                                Object Page Only

                                                 

                                                Availability

                                                Message Strip for Rows with Errors Default

                                                Table Settings


                                                Clear All / Select All

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements:

                                                • Display by default either the Clear All checkbox or Select All  checkbox in the header of the selection column, as detailed in the next sections
                                                • Allow you to set which checkbox displays for all the tables on an object page, or for specific tables only

                                                When the Select All action is hidden, the user can still select a range of multiple items, by selecting an item, pressing Shift, and selecting others.

                                                For  grid tables, analytical tables and tree tables, the default limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2 Defaults

                                                When the selection of multiple rows (or multiselect) is enabled, the selection column header displays by default:

                                                • The Clear All checkbox for:
                                                  • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                  • Responsive tables in a list report
                                                • The Select All  checkbox for a responsive table in an object page

                                                You can change the default.

                                                SAP Fiori elements for OData V4

                                                When the selection of multiple rows (or multi mode) is enabled, the selection column header displays by default the Clear All checkbox for all tables but a responsive table in an object page with anchor bar mode. In this case, the responsive table displays the Select All  checkbox because the user can scroll to all the section content.

                                                You can change the default.

                                                Warning
                                                For an optimal user experience only display the Select All checkbox for a small number of items because:

                                                • When the user clicks Select All, all the items or rows load from the backend. Loading many items can require multiple requests to the system and, consequently, take time.
                                                • When a responsive table contains so many rows that they cannot all be displayed onscreen, many users expect the Select All to select all the rows in the table. In fact, it selects all the rows currently displayed on the interface.

                                                Guidelines
                                                When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                                                Column Width

                                                The default column width varies according to the column contents:

                                                • Text: can range from 3 to 20 rem
                                                • Image: 5 rem
                                                • Rating or progress indicator: 6.875 rem
                                                • Chart: 20 rem

                                                You can can change the width.

                                                Developer Hint
                                                For more information, refer the development team to Setting the Default Column Width.

                                                Column Importance in Responsive Tables

                                                By default:

                                                • Key fields have high importance in list reports.
                                                • Other columns have the importance of none and are handled like columns assigned medium importance.

                                                You can change the level of importance.

                                                The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                                                • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                                                • The values in columns with low importance are first to be hidden.

                                                When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                                                You can also assign an importance to custom columns.

                                                For more information, see:


                                                Labels for Multiple Fields in a Column

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                                                Sort Order

                                                By default, the sort order for a column is ascending.

                                                You can:

                                                • Set the default sort order to descending.
                                                • Define other, customized sort orders.

                                                For more information, see the sort guidelines according to table type:


                                                Number of Table Rows Displayed at Once

                                                By default, a responsive table loads the following number of rows at once:

                                                • 20 rows in a list report.
                                                • 10 rows in an object page with multiple sections.

                                                When more rows exist, the users can click the More button at the end of the table to view additional rows.

                                                With SAP Fiori elements for OData V2, you can change the default number.

                                                For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                                                Guidelines
                                                Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                                                Grouping

                                                Grouping is available in responsive and analytical tables.

                                                You can define the format of the grouping headers.

                                                For more information, see:



                                                No Data Found Text

                                                By default, the following text is displayed when no data is found.

                                                • When the user has not applied filters, the text is “No data found.”
                                                • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                                                Guidelines
                                                Replace the generic text with text that’s meaningful to the user.

                                                List Report and Analytical Page Only

                                                Initial Expansion of Table Levels

                                                By default, on initial load, the following expandable tables are expanded to this number of levels:

                                                • Responsive table: 1 level
                                                • Tree table: 1 level
                                                • Analytical table: 0 levels

                                                You can change the default value for the tree table and analytical tables.

                                                Developer Hint
                                                For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                                                Object Page Only

                                                Message Strip for Rows with Errors

                                                When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                                                Related Links

                                                Object Page – Header

                                                The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                Behavior and Interaction

                                                 

                                                Availability

                                                Expanded State Default on initial load
                                                Collapsed State Default on scroll

                                                With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                                Header Content Displayed in the Header Content Area and the Header Section Default in create and edit modes
                                                Header Content Visible Default, you can hide it.
                                                Header Content Hidden Available
                                                Making Header Fields Editable Available
                                                Highlighting Values Based on Criticality Available
                                                 

                                                Components

                                                 

                                                Availability

                                                Dynamic Page Header Mandatory, it must be configured.
                                                Title Mandatory, you must define it.
                                                Menu for Saved Version / Draft Default for draft-enabled applications
                                                Breadcrumbs Default
                                                Subtitle Available, you define the text.
                                                Object Marker Default in draft-enabled applications
                                                Image Available
                                                Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                                Paging Buttons on the First Subobject Page Default under certain conditions
                                                Toolbar Available
                                                 

                                                Toolbar Actions

                                                 

                                                Availability

                                                Edit and Delete Default, when the data allows these actions.

                                                You can turn one or both actions off.

                                                Copy Available with SAP Fiori elements for OData V2
                                                Related Apps Menu Button Available

                                                With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                                Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                                Application-Specific Actions Available,  they must be configured.
                                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                                Requires an extension with SAP Fiori elements for OData V2

                                                Order of Toolbar Actions Default

                                                You can change the default order.

                                                 

                                                Additional Content (Optional)

                                                 

                                                Availability

                                                Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                                Plain Text Facets Available
                                                Contact Facets Available
                                                Micro Chart Facets Available
                                                Form Facets Available
                                                Address Facets Available
                                                Header Field Group Available
                                                Rating Indicator Facets Available
                                                Progress Indicator Facet Available
                                                Key Value Facet Available
                                                Link Available

                                                With SAP Fiori elements for OData V2:

                                                • The default link shows the text and ID. You can remove the text or the ID from the link.
                                                • You can include a link that navigates to a site external to the application.

                                                Behavior and Interaction


                                                Collapsed/Expanded State

                                                When the object page header contains at least one facet:

                                                • On the initial load of the object page, the header is expanded.
                                                • When the user scrolls down the page, the header collapses.
                                                • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                                When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                                With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                                Next to the title, an arrow   button lets the users expand the header.

                                                Summary Line for Object Page Header on Small Screens
                                                Summary Line for Object Page Header on Small Screens

                                                Display of Header Content

                                                In display mode, the header content area displays all the header content.

                                                In edit and create modes, the header content is displayed in two places:

                                                • The header content area, at the top of the page, displays uneditable header content. By default, all header content is uneditable. You can make specific fields editable. See Making Header Fields Editable below.
                                                • The Header section, the first dynamic section in the content area, displays editable header content. It’s only present in the edit and create modes.

                                                For more information, see Dynamic Page Header (Mandatory).


                                                Header Content Visibility

                                                By default, header content is visible.

                                                You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                                • Entire header facets
                                                • Content, such as fields, in a header facet
                                                • Content in quick views

                                                With Fiori elements for OData V2, you can set:

                                                • The header to be displayed in edit mode.
                                                • Header facets to be visible in edit mode.
                                                Developer Hint
                                                For more information on the features, refer the development team to:


                                                Making Header Fields Editable

                                                You can make fields in the object page header editable in edit mode.


                                                Highlighting Values Based on Criticality

                                                You can assign colors and icons to text to indicate the criticality of a field value.

                                                Components


                                                Title

                                                By default, with:

                                                •  SAP Fiori elements for OData V2, the title area is empty.
                                                •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                                Guidelines
                                                Tell the developers which property to use as the title.

                                                Menu for Saved Version / Draft

                                                With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                                Breadcrumbs

                                                Breadcrumbs are displayed above the object title.

                                                Guidelines
                                                Limit the breadcrumbs to the drilldown levels within the object page.

                                                Object Marker

                                                The object marker indicates the object is locked by another user in draft-enabled applications.


                                                Image

                                                The image is an avatar control. By default, it has a square shape.

                                                You can set:

                                                • An image to display instead of the avatar.
                                                • The avatar to a have a circular shape.

                                                When no image is set or found for the avatar, the avatar initials are displayed.

                                                If those are not set or found either, an icon for the avatar is displayed:

                                                • A square avatar for a product
                                                • A circular avatar for a person.

                                                For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                                Paging Buttons

                                                By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                                • The user has navigated from a table in the object page to the subobject.
                                                • The table in the object page contains at least two items.

                                                With SAP Fiori elements for OData V2, you can:

                                                • Enable the paging buttons to show on the first object page opened from a list report.
                                                • Disable the default display of the paging buttons on the subobject page.

                                                Toolbar Actions


                                                Edit and Delete

                                                By default, these actions are displayed when the data in the object page allows them.

                                                You can:

                                                • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                                • Disable the actions.

                                                For more information, see:


                                                Copy

                                                You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                                You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                                In the object page, the Copy button is displayed after the Delete button.

                                                Developer Hint
                                                Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                                Related Apps Menu Button

                                                You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                                You can also:

                                                • Hide specific actions in the menu.
                                                • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                                Generic Actions

                                                By default, the Share button is displayed for saved objects and hidden for drafts.

                                                For more information, see Share (Generic).


                                                Application-Specific Actions

                                                You can include the actions required for your use case.

                                                The header toolbar displays application-specific actions to the left of the generic actions.

                                                You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                                Developer Hint
                                                For more information, refer application developers to Keyboard Shortcuts.

                                                Conditional Enablement of Navigation Buttons

                                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Order of Toolbar Actions

                                                The default order — left to right — for actions in the object page toolbar is below:

                                                • Edit
                                                • Delete
                                                • Copy with SAP Fiori elements for OData V2
                                                • Application-specific action buttons
                                                • Related Apps menu button
                                                • Share

                                                You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                                For more information, see:

                                                Additional Content


                                                Simple Header Facets

                                                With SAP Fiori elements for OData V2:

                                                • You can use a simple header facet to show simple data points that align horizontally across the header.
                                                • When form fields contain no value, they display the empty  state indicator (–).

                                                Plain Text Facets

                                                You can use the plain text facet to display a continuous text in the header.

                                                For more information, see Plain Text Facet.


                                                Contact Facets

                                                You can enable a quick view for a contact.

                                                With SAP Fiori elements for OData V4, when a quick view detail contains no value, the empty  state indicator (–) is displayed.

                                                For more information, see Quick View.


                                                Micro Chart Facets

                                                You can display the following microcharts in the header:

                                                • Area micro chart
                                                • Bullet chart
                                                • Radial chart
                                                • Column chart
                                                • Line micro chart
                                                • Harvey ball chart
                                                • Stacked bar chart

                                                For more information, see Micro Charts.


                                                Form Facets

                                                You can add a quick view to the form facet.

                                                For more information, see Form Facet (Dataset).

                                                Developer Hint
                                                For more information, refer the development team to Form Facet.

                                                Address Facets

                                                You can display an address such as a shipping address.

                                                Developer Hint
                                                For more information, refer the development team to Address Facet in the Object Page Header.

                                                Header Field Groups

                                                You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                                Rating Indicator Facets

                                                You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                                By default, the maximum rating is five stars.

                                                You can:

                                                • Change the maximum rating.
                                                • Specify more descriptive text for the subtitle.

                                                With extensions, you can make the rating editable.

                                                Display Mode

                                                The rating indicator shows with the:

                                                • Title
                                                • Subtitle with the total number of ratings
                                                • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                                Edit Mode

                                                The rating indicator moves into the header facet and appears with only the title in edit mode.

                                                For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                                For more information, see:


                                                Progress Indicator Facets

                                                You can add a progress indicator facet to the object header.

                                                For more information, see:


                                                Key Value Facets

                                                You can add a key value facet to highlight important data or KPIs.

                                                For more information, see Key Value Facet.

                                                Related Links

                                                List Report – Content Area

                                                The SAP Fiori elements list report template supports the three content area layouts detailed below.

                                                For design information, see General Layout and the links below.

                                                Simple Content Layout

                                                The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                                                • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                                                • Automatic data loading
                                                • One table toolbar
                                                • Creation of business objects via a dialog
                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.
                                                Simple content layout (default)
                                                Simple content layout (default)

                                                Multiple View Layout

                                                For more complex scenarios, you can turn on the multiple view layout which supports: 

                                                • Display of multiple views of a table that shows one business object, for example, each view of the same table can display different prefiltered states
                                                • The segmented button for a maximum of three views or the select control for four or more views
                                                  Note that the SAP Fiori elements framework determines the switch control automatically based on the number of views.
                                                • Display of the count or number of total rows in the view (must be enabled)
                                                • One table toolbar
                                                • Automatic data loading
                                                • Creation of business objects via a dialog with SAP Fiori elements for OData V2
                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.
                                                Multiple view layout - Segmented button
                                                Multiple view layout - Segmented button
                                                Muliple view layout - Select control
                                                Muliple view layout - Select control

                                                Multiple Content Layout

                                                To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                                                • Display of one or more business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can all be filtered by a specific customer and a specific date
                                                • Text-only icon tab bar to switch among the tabs
                                                • Views with data visualization in a chart instead of a table with both SAP Fiori elements for OData V2 and V4
                                                • Views with data visualization in both a chart and a table with SAP Fiori elements for OData V4
                                                • Automatic data loading
                                                • Different toolbars for each view
                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Do not use a mix of responsive and non-responsive tables.

                                                Developer Hint
                                                Application developers may be unfamiliar with the designer term “multiple content layout.”

                                                For more information on implementing this feature, refer the development team to:

                                                Multiple content layout
                                                Multiple content layout

                                                Related Links

                                                Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                                                List Report – Content Area

                                                The SAP Fiori elements list report template supports the three content area layouts detailed below.

                                                For design information, see General Layout and the links below.

                                                Simple Content Layout

                                                The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                                                • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                                                • Display of data as a chart visualization
                                                • Automatic data loading
                                                • One table toolbar
                                                • Creation of business objects via a dialog
                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.
                                                Simple content layout (default)
                                                Simple content layout (default)

                                                Multiple View Layout

                                                For more complex scenarios, you can turn on the multiple view layout which supports: 

                                                • Display of one business object in a table with multiple views, for example, each view of the same table can display different prefiltered states
                                                • The segmented button for a maximum of three views or the select control for four or more views
                                                • Display of the count or number of total rows in the view (must be enabled)
                                                • One table toolbar
                                                • Automatic data loading
                                                • Creation of business objects via a dialog with SAP Fiori elements for OData V2

                                                Note that Developers refer to this layout as ‘single table for all views’ or ‘single table mode’.

                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.
                                                Multiple view layout - Segmented button
                                                Multiple view layout - Segmented button
                                                Muliple view layout - Select control
                                                Muliple view layout - Select control

                                                Multiple Content Layout

                                                To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                                                • Display of multiple business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can all be filtered by a specific customer and a specific date.
                                                • Text-only icon tab bar to switch between business objects
                                                • Display of data as chart visualizations
                                                • Automatic data loading
                                                • Different toolbars for each business object

                                                Note that developers refer to this layout as one of the following:

                                                • One business object as a separate table for each view or multiple table mode
                                                • More than one business object as multiple views in a list report with different entity sets and table settings
                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Do not use a mix of responsive and non-responsive tables.

                                                Multiple content layout
                                                Multiple content layout

                                                Related Links

                                                Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                                                List Report – Content Area

                                                The SAP Fiori elements list report template supports the three content area layouts detailed below.

                                                For design information, see General Layout and the links below.

                                                Simple Content Layout

                                                The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                                                • Display of one business object in one table, or — with SAP Fiori elements for OData V2 — in one list
                                                • Display of data as a chart visualization
                                                • Automatic data loading
                                                • One table toolbar
                                                • Creation of business objects via a dialog
                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.
                                                Simple content layout (default)
                                                Simple content layout (default)

                                                Multiple View Layout

                                                For more complex scenarios, you can turn on the multiple view layout which supports: 

                                                • Display of one business object in a table with multiple views, for example, each view of the same table can display different columns or pre-filtered states
                                                • Display of data as a chart visualization
                                                • The segmented button for a maximum of three views or the select control for four or more views
                                                • Display of the count or number of total rows in the view (must be enabled)
                                                • One table toolbar
                                                • Automatic data loading

                                                Note that Developers refer to this layout as ‘single table for all views’ or ‘single table mode’.

                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Multiple view layout - Segmented button
                                                Multiple view layout - Segmented button
                                                Muliple view layout - Select control
                                                Muliple view layout - Select control

                                                Multiple Content Layout

                                                To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                                                • Display of multiple business objects in multiple tables, for example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can all be filtered by a specific customer and a specific date.
                                                • Text-only icon tab bar to switch between business objects
                                                • Display of data as chart visualizations
                                                • Automatic data loading
                                                • Different toolbars for each business object

                                                Note that developers refer to this layout as one of the following:

                                                • One business object as a separate table for each view or multiple table mode
                                                • More than one business object as multiple views in a list report with different entity sets and table settings
                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Do not use a mix of responsive and non-responsive tables.

                                                Multiple content layout
                                                Multiple content layout

                                                Related Links

                                                Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                                                List Report – Content Area

                                                The SAP Fiori elements list report template supports the three content area layouts detailed below.

                                                For design information, see General Layout and the links below.

                                                Simple Content Layout

                                                The default layout for the content area is the simple content layout and displays the data for one business object in a single table view.  It supports:

                                                • Display of one business object in one table, or with SAP Fiori elements for OData V2, in a list.
                                                • Display of data as a chart visualization
                                                • Automatic data loading
                                                • One table toolbar
                                                • Creation of business objects via a dialog
                                                Warning
                                                Although table-level variant management is supported, we strongly recommend against it.

                                                With SAP Fiori elements for OData V2, you can enable the display of a list with:

                                                You can assign a criticality to these items. When no criticality is defined for the items, they are treated as items with a criticality of medium.

                                                Simple content layout (default)
                                                Simple content layout (default)

                                                Multiple View Layout

                                                For more complex scenarios, you can turn on the multiple view layout which supports: 

                                                • Display of one business object in a table or, with SAP Fiori elements for OData V2, in a list, with multiple views, for example, in order to display different columns or different pre-filtered states
                                                • Display of data as a chart visualization
                                                • The segmented button for a maximum of three views or the select control for four or more views
                                                • Display of the count or number of total rows in the view (must be enabled)
                                                • One table toolbar
                                                • Automatic data loading

                                                Note that Developers refer to this layout as ‘single table for all views’ or ‘single table mode’.

                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Multiple view layout - Segmented button
                                                Multiple view layout - Segmented button
                                                Muliple view layout - Select control
                                                Muliple view layout - Select control

                                                Multiple Content Layout

                                                To support even more complex scenarios, you can turn on the multiple content layout which supports: 

                                                • Display of multiple business objects in multiple tables or, with SAP Fiori elements for OData V2, in a list. For example, you can display a customer overview with different tables for invoices, deliveries, and overdue payments. All the tables can all be filtered by a specific customer and a specific date
                                                • Text-only icon tab bar to switch between business objects
                                                • Display of data as chart visualizations
                                                • Automatic data loading
                                                • Different toolbars for each business object

                                                Note that developers refer to this layout as one of the following:

                                                • One business object as a separate table for each view or multiple table mode
                                                • More than one business object as multiple views in a list report with different entity sets and table settings
                                                Warning
                                                Creation of business objects via a dialog is not supported – it must be done in an object page.

                                                Although table-level variant management is supported, we strongly recommend against it.

                                                Do not use a mix of responsive and non-responsive tables.

                                                Multiple content layout
                                                Multiple content layout

                                                Related Links

                                                Want to dive deeper? Better understand the related desgin guidelines? Or, refer the development team to the related documentation for implementation? Follow the links below.

                                                SAP Fiori Elements

                                                SAP Fiori elements is a framework that comprises the most commonly used floorplan templates and is designed to:

                                                • Speed up development by reducing the amount of frontend code needed to build SAP Fiori apps.
                                                • Drive UX consistency and compliance with the latest SAP Fiori design guidelines.

                                                The articles in the “SAP Fiori Elements Framework” section of the guidelines cover all the design possibilities based on the current technical capabilities of the SAP Fiori elements framework and the version used to develop your application.

                                                Video: What is SAP Fiori elements?

                                                Versions

                                                Ask your engineering colleagues what SAP Fiori elements version they will use to develop your app because there are differences in the design options that each version supports. The articles in this section of the guidelines indicate when such differences exist.

                                                Each version of SAP Fiori elements supports a different version of OData (Open Data Protocol), as their names indicate:

                                                • SAP Fiori elements for OData version 2 (V2)
                                                • SAP Fiori elements for OData version 4 (V4)

                                                Usage

                                                Your ultimate decision about whether or not to use SAP Fiori elements should be based on two factors:

                                                • Is the floorplan you want to use supported by SAP Fiori elements?
                                                • Does the SAP Fiori elements floorplan deliver all the features you need to provide to your user? If not, consider building a freestyle application instead.

                                                Please note that the analytical list page and the overview page are only available as SAP Fiori elements.

                                                Supported Floorplans

                                                The following floorplans are available as SAP Fiori elements templates:

                                                List report
                                                List report
                                                Worklist
                                                Worklist
                                                Object page
                                                Object page
                                                Overview page
                                                Overview page
                                                Analytical list page
                                                Analytical list page

                                                Each floorplan can be placed inside the flexible column layout, except the overview page. The overview page must always be implemented as a standalone application that pulls in data from a minimum of two other applications.

                                                Supported Features

                                                Both SAP Fiori elements for OData V2 and for OData V4 offer:

                                                • Message handling
                                                • The global edit flow, which includes draft handling
                                                • Keyboard shortcuts for basic operations
                                                • Custom shortcuts for application-defined actions. Note that custom shortcuts for inline actions on table rows are not supported.
                                                • Seamless navigation across applications with the:
                                                  • Inner app state that stores the state of the current page when the user leaves it, including such details as filter values, table and chart personalization, and the selected tab or section. The app state restores these details when the user returns.
                                                  • Support of the SAP Fiori Launchpad feature called sap-keep-alive mode.
                                                    With sap-keep-alive mode, the app page is restored to the same state it was in when the user left it, including scroll position and table selection. It also improves the performance of the page reload after back navigation.
                                                    However, ensuring the page reflects changes that the user made in an external application before returning to it requires explicit configuration by the application developers.

                                                Only SAP Fiori elements for OData V2 supports the local edit flow without draft handling.

                                                Placeholder Texts

                                                Some UI texts provided by the SAP Fiori elements framework are generic placeholders. Always replace them with text that is meaningful to your user – for example:

                                                 

                                                Placeholder Text Replaced Text
                                                List Report Create Object Create Sales Order
                                                Object Page New Object New Sales Order
                                                Overview Page Could not perform action Unable to approve the request
                                                Developer Hint
                                                For more information about placeholder texts in SAP Fiori elements, see Replacing Standard UI Texts.

                                                Extensions

                                                It’s possible to create extensions to deliver features that are not supported by SAP Fiori elements. However, this is not recommended because the associated code will need to be maintained.

                                                Developer Hint
                                                You can create extensions, by adapting the manifest.json of your app, or through annotations or UI adaptation. For more information, see the Extending SAP Fiori Elements-Based Apps.

                                                Related Links

                                                Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

                                                Object Page – Footer Bar

                                                The SAP Fiori elements object page template supports the features and settings for the object page footer detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                Footer Bar Actions

                                                 

                                                Availability

                                                Finalizing Actions Available
                                                Create Default in create mode
                                                Save Default in edit mode
                                                Close on Save Available with SAP Fiori elements for OData V2 only
                                                Save and Edit Available, for non-draft applications with SAP Fiori elements for OData V2 only
                                                Save and Next Available, with SAP Fiori elements for OData V2 only
                                                Apply Available, for the subobject page in draft-enabled applications only
                                                Message Popover Button Default, visible only when messages are present.
                                                Discard Draft Default in edit mode for draft-enabled applications
                                                Cancel Default in edit mode for applications without draft handling
                                                Enabling / Disabling of Actions Available
                                                Keyboard Shortcuts for Actions Available

                                                Footer Bar Actions

                                                In create and edit modes, the footer bar appears at the bottom of the screen.


                                                Finalizing Actions

                                                You can add finalizing actions to the footer bar.

                                                A message toast is displayed when an operation is successful.

                                                Finalizing actions complete the work on the current screen, by permanently changing the object state. You can also set them to navigate away from the object page.

                                                Note that developers may call these actions determining actions.

                                                Guidelines
                                                Replace the generic placeholder text in the message toast with text that’s meaningful to the user.

                                                Save

                                                The action is displayed by default in edit mode.

                                                After saving, the user stays on the object page for applications both with and without draft handling enabled.

                                                You can enable users to automatically navigate back to the list report when they save with SAP Fiori elements for OData V2. To do this, ask your development team to add close logic to the Save action.


                                                Save and Edit

                                                You can enable this action in non-draft applications with SAP Fiori elements for OData V2.

                                                With the Save and Edit action, users save current changes and stay on the object page to continue editing.


                                                Save and Next

                                                This action is enabled with SAP Fiori elements for OData V2 when the direct edit feature is enabled in the corresponding list report.

                                                With the Save and Next action, users save current changes and navigate to the next editable object in the list report.

                                                After they click Save and Next for the last editable object in the list report, they return to the list report.


                                                Apply

                                                You can enable this action in the footer bar of a subobject page in draft-enabled applications.

                                                With the Apply action, users conclude the create or edit activity, save the draft, and navigate one step up in the object hierarchy to the object page.

                                                Similarly, when the subobject page is open in flexible column layout with three column layout, clicking Apply now closes the column where the subobject is displayed and returns the user to the object page.


                                                Message Popover Button

                                                Turned on by default, the button is only visible when messages are present and allows the user to open the message popover. The color of the message button reflects the most crtical message level.

                                                The message popover displays the count of error messages.

                                                Messages without a criticality level are treated as information messages.

                                                With SAP Fiori elements for OData V2, the messages in the message popover are grouped by section and table so users can easily locate where they need to take action.

                                                For more information, see:


                                                Discard Draft

                                                Displayed by default in edit mode for applications with draft-handling, this action button lets the users leave the object page without saving the changes they’ve made in a draft version of the object.


                                                Cancel

                                                Displayed by default in edit mode for applications without draft-handling this action button lets users leave the object page without saving changes they’ve made to the object.


                                                Enabling / Disabling of Actions

                                                You can enable or disable footer bar actions according to certain conditions. For example, to prevent users from archiving a sales order that is still being processed, you can enable the Archive action only for sales orders with the status Delivered or Cancelled.

                                                Note that even if you disable all footer bar actions, the footer bar still appears onscreen for the display of the message popover, described above.


                                                Keyboard Shortcuts for Actions

                                                Keyboard shortcuts are available for basic operations.

                                                You can also enable custom shortcuts for application-defined actions.

                                                Developer Hint
                                                For more information, refer application developers to Keyboard Shortcuts.

                                                Related Links

                                                Table Toolbar

                                                The SAP Fiori elements templates support the features and settings for the table toolbar detailed below.

                                                For design information, see the guidelines starting with Table Overview, and see the links below.

                                                Feature Availability

                                                 

                                                Features in List Report and Object Page

                                                 

                                                Availability

                                                Title Visible by default

                                                You can  hide it.

                                                With SAP Fiori elements for OData V4, you can show the table row count next to the title.

                                                Table Personalization Actions Default, you can turn them off.
                                                Application-Specific Actions Available
                                                Mass Edit Available in draft-enabled applications:

                                                • In both the list report and object page with SAP Fiori elements for OData V4
                                                • In the list report with SAP Fiori elements for OData V2
                                                Show/Hide Details Available in responsive tables
                                                Actions Disabled Before Row Selection Available
                                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                                Requires an extension with SAP Fiori elements for OData V2

                                                Messages for Critical Actions Available
                                                Messages for Destructive Actions Available
                                                Multiple Views on a Table Available
                                                 

                                                List Report-Specific Features

                                                 

                                                Availability

                                                Toolbar Sticky Behavior Default, you can turn it off.
                                                Standard ActionsCreateDelete, and Export to Spreadsheet Default, you can turn them off.
                                                Object Creation via an Object Page Default, you can change it.
                                                Object Creation via a Dialog Available in certain conditions
                                                Object Creation with Reference to Another Object Available as a custom create with SAP Fiori elements for OData V4
                                                Copy Available with SAP Fiori elements for OData V2

                                                You determine the label on the action button.

                                                Hiding Actions in Multiple Content Layout Available
                                                Message Strip for the Table Available, a message strip can display all the messages related to the table in their order of severity.
                                                 

                                                Object Page-Specific Features

                                                 

                                                Availability

                                                Search Available, when the data allows it.
                                                Edit Default, when the data allows it.
                                                Delete Default, when the data allows it.
                                                Subobject Creation via Subobject Page Default, you can change it.
                                                Subobject Creation via Dialog Available for applications that are not draft-enabled in certain conditions
                                                Create Not Visible In certain conditions
                                                Inline Creation Available, in draft-enabled applications for grid and responsive tables
                                                Prefilling Fields for New Object Creation Available, in draft-enabled applications
                                                Copy and Paste from Microsoft Excel Available, in draft-enabled applications for grid and responsive tables, in certain conditions
                                                Export to Spreadsheet With SAP Fiori elements for OData V4:

                                                • Available
                                                • Default, when the copy and paste from Microsoft Excel feature is enabled
                                                Export to PDF Available with SAP Fiori elements for OData V4
                                                Full Screen Mode for Table Display Available, not recommended
                                                Segmented Button for Switching Table Views Default for a table with a maximum of three views
                                                Select Control for Switching Table Views Default for a table with four or more views

                                                Features in List Report and Object Page

                                                The information below relates to table toolbar actions and settings in both the list report and object page floorplans.


                                                Table Personalization Actions

                                                By default, Sort, Group and Order actions are enabled.

                                                These actions are icon buttons that open the Personalization dialog to the tab for the corresponding action.

                                                For specific use cases, you can disable the icon buttons. When you do, the user must open the Personalization dialog to access the actions.

                                                Table-level variant management is not a prerequisite for personalization.

                                                For more information, see Table Personalization (Overview).



                                                Application-Specific Actions

                                                You can define these actions and the text displayed on the buttons.

                                                The application team can control when the action button is displayed and enabled.

                                                For application-specific actions, application teams can define custom keyboard shortcuts.

                                                For more information, see:

                                                Developer Hint

                                                For more information on shortcuts, refer application developers to Keyboard Shortcuts.


                                                Mass Edit

                                                You can enable mass edit in responsive tables and grid tables for applications with draft handling in the:

                                                • List report and object page with SAP Fiori elements for OData V4
                                                • List report with SAP Fiori elements for OData V2

                                                List Report

                                                Users cannot apply the mass edit to a draft record.

                                                The edit is applied to all the objects selected that don’t return errors or warnings during the update. When they do return an error or warning, none of their fields are updated.

                                                By default, the Edit dialog contains all the table columns that are currently visible and editable.

                                                Object Page

                                                When it’s enabled for a table in the object page and the object page is in edit mode, users can apply the mass edit to subobjects.

                                                For more information, see Mass Edit.

                                                Developer Hint
                                                For more information on enabling this feature for an object page table with SAP Fiori elements for OData V4, you can refer application developers to Using the Mass Edit Functionality.


                                                Show / Hide Details

                                                The responsive table toolbar displays the Show Details action when at least one column is hidden from the screen because of limited onscreen space.

                                                After the user clicks Show Details, the the table displays the hidden information in the pop-in area, and the action changes to Hide Details.

                                                The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                                                • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                                                • The values in columns with low importance are first to be hidden.

                                                By default in responsive tables:

                                                • Key fields have the importance set to high in list reports.
                                                • Other columns have the importance set to none and are handled like columns assigned medium importance.

                                                You can change the level of importance.


                                                Actions Disabled Until the User Selects a Row

                                                You can set actions in the table toolbar to display as disabled until the user selects one or more table rows for the action.

                                                Note that the development team may call actions that require selection “context-dependent” actions and actions that are enabled without a selection “context-independent” actions.

                                                For more information, see UI Element States.


                                                Conditional Enablement of Navigation Buttons

                                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Messages for Critical Actions

                                                For actions that you set as critical, you can display one of the following after the user triggers the action:

                                                • A message toast confirmation
                                                • A confirmation message box to ensure the user wants to proceed with specific critical actions

                                                Also, the backend can require a confirmation on some actions. In this case, the confirmation message is always shown in a message box.

                                                Guidelines

                                                Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text                          “Do you really want to execute the action <Action Label>?”

                                                <Action Label> is the label shown on the button.

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to activate this product?” “Are you sure you really want to activate this product?”


                                                Messages for Destructive Actions

                                                By default, a message is displayed for confirmation of an action that will delete or destroy important data.

                                                Guidelines

                                                Overwrite the default message text so it’s meaningful to the users, as shown in the example below. Provide the new text to the development team. Then, the development team updates it in the application’s internationalization (i18n) file for the object type.

                                                Ask the development team whether or not the backend requires confirmations for your use case.

                                                Example


                                                SAP Fiori elements for OData V2 SAP Fiori elements for OData V4
                                                Default Text The default message reuses the title and the description defined for the object in the table.

                                                • In flexible column layout: Delete object <title> <description>?

                                                  For example, “Delete object 12345 (Sales Order)?”

                                                • In full screen mode: Delete object <title>?

                                                  For example, “Delete object 12345?”

                                                “Do you really want to perform this action?
                                                Replacement Text “Are you sure you really want to delete this product?” “Are you sure you really want to delete this product?”


                                                Multiple Views for a Table

                                                You can display a table with multiple views, for example, each view of the same table can display different columns or prefiltered states.

                                                For a maximum of three views, a segmented button is displayed. For four or more, the select control is displayed.

                                                With SAP Fiori elements for V4, you can also display the row count for each view next to the view name.

                                                List Report-Specific Features

                                                The information below relates only to table toolbar actions and settings in the list report floorplan.


                                                Standard Actions

                                                By default, Create, Delete, and Export to Spreadsheet are enabled.

                                                You can disable them.

                                                You can also enable or disable the Delete button based on conditions specified in the backend.

                                                Example

                                                You can disable deletion for a sales order that has already been paid. When a user selects an item that cannot be deleted, the Delete button is disabled. In addition, if the user navigates from this item in the list report to the object page, the Delete button is hidden.

                                                Guidelines
                                                In a responsive table, if you put a Delete button in the toolbar, do not enable the inline Delete for table rows.

                                                Create Object Actions

                                                By default, the create via the object page feature is enabled. The create action opens the object page in create mode so the user can enter the data. Alternatively, you can enable object creation as described the sections below:

                                                Via a Dialog

                                                The action opens a dialog in modal view so the user can enter the data.

                                                With SAP Fiori elements for OData V2, you can:

                                                • Include a maximum of eight fields in the dialog
                                                • Enable filter values saved in the filter bar to prefill fields in the dialog
                                                Warning
                                                When you enable the object creation via a dialog feature, users cannot navigate to an object page in create mode. Instead, they can navigate to the object page in display mode and switch to edit mode.

                                                Note that when a user clicks Cancel in the create dialog, no draft states are maintained.

                                                With Default Values That Prefill Fields for the New Object

                                                This feature is available with:

                                                • SAP Fiori elements for OData V2 for applications without draft handling
                                                • SAP Fiori elements for OData V4

                                                Via a Dialog with a Reference to an Existing Object of the Same Type

                                                With SAP Fiori elements for OData V4, application developers can build a custom create action via a dialog that lets the user create a new object with a reference to an existing object of the same type.

                                                The user:

                                                1. Clicks the action button.
                                                  You can name the button to suit your use case.
                                                2. Selects the value of the existing object to reference in the dialog.
                                                3. Completes the fields for the new object by selecting one or more values to copy from the existing one.
                                                4. Completes additional fields for the new object in the object page.
                                                Create from existing object
                                                Create from existing object
                                                Developer Hint
                                                For more information, refer application developers to:

                                                Copy

                                                You can place a copy action button in the table toolbar to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                                You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                                In the toolbar, the Copy button is displayed after the Create button.

                                                Developer Hint
                                                Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Actions in the List Report.

                                                Hiding Actions in Multiple Content Layout

                                                You can hide an action from a toolbar for a specific table when the list report contains multiple views with multiple tables.

                                                For more information, see:


                                                Object Page-Specific Features

                                                The information below relates only to table toolbar actions and settings in the object page floorplan.


                                                Search

                                                You can enable a search on the table.

                                                For more information, see Search.


                                                Edit

                                                By default, Edit is displayed when the business object shown in the table is editable.


                                                Delete

                                                By default, Delete is displayed in edit mode when the business object shown in the table is deletable.

                                                You can enable or disable the Delete action to allow users to delete only in certain conditions.

                                                For example, after the sales items for a Sales Order have shipped, you can hide the Delete action for the items. When a user selects an item that cannot be deleted, the Delete action is disabled.

                                                When multiple selection is enabled for the table, the Delete action is enabled if at least one selected item is deletable.

                                                Warning
                                                In a responsive table, if you put a Delete action in the toolbar, do not enable the inline Delete for table rows.

                                                Subobject Creation

                                                By default:

                                                • Create is displayed in edit mode when the business object shown in the table is editable. For specific circumstances when the Create button is disabled, see Create Action Visibility below.
                                                • The default creation action is via the suboject page — the action opens the subobject page in create mode so the user can enter the data.

                                                You can:

                                                • Enable or disable the Create action to allow users to create subobjects only in certain conditions. For example, after a sales order reaches the Delivery is Shipped status, you can hide the Create Sales Item action.
                                                • Enable creation of a subobject via a dialog with 8 fields maximum. The action opens a dialog in modal view so the user can enter the data. The dialog must contain all the mandatory fields for the subobject. With SAP Fiori elements for OData V2, you can enable filter values saved in the filter bar to prefill fields in the Create dialog.
                                                • Enable inline create for draft-enabled applications in grid and responsive tables with SAP Fiori elements for V4. See Inline Creation below.
                                                • Enable default values to prefill the fields for the new object. This feature is available with SAP Fiori elements for OData V4, and with SAP Fiori elements for OData V2 for applications without draft handling.
                                                Guidelines
                                                Replace the default dialog title or subobject page title “New Item” to reflect the name of the subobject and to provide a name for unnamed objects that’s meaningful to the user.

                                                For more information, see:


                                                Create Action Visibility

                                                Whether or not the Create action is visible in the table toolbar depends on:

                                                • The object page mode.
                                                • Whether the flow is global or local.
                                                • Where the user enters the data for the new subobject — in the subobject page or directly in the table with the inline edit.

                                                 

                                                Flow Type Read Mode for All Tables Edit Mode for Tables with Subobject Pages Edit Mode for Tables with Inline Edit

                                                Global Flow for Draft-Enabled

                                                Applications with Fiori Elements for OData V2

                                                • Navigation indicators   are visible (if required).
                                                • Create button is not visible.
                                                • Navigation indicators   are visible (if required).
                                                • Create button is visible.
                                                • Navigation indicators   are visible (if required).
                                                • Create button is visible.

                                                Local Flow for Non-Draft Enabled Applications

                                                • Navigation indicators   are visible (if required).
                                                • Create button is visible.
                                                • Navigation indicators   are not visible.
                                                • Create button is not visible.
                                                Not Supported.

                                                Inline Creation

                                                You can enable inline creation of entries for applications with draft handling enabled. The Create action is displayed in the table toolbar in edit mode.

                                                The inline creation adds a new row to the table where the users can enter the subobject data.

                                                By default, the new row is highlighted in blue and displayed at the top of the table. The highlighting disappears after the users save the data.

                                                You can:

                                                • Work with the development team to define a custom sort order.
                                                • Enable default values to prefill the fields for the new object.

                                                For more information, see Add Items.


                                                Prefilling Fields for a New Object

                                                You can turn this on in draft-enabled applications for the default create action via the object page, where the user navigates to another application to enter the data in the new object page.

                                                The new object must be the main object on the object page.

                                                You determine both the fields to prefill and the default values for the fields.


                                                Copy and Paste from Microsoft Excel

                                                By default, the table toolbar for responsive and grid tables displays Paste when the following are enabled:

                                                • Draft-handling for the application.
                                                • Inline creation for the object page table.

                                                After users copy data from a spreadsheet, they can place the focus anywhere in the table except for the cells and trigger the browser paste with the keyboard shortcut (Ctrl+V for Microsoft Windows, Cmd+V for MacOS).

                                                Limitations

                                                • Pasting is supported only for fields that contain a single value, not for complex fields, such as smart links and images.
                                                • If there are validation errors, a dialog displays an error message so the user can take remedial action.
                                                • The greater the number of records copied, the longer the paste operation takes.
                                                • The order of the of the data copied from the spreadsheet can differ from the order in the table in the application after the paste. SAP Fiori elements cannot control this.
                                                • Users cannot paste data into custom columns of tables.
                                                • This feature is not supported for custom tables.

                                                Export to Spreadsheet

                                                By default, Export to Spreadsheet is enabled with the copy and paste from spreadsheet feature above.

                                                You can enable the button independently of the copy and paste from Microsoft Excel.

                                                The Export to Spreadsheet button allows user to export the values in the table, including values in custom columns.

                                                For more information see Export to Spreadsheet.


                                                Full Screen Mode for Table Display

                                                You can enable full screen mode for a table. However, it is generally not recommended.

                                                Users click the Maximize action in the toolbar to display to the table in a dialog. They can return to the object page by clicking either the Minimize or Close action.

                                                For more information on the restrictions for this feature, see Maximize/Minimize.


                                                Content Switch for Table Views

                                                The number of views defined for a table determines the UI control that lets users switch the table views:

                                                By default, the count or number of records in the view is not displayed next to the title of the content switch for table views for performance reasons. Talk to the development team about how displaying the counts impacts performance for your use case.

                                                Related Links

                                                Object Page – Overview

                                                The SAP Fiori elements object page template supports the features and settings for the overall object page behavior detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                 

                                                Features

                                                 

                                                Availability

                                                Unsaved Changes Message Default for the main object page in draft-enabled applications.

                                                • With SAP Fiori elements for OData V4, you cannot turn it off.
                                                • With SAP Fiori elements for OData V2, you can turn it off for navigation from the draft page to another application.

                                                Feature Details

                                                Unsaved Changes Message

                                                By default, this message is displayed for the main object page in draft-enabled applications.

                                                • With SAP Fiori elements for OData V4, you cannot turn it off.
                                                • With SAP Fiori elements for OData V2, you can turn it off for navigation from the draft page to another application.

                                                The message is displayed when users attempt to navigate away from a draft in the main object page.

                                                It lets the users choose one of the following actions and explains the result the actions:

                                                • Save changes to the saved version
                                                • Keep the draft
                                                • Discard the draft

                                                The user can also cancel the navigation.

                                                Warning for unsaved changes
                                                Warning for unsaved changes

                                                Object Page – Header

                                                The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                Behavior and Interaction

                                                 

                                                Availability

                                                Expanded State Default on initial load
                                                Collapsed State Default on scroll

                                                With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                                Header Content Displayed in the Header Content Area and the Header Section Default in create and edit modes
                                                Header Content Visible Default, you can hide it.
                                                Header Content Hidden Available
                                                Making Header Fields Editable Available
                                                Highlighting Values Based on Criticality Available
                                                 

                                                Components

                                                 

                                                Availability

                                                Dynamic Page Header Mandatory, it must be configured.
                                                Title Mandatory, you must define it.
                                                Menu for Saved Version / Draft Default for draft-enabled applications
                                                Breadcrumbs Default
                                                Subtitle Available, you define the text.
                                                Object Marker Default in draft-enabled applications
                                                Image Available
                                                Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                                Paging Buttons on the First Subobject Page Default under certain conditions
                                                Toolbar Available
                                                 

                                                Toolbar Actions

                                                 

                                                Availability

                                                Edit and Delete Default, when the data allows these actions.

                                                You can turn one or both actions off.

                                                Copy Available with SAP Fiori elements for OData V2
                                                Related Apps Menu Button Available

                                                With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                                Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                                Application-Specific Actions Available,  they must be configured.
                                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                                Requires an extension with SAP Fiori elements for OData V2

                                                Order of Toolbar Actions Default

                                                You can change the default order.

                                                 

                                                Additional Content (Optional)

                                                 

                                                Availability

                                                Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                                Plain Text Facets Available
                                                Contact Facets Available
                                                Micro Chart Facets Available
                                                Form Facets Available
                                                Address Facets Available
                                                Header Field Group Available
                                                Rating Indicator Facets Available
                                                Progress Indicator Facet Available
                                                Key Value Facet Available
                                                Link Available

                                                With SAP Fiori elements for OData V2:

                                                • The default link shows the text and ID. You can remove the text or the ID from the link.
                                                • You can include a link that navigates to a site external to the application.

                                                Behavior and Interaction


                                                Collapsed/Expanded State

                                                When the object page header contains at least one facet:

                                                • On the initial load of the object page, the header is expanded.
                                                • When the user scrolls down the page, the header collapses.
                                                • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                                When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                                With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                                Next to the title, an arrow   button lets the users expand the header.

                                                Summary Line for Object Page Header on Small Screens
                                                Summary Line for Object Page Header on Small Screens

                                                Display of Header Content

                                                In display mode, the header content area displays all the header content.

                                                In edit and create modes, the header content is displayed in two places:

                                                • The header content area, at the top of the page, displays uneditable header content. By default, all header content is uneditable. You can make specific fields editable. See Making Header Fields Editable below.
                                                • The Header section, the first dynamic section in the content area, displays editable header content. It’s only present in the edit and create modes.

                                                For more information, see Dynamic Page Header (Mandatory).


                                                Header Content Visibility

                                                By default, header content is visible.

                                                You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                                • Entire header facets
                                                • Content, such as fields, in a header facet
                                                • Content in quick views

                                                With Fiori elements for OData V2, you can set:

                                                • The header to be displayed in edit mode.
                                                • Header facets to be visible in edit mode.
                                                Developer Hint
                                                For more information on the features, refer the development team to:


                                                Making Header Fields Editable

                                                You can make fields in the object page header editable in edit mode.


                                                Highlighting Values Based on Criticality

                                                You can assign colors and icons to text to indicate the criticality of a field value.

                                                Components


                                                Title

                                                By default, with:

                                                •  SAP Fiori elements for OData V2, the title area is empty.
                                                •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                                Guidelines
                                                Tell the developers which property to use as the title.

                                                Menu for Saved Version / Draft

                                                With this menu next to the object page title, users can navigate between the saved version of an object and the draft version that they’ve created. This is a default feature in applications with draft-handling,


                                                Breadcrumbs

                                                Breadcrumbs are displayed above the object title.

                                                Guidelines
                                                Limit the breadcrumbs to the drilldown levels within the object page.

                                                Object Marker

                                                The object marker indicates the object is locked by another user in draft-enabled applications.


                                                Image

                                                The image is an avatar control. By default, it has a square shape.

                                                You can set:

                                                • An image to display instead of the avatar.
                                                • The avatar to a have a circular shape.

                                                When no image is set or found for the avatar, the avatar initials are displayed.

                                                If those are not set or found either, an icon for the avatar is displayed:

                                                • A square avatar for a product
                                                • A circular avatar for a person.

                                                For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                                Paging Buttons

                                                By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                                • The user has navigated from a table in the object page to the subobject.
                                                • The table in the object page contains at least two items.

                                                With SAP Fiori elements for OData V2, you can:

                                                • Enable the paging buttons to show on the first object page opened from a list report.
                                                • Disable the default display of the paging buttons on the subobject page.

                                                Toolbar Actions


                                                Edit and Delete

                                                By default, these actions are displayed when the data in the object page allows them.

                                                You can:

                                                • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                                • Disable the actions.

                                                For more information, see:


                                                Copy

                                                You can place a copy action button in the header to let the user to create a new object with the same data as the current object with SAP Fiori elements for OData V2.

                                                You set the label for the button according to your use case. Otherwise, the default label is Copy.

                                                In the object page, the Copy button is displayed after the Delete button.

                                                Developer Hint
                                                Application developers can define a standard copy action button by annotating a function import action (DataFieldForAction) as a Copy action. For more information, refer them to: Enabling Actions in the Object Page Header.

                                                Related Apps Menu Button

                                                You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                                You can also:

                                                • Hide specific actions in the menu.
                                                • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                                Generic Actions

                                                By default, the Share button is displayed for saved objects and hidden for drafts.

                                                For more information, see Share (Generic).


                                                Application-Specific Actions

                                                You can include the actions required for your use case.

                                                The header toolbar displays application-specific actions to the left of the generic actions.

                                                You can also define custom shortcuts for application-defined action buttons and navigation buttons.

                                                Developer Hint
                                                For more information, refer application developers to Keyboard Shortcuts.

                                                Conditional Enablement of Navigation Buttons

                                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Order of Toolbar Actions

                                                The default order — left to right — for actions in the object page toolbar is below:

                                                • Edit
                                                • Delete
                                                • Copy with SAP Fiori elements for OData V2
                                                • Application-specific action buttons
                                                • Related Apps menu button
                                                • Share

                                                You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                                For more information, see:

                                                Additional Content


                                                Simple Header Facets

                                                With SAP Fiori elements for OData V2 only, you can use a simple header facet to show simple data points that align horizontally across the header.


                                                Plain Text Facets

                                                You can use the plain text facet to display a continuous text in the header.

                                                For more information, see Plain Text Facet.


                                                Contact Facets

                                                You can enable a quick view for a contact.

                                                With SAP Fiori elements for OData V4, to help users identify empty content in the quick view, when a detail contains no value, the empty  state indicator (–) is displayed.

                                                For more information, see Quick View.


                                                Micro Chart Facets

                                                You can display the following microcharts in the header:

                                                • Area micro chart
                                                • Bullet chart
                                                • Radial chart
                                                • Column chart
                                                • Line micro chart
                                                • Harvey ball chart
                                                • Stacked bar chart

                                                For more information, see Micro Charts.


                                                Form Facets

                                                You can add a quick view to the form facet.

                                                For more information, see Form Facet (Dataset).

                                                Developer Hint
                                                For more information, refer the development team to Form Facet.

                                                Address Facets

                                                You can display an address such as a shipping address.

                                                Developer Hint
                                                For more information, refer the development team to Address Facet in the Object Page Header.

                                                Header Field Groups

                                                You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                                Rating Indicator Facets

                                                You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                                By default, the maximum rating is five stars.

                                                You can:

                                                • Change the maximum rating.
                                                • Specify more descriptive text for the subtitle.

                                                With extensions, you can make the rating editable.

                                                Display Mode

                                                The rating indicator shows with the:

                                                • Title
                                                • Subtitle with the total number of ratings
                                                • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                                Edit Mode

                                                The rating indicator moves into the header facet and appears with only the title in edit mode.

                                                For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                                For more information, see:


                                                Progress Indicator Facets

                                                You can add a progress indicator facet to the object header.

                                                For more information, see:


                                                Key Value Facets

                                                You can add a key value facet to highlight important data or KPIs.

                                                For more information, see Key Value Facet.

                                                Related Links

                                                Table Features

                                                The SAP Fiori elements templates support the features and settings for a table detailed below.

                                                For design information see the table guidelines, starting with Table Overview, and the links within this article.

                                                Feature Availability

                                                 

                                                Table Settings

                                                 

                                                Availability

                                                Column Heading Labels You set these.
                                                Clear All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

                                                • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                • Responsive tables in a list report

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

                                                You can change the default.

                                                Select All With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

                                                With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

                                                You can change the default.

                                                Sticky Column Header Behavior Default, you can turn it off.
                                                Column Width The default width depends on the column contents. You can change it.
                                                Column Importance In a responsive table, by default, all columns have an importance of none, except for list report columns for key fields. These have high importance.

                                                You can change the level of importance.

                                                Labels for Multiple Fields in a Column Available in responsive tables with SAP Fiori elements for OData V4
                                                Ascending Sort Order on a Column Default, you can change it.
                                                Grouping Available in responsive and analytical tables
                                                Number of Table Rows Displayed at Once Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
                                                No Data Found Text Default, replace the generic placeholder text with text that’s meaningful to the user.
                                                Message Strip for the Table Available, a message strip above the table can display all the messages related to the table in order of their severity.
                                                 

                                                List Report and Analytical Page Only

                                                 

                                                Availability

                                                Number of Table Levels Expanded at Initial Load Default, you can change the number for the tree table and analytical table.
                                                 

                                                Object Page Only

                                                 

                                                Availability

                                                Message Strip for Rows with Errors Default

                                                Table Settings


                                                Clear All / Select All

                                                When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements:

                                                • Display by default either the Clear All checkbox or Select All  checkbox in the header of the selection column, as detailed in the next sections
                                                • Allow you to set which checkbox displays for all the tables on an object page, or for specific tables only

                                                When the Select All action is hidden, the user can still select a range of multiple items, by selecting an item, pressing Shift, and selecting others.

                                                For  grid tables, analytical tables and tree tables, the default limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

                                                SAP Fiori elements for OData V2 Defaults

                                                When the selection of multiple rows (or multiselect) is enabled, the selection column header displays by default:

                                                • The Clear All checkbox for:
                                                  • Grid tables, analytical tables and tree tables in both list reports and object pages
                                                  • Responsive tables in a list report
                                                • The Select All  checkbox for a responsive table in an object page

                                                You can change the default.

                                                SAP Fiori elements for OData V4

                                                When the selection of multiple rows (or multi mode) is enabled, the selection column header displays by default the Clear All checkbox for all tables but a responsive table in an object page with anchor bar mode. In this case, the responsive table displays the Select All  checkbox because the user can scroll to all the section content.

                                                You can change the default.

                                                Warning
                                                For an optimal user experience only display the Select All checkbox for a small number of items because:

                                                • When the user clicks Select All, all the items or rows load from the backend. Loading many items can require multiple requests to the system and, consequently, take time.
                                                • When a responsive table contains so many rows that they cannot all be displayed onscreen, many users expect the Select All to select all the rows in the table. In fact, it selects all the rows currently displayed on the interface.

                                                Guidelines
                                                When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

                                                Column Width

                                                The default column width varies according to the column contents:

                                                • Text: can range from 3 to 20 rem
                                                • Image: 5 rem
                                                • Rating or progress indicator: 6.875 rem
                                                • Chart: 20 rem

                                                You can can change the width.

                                                Developer Hint
                                                For more information, refer the development team to Setting the Default Column Width.

                                                Column Importance in Responsive Tables

                                                By default:

                                                • Key fields have high importance in list reports.
                                                • Other columns have the importance of none and are handled like columns assigned medium importance.

                                                You can change the level of importance.

                                                The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

                                                • The values from high importance columns are always displayed onscreen — as columns or in the pop-in area, depending on the screen size.
                                                • The values in columns with low importance are first to be hidden.

                                                When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

                                                You can also assign an importance to custom columns.

                                                For more information, see:


                                                Labels for Multiple Fields in a Column

                                                By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

                                                You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.


                                                Sort Order

                                                By default, the sort order for a column is ascending.

                                                You can:

                                                • Set the default sort order to descending.
                                                • Define other, customized sort orders.

                                                For more information, see the sort guidelines according to table type:


                                                Number of Table Rows Displayed at Once

                                                By default, a responsive table loads the following number of rows at once:

                                                • 20 rows in a list report.
                                                • 10 rows in an object page with multiple sections.

                                                When more rows exist, the users can click the More button at the end of the table to view additional rows.

                                                With SAP Fiori elements for OData V2, you can change the default number.

                                                For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

                                                Guidelines
                                                Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

                                                Grouping

                                                Grouping is available in responsive and analytical tables.

                                                You can define the format of the grouping headers.

                                                For more information, see:



                                                No Data Found Text

                                                By default, the following text is displayed when no data is found.

                                                • When the user has not applied filters, the text is “No data found.”
                                                • When the user has applied filters from the personalization dialog, the text is: “No data found. Try adjusting the search or filter parameters.”
                                                Guidelines
                                                Replace the generic text with text that’s meaningful to the user.

                                                List Report and Analytical Page Only

                                                Initial Expansion of Table Levels

                                                By default, on initial load, the following expandable tables are expanded to this number of levels:

                                                • Responsive table: 1 level
                                                • Tree table: 1 level
                                                • Analytical table: 0 levels

                                                You can change the default value for the tree table and analytical tables.

                                                Developer Hint
                                                For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

                                                Object Page Only

                                                Message Strip for Rows with Errors

                                                When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.


                                                Related Links

                                                Object Page – Header

                                                The SAP Fiori elements object page template supports the features and settings for the object page header detailed below.

                                                For design information, see the Object Page Floorplan guidelines and the links below.

                                                Warning
                                                Always build the object page using the dynamic page header.

                                                Set the shellbar page title to the name of the business object shown in the object page to indicate the user’s position in the system.

                                                Do not use the current implementation of the “page variant” feature in SAP Fiori elements. This feature is technically available for object pages, but we are still working on the final design.

                                                Feature Availability

                                                 

                                                Behavior and Interaction

                                                 

                                                Availability

                                                Expanded State Default on initial load
                                                Collapsed State Default on scroll

                                                With SAP Fiori elements for OData V2, on mobile phone screens, the object page displays a summary line instead of the collapsed header.

                                                Header Content Displayed in the Header Content Area and the Header Section Default in create and edit modes
                                                Header Content Visible Default, you can hide it.
                                                Header Content Hidden Available
                                                Making Header Fields Editable Available
                                                Highlighting Values Based on Criticality Available
                                                 

                                                Components

                                                 

                                                Availability

                                                Dynamic Page Header Mandatory, it must be configured.
                                                Title Mandatory, you must define it.
                                                Breadcrumbs Default
                                                Subtitle Available, you define the text.
                                                Object Marker Default in draft-enabled applications
                                                Image Available
                                                Paging Buttons on the First Object Page Available with SAP Fiori elements for OData V2 only
                                                Paging Buttons on the First Subobject Page Default under certain conditions
                                                Toolbar Available
                                                 

                                                Toolbar Actions

                                                 

                                                Availability

                                                Edit and Delete Default, when the data allows these actions.

                                                You can turn one or both actions off.

                                                Related Apps Menu Button Available

                                                With SAP Fiori elements for OData V4, you can change the button name to Open in…

                                                Display Saved Version/Return to Draft Button Default
                                                Generic Actions Default: Share is turned on for saved objects and turned off for drafts.
                                                Application-Specific Actions Available,  they must be configured.
                                                Conditional Enablement of Navigation Buttons Available with SAP Fiori elements for OData V4

                                                Requires an extension with SAP Fiori elements for OData V2

                                                Order of Toolbar Actions Default

                                                You can change the default order.

                                                 

                                                Additional Content (Optional)

                                                 

                                                Availability

                                                Simple Header Facets Available with SAP Fiori elements for OData V2 only
                                                Plain Text Facets Available
                                                Contact Facets Available
                                                Micro Chart Facets Available
                                                Form Facets Available
                                                Address Facets Available
                                                Header Field Group Available
                                                Rating Indicator Facets Available
                                                Progress Indicator Facet Available
                                                Key Value Facet Available
                                                Link Available

                                                With SAP Fiori elements for OData V2:

                                                • The default link shows the text and ID. You can remove the text or the ID from the link.
                                                • You can include a link that navigates to a site external to the application.

                                                Behavior and Interaction


                                                Collapsed/Expanded State

                                                When the object page header contains at least one facet:

                                                • On the initial load of the object page, the header is expanded.
                                                • When the user scrolls down the page, the header collapses.
                                                • The Expand/Collapse    button and the Pin/Unpin  button are displayed.

                                                When the object page header contains only a title and a subtitle, the Expand/Collapse    button and the Pin/Unpin  button are not displayed.

                                                With SAP Fiori elements for OData V2, when users scroll on a mobile phone screen, the object page optimizes the screen space by displaying a summary line instead of the collapsed header.

                                                Next to the title, an arrow   button lets the users expand the header.

                                                Summary Line for Object Page Header on Small Screens
                                                Summary Line for Object Page Header on Small Screens

                                                Display of Header Content

                                                In display mode, the header content area displays all the header content.

                                                In edit and create modes, the header content is displayed in two places:

                                                • The header content area, at the top of the page, displays uneditable header content. By default, all header content is uneditable. You can make specific fields editable. See Making Header Fields Editable below.
                                                • The Header section, the first dynamic section in the content area, displays editable header content. It’s only present in the edit and create modes.

                                                For more information, see Dynamic Page Header (Mandatory).


                                                Header Content Visibility

                                                By default, header content is visible.

                                                You can set the following header components or selected content, fields, or actions in them to be displayed or hidden, according to the object’s state:

                                                • Entire header facets
                                                • Content, such as fields, in a header facet
                                                • Content in quick views

                                                With Fiori elements for OData V2, you can set:

                                                • The header to be displayed in edit mode.
                                                • Header facets to be visible in edit mode.
                                                Developer Hint
                                                For more information on the features, refer the development team to:


                                                Making Header Fields Editable

                                                You can make fields in the object page header editable in edit mode.


                                                Highlighting Values Based on Criticality

                                                You can assign colors and icons to text to indicate the criticality of a field value.

                                                Components


                                                Title

                                                By default, with:

                                                •  SAP Fiori elements for OData V2, the title area is empty.
                                                •  SAP Fiori elements for OData V4, the title area displays the text: (Unnamed Object).
                                                Guidelines
                                                Tell the developers which property to use as the title.

                                                Breadcrumbs

                                                Breadcrumbs are displayed above the object title.

                                                Guidelines
                                                Limit the breadcrumbs to the drilldown levels within the object page.

                                                Object Marker

                                                The object marker indicates the object is locked by another user in draft-enabled applications.


                                                Image

                                                The image is an avatar control. By default, it has a square shape.

                                                You can set:

                                                • An image to display instead of the avatar.
                                                • The avatar to a have a circular shape.

                                                When no image is set or found for the avatar, the avatar initials are displayed.

                                                If those are not set or found either, an icon for the avatar is displayed:

                                                • A square avatar for a product
                                                • A circular avatar for a person.

                                                For more information on the logic used for displaying an object, consult the development team and see Using Images, Initials, and Icons.


                                                Paging Buttons

                                                By default, with both SAP Fiori elements for OData V2 and V4, the paging buttons appear in the subobject page of applications that use the dynamic page layout in the following conditions:

                                                • The user has navigated from a table in the object page to the subobject.
                                                • The table in the object page contains at least two items.

                                                With SAP Fiori elements for OData V2, you can:

                                                • Enable the paging buttons to show on the first object page opened from a list report.
                                                • Disable the default display of the paging buttons on the subobject page.

                                                Toolbar Actions


                                                Edit and Delete

                                                By default, these actions are displayed when the data in the object page allows them.

                                                You can:

                                                • Set each enabled action to be displayed or hidden based on certain conditions in the back end. For example, you can hide the actions for a sales order that has already been paid.
                                                • Disable the actions.

                                                For more information, see:


                                                Related Apps Menu Button

                                                You can enable the Related Apps menu button. It displays the actions available on the same object in different applications. Users select the action to open the same object in another application.

                                                You can also:

                                                • Hide specific actions in the menu.
                                                • Change the button name to Open In…  with SAP Fiori elements for OData V4.

                                                Display Saved Version / Return to Draft

                                                Always visible, this button lets users toggle between the saved and draft versions of the object page record.


                                                Generic Actions

                                                By default, the Share button is displayed for saved objects and hidden for drafts.

                                                For more information, see Share (Generic).


                                                Application-Specific Actions

                                                You can include the actions required for your use case.

                                                The header toolbar displays application-specific actions to the left of the generic actions.


                                                Conditional Enablement of Navigation Buttons

                                                With SAP Fiori elements for OData V4, you can enable buttons that navigate the user to another page or application based on the value of a specific field.

                                                With SAP Fiori elements for OData V2, this feature requires extensions.

                                                For example, you can enable the Generate Purchase Order button only for sales orders with the completed status.

                                                Guidelines
                                                Implement this feature only when the way to enable the button is obvious to end users.

                                                Order of Toolbar Actions

                                                The default order — left to right — for actions in the object page toolbar is below:

                                                You can rearrange the order, for example, by setting an application-specific action that’s the primary action to the leftmost position on the toolbar.

                                                For more information, see:

                                                Additional Content


                                                Simple Header Facets

                                                With SAP Fiori elements for OData V2 only, you can use a simple header facet to show simple data points that align horizontally across the header.


                                                Plain Text Facets

                                                You can use the plain text facet to display a continuous text in the header.

                                                For more information, see Plain Text Facet.


                                                Contact Facets

                                                You can enable a quick view for a contact.

                                                With SAP Fiori elements for OData V4, to help users identify empty content in the quick view, when a detail contains no value, the empty  state indicator (–) is displayed.

                                                For more information, see Quick View.


                                                Micro Chart Facets

                                                You can display the following microcharts in the header:

                                                • Area micro chart
                                                • Bullet chart
                                                • Radial chart
                                                • Column chart
                                                • Line micro chart
                                                • Harvey ball chart
                                                • Stacked bar chart

                                                For more information, see Micro Charts.


                                                Form Facets

                                                You can add a quick view to the form facet.

                                                For more information, see Form Facet (Dataset).

                                                Developer Hint
                                                For more information, refer the development team to Form Facet.

                                                Address Facets

                                                You can display an address such as a shipping address.

                                                Developer Hint
                                                For more information, refer the development team to Address Facet in the Object Page Header.

                                                Header Field Groups

                                                You can define fields to display together in a facet. For example, for the product object, in the General Information section, you can include the fields quantity, weight, and supplier.


                                                Rating Indicator Facets

                                                You can add a rating indicator to the header. It is read-only in both display and edit modes.

                                                By default, the maximum rating is five stars.

                                                You can:

                                                • Change the maximum rating.
                                                • Specify more descriptive text for the subtitle.

                                                With extensions, you can make the rating editable.

                                                Display Mode

                                                The rating indicator shows with the:

                                                • Title
                                                • Subtitle with the total number of ratings
                                                • Rating shown with stars: Both the aggregated and non-aggregated single rating types are supported.

                                                Edit Mode

                                                The rating indicator moves into the header facet and appears with only the title in edit mode.

                                                For an aggregated rating, the number of ratings is shown in parentheses after the stars.

                                                For more information, see:


                                                Progress Indicator Facets

                                                You can add a progress indicator facet to the object header.

                                                For more information, see:


                                                Key Value Facets

                                                You can add a key value facet to highlight important data or KPIs.

                                                For more information, see Key Value Facet.

                                                Related Links