Cache cleanup in SAP BTP HTML5 Applications

Dear SAP users,

In this blog I’m going to explain how to fix one of the common errors when deploying a new version of a SAPUI5 application in a SAP BTP / SAP Cloud Platform environment

Issue

When trying to open an application in the SAP Cloud Platform (or Portal) the following error is shown:

Error caption

If the console log is opened (Press F12 button of the browser), the following errors appears:

• “Error: resource undefined could not be loaded from /sap/bc/lrep/content/…/manifest.appdescr”

• “Failed to load UI5 component for navigation intent #<intent> … “

Cause

This error happens after uploading a new version of the HTML5 application through SAP BTP Cockpit and setting it as an active version.

The application is trying to retrieve source files corresponding to the new version, but the application cache has the reference to the previous version. At this time the error appears.

Resolution

1. Access SAP BTP Cockpit. On the left menu, click on the ‘Services’ menu, and search for ‘Cloud Portal Service’. Click over the item:
2. Then, go to the ‘Take Action’ section and click on ‘Go to service’:
3. Now, SAP Cloud Portal Service will be shown. On the left menu, click on ‘Site Directory’. All your available sites will be shown. Put your mouse over the desired site and click on ‘Edit’. A new tab will be open.
4. Now, on the left side navigation menu, click on ‘Settings’:
5. Now, on the top right side of the page. click on the ‘World’ icon: 
6. Check the box for clear caché and click ‘Publish’ button:

Now your new version will be published and cache will be cleared. The error must have disappeared.

Additional case

If your app has been published before and you only want to clear the cache, please go to the bottom right of the ‘Settings’ page and click on actions. The clear cache option will be shown:

Only clear cache without publishing a new version

Regards,

Sergio.

References

• https://me.sap.com/notes/0002388084
• https://me.sap.com/notes/0002491422