Adapting the UI

Adapting the UI

Both application developers and key users can extend and customize SAP Fiori applications by adapting the UI.

UI Adaptation

Adaptation Type Adaptation Project Key User Adaptation
Enabling Adaptation Adapting the UI
Description App developers can adapt the UI at design time. Key users can adapt the application at runtime by changing the UI from the initial state of the app to a personalized view for end users. In the User Actions Menu, key users can then choose Adapt UI and change the user interface of SAP Fiori apps directly.

For more information about key user adaptation, see SAPUI5 Flexibility: Adapting UIs Made Easy.

Performed By App Developer App Developer Key User
SAP Fiori Elements for OData V2

For information about the features that application developers can adapt, see Adapting the UI: List Report and Object Page, Adapting the UI: Analytical List Page, and Extending the Delivered Apps Manifest Using an Adaptation Project.

For more information about what you have to consider when developing apps that support key user adaptation, see SAPUI5 Flexibility: Enable Your App for UI Adaptation. See the Additional Features in the SAP Fiori Elements for OData V2 section in this topic.
SAP Fiori Elements for OData V4

App developers adapt the UI manually or use SAP Fiori tools for the most common settings. For more information, see the following topics:

For information about how application developers can enable an app for key user adaptation, see Enabling an App for Key User Adaptation.

For more information about what you have to consider when developing apps that support key user adaptation, see SAPUI5 Flexibility: Enable Your App for UI Adaptation.

See the Additional Features in the SAP Fiori Elements for OData V4 section in this topic.

Additional Features in SAP Fiori Elements for OData V2

Variant Management

Key users can create public variants and deliver them to all users or to users with specific roles. This is supported for page variants in list pages and table variants in list report and object pages.

Key users can also perform the following:

  • Modify existing public variants

  • Rename variants

  • Manage views by adding or removing favorites and modifying the visibility

While switching to key user adaptation mode from normal mode, the app starts in a fresh state and the applied changes are not preserved in the internal app state. Also, when a user exits key user adaptation mode, the app restores to the old state it was in before entering key user adaptation mode.

Note

We do not recommend embedding iFrames in the SAP Fiori elements for OData V2 application using UI adaptation.

The following table provides an overview of the available configuration settings for key users:

Configuration Settings for Key Users

Feature Setting Values Description Documentation Additional Information
List Report Variant Management

Page

Control

Configure how variant management is used in the list report.
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Hide Variant Management Configure how variant management is disabled in the list report. Creating a List Report without Variant Management
Initial Load

Auto

Enabled

Disabled

Configure how data is loaded initially when the app is loaded. Loading Behavior of Data on Initial Launch of the Application
Open In Edit Mode Configure to open the object directly in edit mode. Navigation to an Object Page in Edit Mode
Analytical List Page Default Display Mode

Hybrid

Chart

Table

Configure the default display mode of data in the analytical list page. Hybrid View
Filter Bar Display Go Button Configure if the Go button is displayed in the visual filter bar. Only applicable to the analytical list page.
Enable Date Range Configure if the semantic date range options in the manifest.json file are active. Enabling Semantic Operators in the Filter Bar
Navigation Properties Configure the list of filterable properties from navigation entities to include them as filters. Adapting the Filter Bar

Section: Including Navigation Properties

Only applicable to the list report.
Object Page Editable Header Content Configure if the header fields are editable. Toggling the Editability of Header Fields
Table Variant Management Configure if variant management is used in tables on the object page. Enabling Variant Management on the Object Page
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Chart Variant Management Configure if variant management is used in charts on the object page. Enabling Variant Management on the Object Page
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Show Related Apps Configure if the Related Apps button is displayed on the object page. Enabling the Related Apps Button
Table Selection Mode

Single

Multi

Configure if end users can select a single row or multiple rows in a table. Enabling Multiple Selection in Tables
Create Mode

New Page

Inline

Inline Creation Rows

Inline Creation Rows (Hidden in edit page)

Configure the mode for creating tables. Enabling Inline Creation Mode or Empty Row Mode for Table Entries Only applicable to the object page.
Condensed Table Layout Configure if the table uses this layout. Using the Condensed Table Layout Not applicable to responsive tables.
Width Including Column Header Configure if the Column Header label is considered when calculating the column width. Setting the Default Column Width
Enable Select All Configure if the Select All option is displayed in the table. Enabling Multiple Selection in Tables

Section: Select All and Clear All Options in the Table

Selection Limit Configure the maximum limit of the number of rows that can be selected at once. Enabling Multiple Selection in Tables

Section: Limiting the Number of Selected Rows in a Table

Not applicable to responsive tables.
Scroll Threshold Configures the number of additional records that must be dynamically loaded when scrolling the application. Tables Not applicable to responsive tables.
Threshold Configures the number of records that must be loaded during the initial load of the application. Tables Not applicable to responsive tables.
Hide "Add Card to Insights" Configure if the Add Card to Insights feature for My Home in SAP S/4HANA and SAP S/4HANA Cloud Public Edition is hidden. Creating Cards for the Insights Cards Section of My Home in SAP S/4HANA Cloud Public Edition and My Home in SAP S/4HANA Only applicable to the list report.

Additional Features in SAP Fiori Elements for OData V4

SAP Fiori elements for OData V4 provides configuration settings for the list report, the object page, and for the filter bar and tables. These configuration settings are applied to the app's manifest.json file, so they are not immediately visible on the UI. When a key user activates a new version and exits key user adaptation mode, the application automatically reloads with the new settings.

The following table provides an overview of the available configuration settings for key users:

Configuration Settings for Key Users

Feature Setting Values Description Documentation Additional Information
List Report Variant Management

Page

Control

None

Configure how variant management is used in the list report. Creating a List Report without Variant Management
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Initial Load

Auto

Enabled

Disabled

Configure how data is loaded initially when the app is loaded. Loading Behavior of Data on Initial Launch of the Application
Filter Bar Display Clear Button Configure if the Clear button is displayed in the filter bar. Adapting the Filter Bar

Section: Adding a Clear Button

Use Semantic Date Range Configure if the semantic date range options in the manifest.json are active. Enabling Semantic Operators in the Filter Bar
Object Page Table Variant Management Configure if variant management is used in tables on the object page. Enabling Variant Management on the Object Page
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Table Enable Export Configure if the Export button is displayed in the table. Using the Export Button
Frozen Column Count Configure the count of columns that are always visible when scrolling horizontally. Tables
Personalization

Enabled

Disabled

Own Settings

  • Sorting

  • Columns

  • Filtering

  • Grouping

Configure if the table personalization settings are enabled. To configure the listed settings individually, choose Own Settings. Enabling Table Personalization
Note

Settings made by a key user can override those made by an end user. This means that end users may need to reapply their personalization settings.

Row Count Configure the number of rows to be displayed in the table.

Only applicable to the object page.

Not applicable to responsive tables.

Condensed Table Layout Configure if the table uses this layout. Using the Condensed Table Layout Not applicable to responsive tables.
Width Including Column Header Configure if the Column Header label is considered when calculating the column width. Setting the Default Column Width
Select All Configure if the Select All option is displayed in the table. Enabling Multiple Selection in Tables
Selection Limit Configure the maximum limit of the number of rows that can be selected at once. Enabling Multiple Selection in Tables Not applicable to responsive tables.
Enable Add Card to Insights Configure the Add Card to Insights feature for My Home in SAP S/4HANA and SAP S/4HANA Cloud Public Edition. Creating Cards for the Insights Cards Section of My Home in SAP S/4HANA Cloud Public Edition and My Home in SAP S/4HANA