Direkt zum Inhalt wechseln

SAP UI5 Adaptation Project

TL;DR: There are times in which the functionality of an SAP Fiori App is not enough. In this blog we investigate if it is possible to add an adaptation project to the corresponding Fiori app. Furthermore, we provide tips and best practices for developers.

Adaptation projects offer a great way to extend the sap standard apps. This blog gives an introduction about what requirements have to be met as well as it should also serve as a cheat sheet for developers. Thus, the blog is split up into two main sections. The first one ensures the feasibility wheras the second part focuses more on the development side of an adaptation project.

Feasibility of an Adaptation Project

Adaptation Project

Adaptation Projects are used to meet customer requirements in SAP Standard Apps. Examples can be to add custom behavior which will be invoked by pressing an button which was added to the standard app.
Be aware that not every standard app delivered by SAP can be extented with an adaptation project. Only the apps which are developed with SAP UI5 can be extented this way. In the Fiori apps library it is easy to determine the developing language of the app.

Entry of the Fiori apps library which can be extended

Once the criteria is met and the app can be extended with an adaptation project the visual editor comes into place. The visual editor is integrated in the SAP BAS which allows the user to adjust properties of the standard app as well as to add custom controls and logic. To do so rightclick on the area which should be extented and add your control or logic.
There is a safe mode which can be activated, this one should ensure that the extension will work with future system upgrades.

Make Adaptation project visible

To test the adaptation project in the original app the launchpad customizing has to be adjusted. Therefor it is best practice to create a new mapping for the routing as well as a new tile which will then open the created variant. Hence, the standard app will still be available if in the deployed extension an error occurs. The target mapping requires the parameter sap-appvariant-id and should look like the following:

Target mapping of an adaptation project

Once the target mapping is created the appvariant (the adaptation project) can be called by using the # of the original app in combination with the urlParameter sap-appvar-id: #YAIFMessage-display?sap-appvar-id=customer.<namespace>

To ensure, that the adaptation project is called the inspector is required. Above the directory of the developed and the standard apps the will be another directory for adaptation projects.

Debug extension

In the inspector you then can see that a directory lrep/flex/modules which contains the extension.
In this directory you can find the coding of your adaptation project. If this entry is not listed then it is a hint that there might be a syntax error within your extension.

Useful tools by SAP

SAP delivered some useful tools to further investigate an app. As a reminder those tools are listed with the corresponding keyboard shortcuts.

Keyboard Shortcuts der SAP: SAPUI5 SDK Demo Kit

Development of an Adaptation Project

Extension coding

In the adaptation project it is possible to either override the methods of the extended controller (be careful on this one), to define your own methods and execute them as well as to override lifecycle methods of the standard app. When overriding lifecycle methods be aware that your coding in the extension will not replace the coding of the standard app – rather your coding will be called after as well as before the lifecycle method of the standard app. See the following picture as demonstration.

Source: UI5 extension of controller and lifecycle methods

return ControllerExtension.extend("customer.<namespace>.ExcelReport", {
        onInit: function(oEvent){
        onAfterRendering: function(oEvent){

The context of the controller extension can be retrieved via


(in the debugger). The context of the extented controller can be retrieved via


Contexts and extension Methods

The following information lists the commands to navigate between the contexts of the controller and the extension. Hence, to use the controller context of the original app as well as the context of the extension.

Context of the extension


this Context of the current controller

this.base.<variable> = 'abc'

Controller of the current view


Helpfull skills

Further helpful skills which might come in handy are:

  • UI5 Eventhandling
sap.ui.getCore().getEventBus().publish("YourEventChannel", "getAllData", {})
  • basic jQuery
    • to retrieve a control if it is available (fully rendered and with available data)
    • to automatically scroll up and down in an section
var intervalId = setInterval(
    () => {
        var oExtContext = this.base.extension.customer.namespace.OverviewExtension
        // if the cards (especially the headers) are rendered
        if ($("div[id*='cardHeader']")[0]) { 
    },1000, this, intervalId);

Problems which can be occur

  • More than one extension project could be required while navigating to a detail view (check the app-ID after navigating)
  • If the standard app uses the oData v4 Model it can be very hard to retrieve the data which are binded to the view. Since the Model / Context methods getProperty() and getObject() are not available in the v4 model. On a binding (get it from the view) it is possible to use the method requestObject() which then will return a promise.
await this.base.getView().byId(<id>).getBindingContext().requestObject()
    .then(function(oData) {
    .catch(function(oErr) {

This post is part IV of a blog series.

Read als part I: Fiori Introduction

part II: Fiori Customization

Part III: Extensibility Scenario With Key User Tools