- SAP Managed Tags:
In this blog post, I will guide you through the process of switching from the theming communication scenario SAP_COM_0086 (SAP BTP, Neo environment) to SAP_COM_0623 (SAP BTP, Cloud Foundry environment). This switch enables you to access the latest features of the UI theme designer, such as theme migration.
Background
In an S/4HANA Cloud system, you use the UI theme designer from either the SAP BTP, Cloud Foundry environment or the SAP BTP, Neo environment to create and manage custom themes for SAP applications. To do this, you must implement one of the communication scenarios for the UI theme designer. For more details, refer to the documentation on Integrating UI Theme Designer.
Why is it important to switch to the communication scenario SAP_COM_0623 (SAP BTP, Cloud Foundry environment)?
- Sunsetting of SAP BTP, Neo Environment: The SAP BTP, Neo environment will be retired by the end of 2028. For more information, refer to the blog post Farewell, Neo!
- End-of-Life for Belize Theme: The Belize theme has reached its end-of-life with SAPUI5 1.135. By using the UI theme designer on the SAP BTP, Cloud Foundry environment, you can migrate your custom themes to modern themes based on Quartz or Horizon. For further details, see:
- SAP note 3595596.
- Blog posts: Removal of Belize Theme of SAP Fiori and Upcoming Removal of SAP Fiori Themes Belize and Blue Crystal.
Prerequisites
- You already have a subaccount on the SAP BTP, Cloud Foundry environment.
Procedure
Step 1: Initial Setup
- Set up the UI theme designer on the SAP BTP, Cloud Foundry environment as described in the guide Initial Setup of UI Theme Designer: Portal Scenario.
Step 2: Copy Themes
- Export your custom themes from the UI theme designer in the SAP BTP, Neo environment. For detailed instructions, refer to Exporting Themes.
- Import your custom themes into the UI theme designer in the SAP BTP, Cloud Foundry environment. For detailed instructions, refer to Importing Themes.
- If your custom theme is based on the Belize theme, migrate it to a theme based on Horizon or Quartz. See Migrating Themes for further information.
Note: The Belize theme has been deprecated since SAPUI5 version 1.120 and was removed in SAPUI5 version 1.135. - After a successful migration, rename your theme accordingly. Use the same theme ID as before to ensure that no changes are needed for users to continue using the theme. For detailed instructions, refer to Renaming Themes.
- Test your theme using the preview pages available in the UI theme designer. For detailed instructions, refer to Editing Themes.
Note: Migration will keep as many of your changes as possible, such as changed parameters or uploaded resources like a logo. However, there will be cases where the result is not 100% correct. Revisit the migration result and use it as a starting point for manual fine-tuning. - Publish your theme to make it available for use. For detailed instructions, refer to Publishing Themes.
Step 3: Switch Communication Scenario
Important: Perform this step during a maintenance window when few or no users are active in the system. While switching the communication scenario, applications will temporarily display the SAP standard theme.
- Delete the communication scenario SAP_COM_0086 for the SAP BTP, Neo environment.
- Create a new communication scenario for SAP_COM_0623 (SAP BTP, Cloud Foundry environment) as described in the guide SAP BTP, Cloud Foundry Environment (SAP_COM_0623).
- Test your custom themes with the SAP Fiori Launchpad in the S/4HANA Cloud system.
Recap
By following the outlined steps—setting up the UI theme designer on the SAP BTP, Cloud Foundry environment, migrating your themes, and switching the communication scenario—you can modernize your theming approach and ensure a seamless transition with minimal disruption to your users.
For additional information, refer to the linked SAP Notes and guides. If you need further assistance, feel free to reach out via component CA-UI2-THD.
