Skip to Content
Product Information

UI5ers Buzz #55: Adaptation Project – your one stop tool for extending SAPUI5 Applications


Whether you have already been using Adaptation Project in SAP Web IDE and want some fresh features, or you are trying to find the right tool to adapt applications to customer/partner specific needs, look no further. It’s all now available at SAP`s brand new development platform – SAP Business Application Studio. By using it, you are leveraging features of UI5 Flexibility and able to adapt and extend UI5 applications without actually changing the base app, which allows seamless upgrades and lifecycle stability. Adaptation project also comes with an intuitive WYSIWYG tooling and is really fun to use and you are able to add both UI and code changes to your own variant of the application.

Except availability on the new platform, there are a couple of new features available:

  • Support for extension points – The so-called extension points were previously matter of another plugin – Extension Project. Its abilities are being brought to Adaptation Project, so it becomes the unified one and only tool for extension and adaptation. This feature is also now available in SAP Web IDE and SAP Business Application Studio.
  • Support of Freestyle applications – Till now, it was possible to extend only Fiori Elements-based applications, but from now on you have the ability to extend also Freestyle applications. This feature is now available in both SAP Web IDE and on SAP Business Application Studio, as well.

Let’s go over a simple use case of Adaptation Project on the new platform:

  1. Create adaptation project using one of the Yeoman generators available in SAP Business Application Studio. The wizard will guide you through the process and you will be asked to add the initial properties of your project – name, source system, base app, etc.
  2. You can start the visual editor which will enable you to both preview and edit the application. The possibilities are the same for both SAP Fiori elements-based and Freestyle applications and you can extend them in the same manner – you can adapt UIs, e.g. add/move/remove fields, rearrange sections or even embed iframes, change control properties, extend i18n texts, add custom content via XML Fragments, etc. You can extend also controllers by using the right-click option “Extend with controller”.
  3. It’s also possible to use extension points (if the base app has such). XML Fragments can be added using the “Add Fragment at Extension Point” option from the context menu, when right-clicked over an extension point.


From now on you can use Adaptation Project to benefit from these great capabilities.


For the complete set of features and technical details you can always refer to the official documentation pages:

Adaptation Project at SAP Web IDE

Adaptation Project at SAP Business Application Studio


Previous Post: UI5ers Buzz #54: I18n with supportedLocales and fallbackLocale configuration



htsolevHristo Tsolev is a product owner in CP Extensions team and the Flexibility area. Always looking to improve the experience of customers



You must be Logged on to comment or reply to a post.
  • Hi Hristo,

    I am logged on SAP CPC with my S-User and in SAP Business Application Studio (trial) I have tried all 4 types of Dev Spaces and every time, the options “Adaptation Project” and “Deploy Adaptation Project” are missing. I also installed all Fiori and UI5 related generators but the “Adaptation” options were still missing.



    • Hi Darko,

      The plugin is still not available on Trial environment, but it will be very soon. Please check again around end of September.

      Thanks for your interest in Adaptation Project.

    • Hi Christian,

      thanks for your interest in Adaptation Project.

      I am not sure if I am getting your question right, but if it is about is the adaptation project going to be offered as a standalone plugin for VSCode – yes, it is in our roadmap for next year.



  • Hi Hristo,

    you know why i get this error when I select the system from the dropdown menu (step “Adaptation Project – Configuration”)?


    {"message":"@adaptation-project/adaptation-project generator failed - Cannot read property 'statusCode' of undefined","stack":"TypeError: Cannot read property 'statusCode' of undefined\n at Function.parseErrorResponse (/extbin/npm/globals/lib/node_modules/@adaptation-project/generator-adaptation-project/generators/app/utils/ServiceUtils.js:57:30)\n at Request._callback (/extbin/npm/globals/lib/node_modules/@adaptation-project/generator-adaptation-project/generators/app/utils/ServiceUtils.js:27:38)\n at self.callback (/extbin/npm/globals/lib/node_modules/request/request.js:185:22)\n at Request.emit (events.js:315:20)\n at Request.onRequestError (/extbin/npm/globals/lib/node_modules/request/request.js:877:8)\n at ClientRequest.emit (events.js:315:20)\n at ClientRequest.onConnect (/extbin/npm/globals/lib/node_modules/tunnel-agent/index.js:168:23)\n at Object.onceWrapper (events.js:422:26)\n at ClientRequest.emit (events.js:315:20)\n at Socket.socketOnData (_http_client.js:503:11)\n at Socket.emit (events.js:315:20)\n at addChunk (_stream_readable.js:295:12)\n at readableAddChunk (_stream_readable.js:271:9)\n at Socket.Readable.push (_stream_readable.js:212:10)\n at TCP.onStreamRead (internal/stream_base_commons.js:186:23)"}





    • Hi Moreno,

      is this happening when trying to connect to a specific system, or just a general problem that happens to you no matter of the system chosen ?



        • Hi, that is somewhat strange.

          If you have access to WebIDE, you can try connecting with the same system (just to check if your destination to the system is set in a proper way in the cockpit). The other option for you is to send me a HAR file from your browser recorded while trying to access system and get this error and we can try to further investigate it.

        • Hi Moreno,

          After some investigation we confirmed that its a problem on our side. We have already released a fix for this issue, you can check up again and this should not happen anymore.



  • Dear Hristo,

    In case of Freestyle Standard UI5 Apps, How can we use the extension points(Add Fragments at extension point) option in Adaptation projects. There is one standard Fiori app called ”Request Maintenance(App ID: F1511). I created Adaptation project for the same and i am not able to see available extension points in the SAPUI5 Visual Editor outline. Can you please assist?



    Robin Singh

  • Hi Hristo Tsolev ,

    I also have the same question as posted by Robin above regarding extension points in SAPUI5 Freestyle apps in Business Application Studio Adaptation project. And also in case of Extension Projects will they also be saved as App Variants like Adaptation Projects or will it behave the same way as in R3 system. Please help me to understand this


    Kavita Rathore

    • Hi, Robin`s question/problem is handled in a support ticket, there is a bug in that case which is currently in the process of fixing. On your other question : from now on, whether working with extension points or not, each of your Adaptation project will be saved/deployed as its own app variant and will not have anything to do with the old way of extension project.

  • Hi Hristo,

    I am having issue to open SAPUI5 visual editor for adaptation for SAP standard app Approve timesheet. It is keep on loading the editor and never loading it. I saw it is not showing any error. Is it a know issue? I didn’t find any issue related thread.



    • Hello Guru,

      It does not seem like a known issue. Can you please submit a support ticket and we will handle your issue right away, thank you.