3628761 - New Layout for Launchpad Shell Bar and Menus - Information

Symptom

If you are using SAP S/4HANA Cloud Public Edition 2602, please refer to 3689842 - New Layout for Launchpad Shell Bar - Information - SAP S/4HANA Cloud Public Edition 2602 - SAP for Me

Before switching to the "New Layout for Launchpad Shell Bar and Menus" via feature toggle (/UI2/SHELL_BAR_TOGGLE), the following side effects and its actions need to be considered.

The following side effects can be observed with the "New Layout for Launchpad Shell Bar and Menus":

Automation scripts (RPA) and automated tests that interact with the SAP Fiori launchpad shell bar or user menu might fail.
Hotspots for Custom SAP Companion help content are lost in the SAP Fiori launchpad shell bar or user menu.
Custom plugins or applications that add items to the SAP Fiori launchpad shell bar or user menu are not working correctly.

Environment

SAP S/4HANA Cloud Public Edition 2508

Reproducing the Issue

How to identify whether the New Layout for Launchpad Shell Bar and Menus is used.

As business user:

New layout vs. Classic layout

As administrator:

Checking the feature toggle state.

[Option 1] Central Business Configuration

Central Business Configuration tenant > Configuration > Configure Your Business Processes > General Settings > Cross-Application > Activate New Features

SAP S/4HANA Cloud Public Edition system > Implementation Activities > General Settings > Cross-Application > Activate New Features

[Option 2] Solution Builder

Manage Your Solution > Configure Your Solution > Filter by "Application Area: Application Platform and Infrastructure" and "Sub Application Area: General Settings" > "Define application-independent system settings" > Configuration Steps > 9. Activate Features (ID 106573).

Cause

The New Layout for Launchpad Shell Bar and Menus will be delivered in a 2-phases approach and via feature toggle /UI2/SHELL_BAR_TOGGLE (Switch for new launchpad shellbar).

With SAP S/4HANA Cloud Public Edition 2508, the feature toggle will be switched off by default.
With SAP S/4HANA Cloud Public Edition 2602, the feature toggle is planned to be activated by default.

This 2-phases approach allows you to activate the upcoming standard user experience well in advance to take all necessary actions to ensure your custom apps, plugins or help content continue to work. SAP highly recommends to activate the feature toggle /UI2/SHELL_BAR_TOGGLE right after the upgrade of SAP S/4HANA Cloud Public Edition to 2508 release.

Resolution

For more information, please refer to SAP Note 3627739 - SAP Fiori launchpad UX consistency-related DOM changes - SAP for Me

Before switching ON the feature toggle:

Identify custom test and automation scripts that use Document Object Model (DOM) selectors to trigger shell actions like shell bar buttons, notifications, and user menu entries.
Identify custom apps and plugins that use DOM selectors to function. As the HTML DOM is not an API, those accesses should be replaced by proper API usages.
Identify and update custom apps and plugins that add Shell Bar Items:
- Ensure to use the latest launchpad API: https://sapui5.hana.ondemand.com/#/api/sap.ushell.services.FrameBoundExtension%23methods/createHeaderItem
- If possible, add the items by providing a settings object instead of a control instance. By this, the launchpad ensures to create the correct control type.
- If a shell bar item opens a popover, make sure to provide the correct openBy DOM reference. With the updated shell bar, the visible DOM element is different from the control that was added to the shell bar items slot:

oPopover.openBy(oEvent.getParameter("targetRef") || oEvent.getSource());

- If custom help content needs to be assigned, use help-ids to ensure stable hotspots

After switching ON the feature toggle:

Update custom test- and automation scripts to function with the new DOM structure. Ideally, update them in a way, they are DOM agnostic.
Update custom help-content hotspot assignments

Keywords

DOM, WebElements, FLP, test, automation, test case, 2508, script, ushell, createHeaderItem, ShellBar, Signout not working, Log-off not working, sign out, RPA, automated, test, Companion, Enable Now, scripts, SAP Fiori Launchpad, launchpad, shellbar, shell bar, shell, user menu, hotspots, plugin, plug-in, feature toggle, /UI2/SHELL_BAR_TOGGLE, Switch for new launchpad shellbar, /UI2/SIDE_BAR_TOGGLE, 3627739, what's new, whats new, S/4hana Cloud, public cloud, Public Edition, S4HC, Fiori launchpad DOM changes, web components in Fiori launchpad, failing automation scripts in Fiori launchpad, in-app help hotspots, x-ray hotspots, FLP DOM, test automation sign-out, logout, log out button user menu, plugin , KBA , CA-FLP-FE-UI , SAP Fiori Launchpad User Interface , CA-FLP-FE-AI , Application iframe communication in FLP and Work Zone , CA-FLP-FE-DT , SAP Fiori Launchpad Frontend Content Admin Tools , CA-FLP-FE-COR , SAP Fiori Launchpad Frontend Core and Services , Problem

Product

SAP S/4HANA Cloud Public Edition all versions

Attachments

Pasted image.png

3628761 - New Layout for Launchpad Shell Bar and Menus - Information - SAP S/4HANA Cloud Public Edition 2508