Extending SAP S/4HANA Cloud Public Edition using SAPUI5 adaptation projects

[elisabeth_riemann]

You can now work with SAPUI5 adaptation projects to extend your SAP S/4HANA Cloud Public Edition system by creating application variants that fulfill the specific business needs of different business roles, groups or users, organizational units, and countries. For example, you might want to create an application variant to simplify and streamline a specific process by hiding fields not required by casual users, visualizing data as a chart, or changing a responsive table to a grid table to make information easier to process.

In an adaptation project, developers efficiently use the original SAP Fiori application together with its OData service and application logic to define changes that are specific to the application variant only. After deployment, both the source application and the newly created application variant exist with distinct titles and can be made available to the relevant business users through uniquely named application tiles in My Home, the new starting point for SAP S/4HANA Cloud Public Edition.

Fig 1: Create new SAPUI5 adaptation project in SAP Business Application Studio

Fig 2: Relationship between source application (blue) and application variant created by SAPUI5 Adaptation Project (green).

Cloud upgrade safe

To comply with automated Cloud upgrades and ensure the stability of your extensions, application variants created with SAPUI5 adaptation projects contain a runnable snapshot of the original (base) application containing all UI artifacts and a local copy of all UI annotations. In other words, SAPUI5 flexibility safely separates your extension code from the original application lifecycle, provided you follow the upgrade safe compatibility rules and best practices for controller extensions.  

After a Cloud upgrade, developers can test the application variant in SAP Business Application Studio and, if there are no issues, they can deploy it again to benefit from the latest SAP enhancements to the original application. For more information, see Check Whether the Base App of an Adaptation Project Is Up-To-Date.

Get started

Learn how to create an app variant via SAPUI5 adaptation project by completing these step-by-step developer tutorials https://developers.sap.com/group.sapui5-adaptation-projects.html.

For more information, see: Extending an SAP Fiori Application for SAP S/4HANA Cloud Public Edition  

To check whether an SAP S/4HANA Cloud Public Edition application supports extensibility via SAPUI5 adaptation projects, look up the app in SAP Fiori Apps Reference Library and refer to the Implementation Information under Extensibility (Extensibility via SAPUI5 Adaptation Project: Supported) for example Manage Customer Contracts.

Fig 3: SAP Fiori Apps Reference Library: Implementation Information

If the SAP-delivered application you want to extend with an application variant is not yet supported, please let us know by submitting a request here: Influence Opportunity Homepage - Customer Influence (sap.com).

With the addition of SAPUI5 adaptation projects (part of SAPUI5 flexibility), SAP S/4HANA Cloud Public Edition supports both developer extensibility (see Extending an SAP Fiori Application for SAP S/4HANA Cloud Public Edition) and key user extensibility options (see Adapting SAP Fiori UIs at Runtime - Key User Adaptation).