SAP Fiori Launchpad For SAP S4HANA CLOUD

Download as pdf or txt
Download as pdf or txt
You are on page 1of 156
At a glance
Powered by AI
The document discusses custom themes for the SAP Fiori launchpad and how to configure them. It provides information on setting up custom themes on SAP Business Technology Platform and activating them in the launchpad.

SAP Fiori launchpad is the entry point to apps on mobile and desktop devices. It gives users the relevant information they need at a glance and centers on their needs and how they work.

The SAP Fiori launchpad is a real time, role based, and personalized environment where all your SAP Fiori applications run. Navigation and search features ensure that you can quickly and effortlessly carry out your daily tasks.

4/9/2023

SAP Fiori Launchpad for SAP S/4HANA


Cloud
Generated on: 2023-04-09 12:38:38 GMT+0000

SAP S/4HANA Cloud | 2302.1

PUBLIC

Original content: https://help.sap.com/docs/SAP_S4HANA_CLOUD/4fc8d03390c342da8a60f8ee387bca1a?locale=en-


US&state=PRODUCTION&version=2302.501

Warning

This document has been generated from the SAP Help Portal and is an incomplete version of the official SAP product
documentation. The information included in custom documentation may not re ect the arrangement of topics in the SAP Help
Portal, and may be missing important aspects and/or correlations to other topics. For this reason, it is not for productive use.

For more information, please visit the https://help.sap.com/docs/disclaimer.

This is custom documentation. For more information, please visit the SAP Help Portal 1
4/9/2023

SAP Fiori Launchpad


SAP Fiori launchpad is a shell that hosts apps built with different UI technologies, and provides these apps with services such as
navigation, personalization, embedded support, and application con guration.

What is SAP Fiori launchpad?


SAP Fiori launchpad is the entry point to apps on mobile and desktop devices. It gives users the relevant information they need
at a glance and centers on their needs and how they work.

The new design of the launchpad displays a panoramic user interface. Users can focus on their daily work and still keep track of
what's going on in other areas.

About SAP Fiori


For more information, see SAP Fiori on SAP Help Portal at http://help.sap.com/ ori.

You can nd the roadmap for SAP Fiori at http://www.sap.com/solution/roadmaps.cross-topics.html under SAP Fiori.

For new users we recommend the tutorial SAP Fiori Launchpad. In this ve-minute tutorial you learn how to work with the
launchpad and get to know the most important features.

Related Information

What's New
Get an overview of the main new features and enhancements in SAP Fiori launchpad.

See What's New Viewer.

This is custom documentation. For more information, please visit the SAP Help Portal 2
4/9/2023

User Guide
This guide provides you, the end user, with information on how to optimally use the SAP Fiori launchpad.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

Tutorial
For new users we recommend the SAP Fiori Launchpad tutorial. In this ve-minute tutorial you learn how to work with the
launchpad and get to know the most important features.

About the Launchpad


The SAP Fiori launchpad is a real time, role based, and personalized environment where all your SAP Fiori applications run.
Navigation and search features ensure that you can quickly and effortlessly carry out your daily tasks.

When you rst log on to the launchpad, the home page opens displaying prede ned groups of apps con gured by your
administrator. You can personalize your launchpad by adding more groups and apps, removing those that you don't need, and
reorganizing the groups according to the way you want to work.

Want to know more about the launchpad?


Hover over each area in the image for a description, click highlighted areas for more information.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

This is custom documentation. For more information, please visit the SAP Help Portal 3
4/9/2023

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

Shell and Shell Bar


When you launch apps from the SAP Fiori launchpad, the apps run within a shell. The shell is the outer frame of the SAP Fiori
launchpad.

The shell contains a shell bar on top and footer areas with various buttons, icons, and a logo. A default footer is not provided
out-of-the-box with SAP Fiori launchpad.

What will I see in the default shell bar?


The following table lists the icons available in the shell bar of the launchpad.

 Note
The icons described in the table below may change depending on where you are working in the launchpad. For example, you
may see the back button when navigating in an app, but not when you are in the home page.

Icon Name Description

Company or brand logo Displays the default SAP logo that you can replace with your own logo using the UI theme
designer. If you click on it, you return to the home page, if you are not already on the
home page. On a smaller screen this might be replaced by a home icon.

If you work with pages and spaces, clicking on the logo will open the page again on that
you opened the app.

Back Navigates from an app back to the previous screen where you were working.


Digital Assistant Launches the digital assistant.

 See: Working with the Digital Assistant

Help Opens the in-app help. The help panel appears with help content or, additionally, further

 information on how to nd help. You can also use F1 to open the help.

Search Opens a global search user interface for nding apps and objects. On larger screens, the

 search eld is directly shown centered in the shell bar.

See: Searching for Business Objects and Apps for more information.

This is custom documentation. For more information, please visit the SAP Help Portal 4
4/9/2023

Icon Name Description

Give Feedback There are two ways to give feedback:

 Clicking the icon in the shell bar

This lets you give general feedback on the currently opened app. When you click
the icon, a short survey is opened. Answer the questions, enter additional
feedback if you wish, and submit your answers.

Via a feedback invite

There are various ways that lead to an invite to give more speci c feedback:

Time-controlled survey

The system sends an invite to the user according to a timing rule.

Application-triggered survey

The system triggers an invite when the user uses a speci c app or
feature.

Contact Support Allows you to contact the support directly from the launchpad.

 See: Contacting Support.

Noti cations Opens the Noti cations window with the alerts, tasks, or requests that are related to your

 business role.

The icon also shows a badge with the number of new noti cations you have received.

See: Working with Noti cations

Built-In Support Opens the built-in support, where you can search for information in the SAP Support

 Knowledge Base, access the incident management, and collaborate with SAP support
experts.

See: Working with Built-In Support

More options This icon is displayed when there is not enough space to show all icons in the shell bar.

 Click on it to see all hidden icons. If the noti cations icon is hidden, this icon shows the
number of new noti cations.

User Actions Menu This icon usually show the initials of your user name. It opens the user actions menu.

 or
 Note
This icon is replaced with your pro le picture if SAP Jam is integrated in your
environment and you have a picture de ned in SAP Jam.

See: User Actions Menu

In the middle of the shell bar, you'll see either Home (when you have the home page displayed) or the title of the current app
you are using. You can click Home  to directly open the All My Apps navigation option, or click the app's title to open the
hierarchical navigation menu. The hierarchical navigation menu provides you with several quick actions depending on the
context you are in, such as:

Navigate within an app.

See a history of your recent steps that have brought you to the current view.

Access apps and objects that are related to the current app.

Navigate back to the home page.

This is custom documentation. For more information, please visit the SAP Help Portal 5
4/9/2023
Launch the All My Apps navigation option.

For more information, see Navigating Within and Between Apps.

Entry Page
The entry page is the heart of the SAP Fiori launchpad. It is where you open your SAP Fiori apps.

What will you see in the entry page?


The entry page is your starting point. It's the main area where you work and where tiles, representing the apps you work with,
are clustered. When you rst log on to the launchpad, you'll see the apps and groups or sections that have been precon gured
for you. How the apps are displayed here depends on your launchpad con guration. Depending on your system setup, there are
two general options available:

the spaces layout: you have one or more spaces, that contain one or more pages. The pages show your apps clustered in
different sections (see Spaces and Pages). In spaces mode, a personalized start page is available (depending on the
system con guration). This can be a speci c page delivered by SAP (My Home for SAP S/4HANA Cloud) or My Home. My
Home (deprecated) is a page, where you can add your preferred apps. My Home in SAP S/4HANA Cloud is a prede ned
entry page. You can personalize the complete page, including the To Dos, Pages, Apps and Activities and Insights section
based on your needs (see My Home in SAP S/4HANA Cloud).

The spaces layout was introduced to provide more exibility regarding which apps are shown on a page. Your
administrator can now assign pages de ned for speci c user groups delivered by SAP to you or they can create own
user-group speci c pages. By this, a page should show less apps that are more precisely adapted to your needs.

the classic home page layout: there is one page that contains your apps clustered in groups (see Home Page
(deprecated)). For customers who start using SAP S/4HANA Cloud with version 2302 or later, the home page based on
groups is not available.

This image is interactive. Hover over each area for a description.

Please note that image maps are not interactive in PDF output.

This is custom documentation. For more information, please visit the SAP Help Portal 6
4/9/2023
What you see on the entry page may also change depending on the device that you are using. For example, if you are using a
mobile device, you won't see apps on your launchpad that do not support mobile devices.

Differences between the display options


In general, the handling is the same, the new spaces layout offers most of the options you already know from the home page.
Yet, there are some differences:

The most important one is that the navigation bar on top shows the groups in the home page mode but the space name
in the spaces mode. In the home page mode you go to a group on the home page when clicking on a name. In the spaces
mode you go to a different page in another space if you have more than one assigned space.

There are more tile sizes available in the spaces mode. A page in the spaces mode can display tiles in four different sizes
and as links. Read for more information.

There are some changes in the personalization options. See sections Personalizing the Home Page (deprecated) and
Personalizing a Page for detailed information.

How to switch between the display options?


How the apps are displayed is set by your administrator. You may be able to decide which display you prefer if your
administrator has enabled this option for you. Go to the Settings dialog and enable (or disable) the spaces mode. When you
change the status and save your changes, the launchpad will be restarted. See Managing Your Settings for more information.

Navigating in the entry pages


As mentioned above, the navigation is different in the two layout options.

In the home page you click on an entry to go to the group of apps with that name.

In the spaces mode there are different possibilities, depending how the spaces and pages are con gured for you. When a
space only has one page, you go to this page when you click on the space name. When the space contains several pages,
a down arrow is displayed next to it. You open the rst page when you click on the space name. Click on the arrow icon
next to the space to open the menu with all pages. Click on a page name to open this page.

Open apps from the launchpad


Click a tile to open an app. You can also use the right-click menu to open an app in a new browser tab or window.

When you open an app in a new browser tab or window, it opens in lean mode:

The Noti cations and Search icons are not displayed in the shell header, and are only available in the main launchpad
page.

The Back button only appears after further in-place navigation.

The Home entry is not displayed in the navigation hierarchy in shell navigation and Related Apps.

 Note
If some apps cannot be loaded, this might be related to a browser setting. If you work e.g. with a Safari browser and have
enabled the option Cross Site Tracking Prevention, loading of an app may be prevented. Disable this setting to ensure that
all apps can be loaded correctly.

This is custom documentation. For more information, please visit the SAP Help Portal 7
4/9/2023
In the home page: If you see a tile with and error "Cannot load tile", you can click on it to see more information why the tile
was not loaded. Clicking on Show Details opens more technical information. It should help your administrator nding the
cause for this error.

Personalize your entry page to suit your working environment


There are many other personalization options available to help you adapt your launchpad to your working environment, such as
dragging and dropping tiles or links to rearrange your home page or a page. In the user actions menu, you can access a number
of tools and useful links that allow you to personalize your launchpad. For example, depending on your role, you can access the
app nder and choose from a wide array of ready-to-use apps and add them to your home page or a page.

For information about more personalization options, see Personalizing the Home Page (deprecated) and Personalizing a Page.

Spaces and Pages


The launchpad page is the central part of the launchpad. Here you access your SAP Fiori apps.

A space is the unit that holds one or more pages. It is assigned to you based on your work pro le (user role). You may see
several spaces in your launchpad. The spaces are displayed in the navigation bar where you can switch between the different
available spaces and pages.

A schematic display of spaces and pages

A page is the part of the space that contains the apps as tiles and links clustered into different sections. It is shown in the main
area of the launchpad. When you log on to the launchpad, you'll see the apps and sections that have been precon gured for you.
The page is your central starting point in the launchpad and should show you the apps that are relevant for the context of your
daily work. Note that the pages do not show all apps you can access based on your role and the catalogs assigned to the roles,
but only a selection your administrator made available. You can access all apps you are eligible to use by searching for them in
the search eld, in the app nder or in the All My Apps menu.

The navigation bar above the page shows the space name. If you have several spaces assigned you can click on the arrow next
to a space to navigate to the page that belongs to the space.

This is custom documentation. For more information, please visit the SAP Help Portal 8
4/9/2023

On top of the of a page a Recently Added Apps section may be shown. It is displayed if you added apps using the app nder or by
bookmarking them and shows you the apps you just added to the launchpad page (see Adding Apps to a Page for more
information).

What you see on the page may also change depending on the device that you are using. For example, if you are using a mobile
device, you won't see apps on your launchpad that do not support mobile devices.

Tutorial
For a quick overview on what's new or different with spaces and pages you can use the tutorial Working with and Personalizing
Spaces and Pages .

My Home in SAP S/4HANA Cloud


My Home in SAP S/4HANA Cloud follows a modular approach to meet the needs of different roles.

Overview
My Home is the standard entry page and it is divided into different sections. You can view your To Dos, Pages, Apps and
Activities, and Insights on this page. Following the “Make it Mine” approach, you can personalize the entry page to hide or
display speci c sections as well as the content maintained within these sections.

This is custom documentation. For more information, please visit the SAP Help Portal 9
4/9/2023

The entry page is designed to work across all devices.

This is custom documentation. For more information, please visit the SAP Help Portal 10
4/9/2023

Layout for My Home


You can change the layout of the entry page using the My Home Settings option that’s available within the User Actions Menu.
In the subsequent dialog, you can choose to display or hide the sections based on your needs. You can also reposition the
sections to display in the order of your choice. Just drag and drop the sections until they match the order you wish to see.

You can also use the Reset option to return My Home to its initial settings maintained by your administrator.

This is custom documentation. For more information, please visit the SAP Help Portal 11
4/9/2023
You can also access the Layout tab by clicking Edit from the applicable section of the entry page.

To Dos
The To Dos section displays your tasks and situations. A counter directly shows you the number of tasks or situations that need
your attention. You can expand the section by selecting the Enter Full-Screen Mode icon to view a maximum of 100 tasks or
situations (based on your screen size) at a glance.

To access all your tasks or situations click Go to All Tasks or Go to All Situations.

Tasks

You can view the tasks that require your attention by clicking on the tile to navigate to the details.

Situations

You can monitor all important situations at a glance. You can navigate to the details by clicking on the respective tile to open the
app for the selected situation.

 Note
This section appears based on the user authorizations for the situations and the My Inbox application.

Pages
The Pages section is divided into two parts:

News

The news tile can be con gured by administrators and is switched off by default. It displays user-relevant news and other
updates. The size of the news tile adjusts depending on the number of favorite pages added in this section. If no pages are
selected, the news tile spans the entire section.

Pages

The rst eight unique pages of your con gured spaces are displayed by default. A maximum of eight pages can be displayed at a
time. These pages have a prede ned color and an icon that can be set by an administrator. The space name for a page is
displayed as a subtitle. If the title of a page and its space name are the same, then only the page name is displayed as the title.

You can add or remove any page that you want to see by clicking Edit. From the subsequent My Home Settings dialog, you can
select your preferred pages within the Favorite Pages tab.

This is custom documentation. For more information, please visit the SAP Help Portal 12
4/9/2023

Apps and Activities


The Apps and Activities section contains the following tabs:

Favorites

This tab is automatically populated based on the distinct list of apps that were con gured by you in your My Home entry page.
Within the Favorites tab, you can rearrange the tiles using drag and drop, select the color of the app tile, or delete an app. To do
so, open the More menu of the app and select either of the available options. To add more apps to this tab, you can access the
App Finder by clicking Add Apps. While you can add a maximum of 250 apps to the tab, it is recommended that you use this tab
to add the most commonly used apps.

Recent Activities

This tab is empty when you use My Home for the rst time. Once you have used certain apps, they appear in this tab
automatically. The apps that are displayed in this tab are an interactive history of the items you have searched for and worked
with recently.

Frequently Used

This tab is empty when you use My Home for the rst time. Once you have used certain apps, they appear in this tab
automatically. The apps that are displayed in this tab are the ones that you've searched for and opened, or used most
frequently over the last 30 days.

 Note
The Recent Activities and Frequently Used tabs are hidden if the Track my recent activity and frequently used apps
checkbox is disabled in the User Activities.

You can also access the App Finder to view the complete list of available apps directly. To do so, click on Add Apps.

Insights

This is custom documentation. For more information, please visit the SAP Help Portal 13
4/9/2023
The Insights section is divided into two parts, Tiles and Cards. Both display dynamic content, where you can monitor valuable
KPIs at a glance. You can edit Tiles or Cards by clicking Edit within these subsections. You can also view all the tiles and cards in
an expanded mode by clicking on the View All Tiles or View All Cards option in each section. Note that the option to expand the
section is available when not all the added tiles and cards are visible on the entry page.

Tiles

The Tiles subsection is automatically populated based on the distinct list of monitoring apps that were con gured in your My
Home entry page. To add a new application directly to the Insights section, you can use the App Finder option available within
the Edit dialog for Tiles. You can also use the following editing options:

Available Tiles

Shows a list of tiles that you’ve already added and that are being displayed on the entry page. You can rearrange these
tiles using drag and drop.

Suggested Tiles

Shows a list of available tiles that provide dynamic content. These tiles are the ones that you can nd within the
Favorites tab of the Apps and Activitites section. You can use the Add to Insights button to move a tile to the Available
Tiles list.

Convert to Wide Tile

Converts a few selected tiles into a 4x2 wide tile. To do so, you can use the toggle button available next to a tile.

Remove from Insights

To remove a tile from the Insights section, simply click on the delete icon for that tile. The tile then moves to your
Suggested Tiles list. You can add the tile back to the Insights section by clicking on the plus icon.

Cards

With My Home in SAP S/4HANA Cloud, you can add analytical, list and table cards to the entry page. These cards are a part of
your overview page and the list report pages. These cards offer further navigation options to their respective applications when
you click on the card header, or the content area. You can also chose to navigate from the More menu available on the card. For
more information, see Overview Page Card, Analytical Card , Table Cards and List Cards.

You can select a maximum of ten cards to be displayed within this section. You can rearrange cards by using drag and drop.

You also have the following editing options for cards:

Available Cards

Shows a list of cards that you’ve already added and that are being displayed on the entry page. You can rearrange these
tiles using drag and drop.

Preview

You can preview a card and all its details by clicking on it from the Available Cards list. In the subsequent dialog, you can
preview the card and view other relevant card details.

Copy

To create a copy of an existing card, click on the card you want to copy. From the subsequent dialog, click Copy. You can
preview the changes by clicking Refresh. Once you click Save, a copy of the card is added to the list of Available Cards. To
display the created card on the entry page, you can select the checkbox and click Close.

Delete

This is custom documentation. For more information, please visit the SAP Help Portal 14
4/9/2023
To delete a card, click on it from the Available Cards list and select Delete. Note that you cannot retrieve a card once it
has been deleted.

Activating My Home in SAP S/4HANA Cloud


You can choose to use My Home in SAP S/4HANA Cloud by activating Spaces and Pages in your SAP Fiori launchpad settings. To
use the new entry page, as an administrator, you rst have to set the following parameters to true:

SPACES

SPACES_MYHOME

SPACES_CUSTOM_HOME

For more information about spaces and pages, see Best Practices for Managing Spaces and Pages and Manage Launchpad
Settings.

Administrator Settings

 Caution
The settings you can make as an administrator to precon gure the entry page, as described below, are part of an
experimental feature. Note that you can see functionality on the UI that is currently not supported. Clicking on buttons not
listed as available features has no effect.

Apart from the personalization that end users can perform, administrators can also precon gure the entry page.

As an administrator you can click Adapt UI from the User Actions Menu. The application reloads in the runtime adaptation
mode. The UI Adaptation mode is selected by default.

To perform the functions described here, you can click within the overlay of the page and select the Personalize My Home option
that pops up. From the subsequent My Home Settings dialog you can do the following:

You can modify the layout by changing the visibility and the position of the sections on the entry page.

You can con gure the visibility and the source of the news feed.

 Note

This is custom documentation. For more information, please visit the SAP Help Portal 15
4/9/2023
The news tile is displayed only if the news URL is from the same domain. Remote URLs can be displayed if the
con guration to send Cross-Origin Resource Sharing (CORS) headers is enabled. For more information, see Request
Fails Due to Same-Origin Policy (Cross-Origin Resource Sharing - CORS).

You can also assign icons and a prede ned set of colors to the spaces and pages based on your preference.

Upon making these changes, you must click Save. To activate all the saved changes, click the magic wand icon present on the
toolbar at the top. A new version is created every time any changes are made by the administrator. You, as an administrator,
must select the right version and activate it.

My Home (deprecated)
My Home is your personal space and page, where you can add your preferred apps.

 Note
This feature is deprecated and will be removed in a future version of SAP S/4HANA Cloud. It is not available for customers
starting to use SAP S/4HANA Cloud from version 2302 on.

On My Home you can for example show the apps you use frequently, or apps that you quickly want to access but which are not
on your assigned pages. You can also add bookmark tiles here.

Example of My Home for a purchaser

My Home is only shown when you work with Spaces and Pages, and it can be disabled by your administrator. If you don’t want to
work with My Home, you can disable it yourself in the User Settings (see Managing Your Settings). When My Home is active, it is
always shown as the rst space in the navigation bar. When you click on Home in the shell bar, you return to My Home.

When you rst open My Home, it is empty. Depending on your prerequisites, you have three or four options to add your apps:

Import personalized content from the classic home page. Read Importing Apps and Personalizations from the Classic
Home Page to My Home (deprecated) to learn when this option is available and how to use it.

Edit My Home and add apps. This works the same way as editing any page and is described in Personalizing a Page.

This is custom documentation. For more information, please visit the SAP Help Portal 16
4/9/2023
Select a page and add one or more apps from this page to My Home. Open the page, select Edit Current Page in the
user actions menu. Then select the option Add to My Home in the tile context menu ().

Adding apps from any page to My Home is also possible when personalization is disabled by your administrator. Go to the
page, open the user actions menu and select Add Tiles to My Home. Then open the context menu of the app you want to
add to My Home and select Add to My Home. See Personalizing a Page for more information.

Add apps with the bookmarking options (see Share Apps and Create Bookmarks for Apps)

 Tip
When all options are available, you can start by importing your personalized content from the classic home page and then
add speci c other apps. SAP suggests that you only import your most important apps to get a rather lean page.

When you structure your page, focus on these most important apps as you probably have the apps for your daily work
already assigned to your pages. Also read Best Practices for Managing Spaces and Pages for tips on how to structure your
page.

Home Page (deprecated)


The SAP Fiori launchpad home page is one of the entry pages for the launchpad - it's where you access your SAP Fiori apps.

What will I see on my home page?


The home page is your starting point. It's the main area where you work and where tiles or links, representing the apps you work
with, are clustered into groups. When you rst log on to the launchpad, you'll see the apps and groups that have been
precon gured for you. The launchpad is role-based so you see only those groups, tiles, and links that are assigned to your role.

 Note
This feature is deprecated and will be removed in a future version of SAP S/4HANA Cloud. It is not available for customers
starting to use SAP S/4HANA Cloud from version 2302 on.

On top of the groups the Featured Group is displayed if it is enabled by your administrator. This is a locked group showing two
lists with your recent activities and frequently used apps. See section Working with Recent Activities and Frequently Used Apps
for information, what apps or activities are shown in the lists.

What you see on the home page may also change depending on the device that you are using. For example, if you are using a
mobile device, you won't see apps on your launchpad that do not support mobile devices.

Navigate within the home page and to other areas in the launchpad
The groups by which your tiles and links are clustered are listed in the group selection bar at the top of the home page. Use this
bar to quickly navigate to groups of apps.

This is custom documentation. For more information, please visit the SAP Help Portal 17
4/9/2023

A sample home page of the SAP Fiori launchpad, showing the group selection bar just below the shell bar, and apps displayed as tiles that are
assigned to the selected group

Depending on how the launchpad is con gured, you may see the content of all of your groups on the home page at once, or only
one group at a time.

If the former option is con gured, the group selection bar behaves as an anchor bar; in other words, choosing a group in
the bar scrolls the page to that group.

If the latter option is con gured, the group selection bar behaves as a tab bar; in other words, choosing a group displays
the content of the selected group.

 Tip
You might be able to switch between these two display options. For more information, see Managing Your Settings.

For information about navigation, see Navigating Within and Between Apps.

Related Information
Shell and Shell Bar
User Actions Menu
App Finder

Tiles, Links and Tile Sizes


Tiles can be displayed in different sizes in the SAP Fiori launchpad.

In general, tiles are shown as square tiles or links. When you work with spaces and pages, two additional tile sizes are supported.
By choosing a larger tile size, you e.g. display more information at a glance.

The following tile sizes are available:

Tile: 2x2 square tile (supported on page and home page)

Flat tile: 2x1 (supported only on a page)

Flat wide tile: 4x1 (supported only on a page)

Wide tile: 4x2 , e.g. a smart KPI tile (supported on page and home page)

Custom tiles: de ned by customers; have a speci c tile size, not always available (supported on page and home page)

Links: small tiles showing only the title and subtitle, e.g. for a compact layout (supported on page and home page)

This is custom documentation. For more information, please visit the SAP Help Portal 18
4/9/2023

In general, there is a speci c tile order within one section: Tiles of the same height are shown in the same row or several rows
directly one below the other. Tiles in standard size are shown rst, at and at wide tiles are shown below the standard-sized
tiles. Links are always shown below the tiles.

When you move a tile to another row with tiles in a different size, this will change the tile size. How to change the tile size is
described in Personalizing a Page in detail.

User Actions Menu


The user actions menu offers user-related options e.g. to open apps, to change the launchpad layout or to contact support.

To open the user actions menu, click your pro le picture, your initials (e.g. ) or the  (User Actions Menu) icon

located at the top right corner of the shell header. Your pro le picture appears only if SAP Jam integration is enabled and you
have uploaded a picture in SAP Jam.

What can I do in the User Actions Menu?

This is custom documentation. For more information, please visit the SAP Help Portal 19
4/9/2023

 Note
Some options listed here are available only if available on your platform. Some of the options that are usually in the user
actions menu might be shown in the shell header instead.

The menu gives you direct access to the following features. At the top of the menu you can see your user name.

Feature Description

Displays a Quick Access dialog with an interactive history of the items you have searched for in Enterprise Search

 and worked with recently. The apps or objects are listed chronologically.

When you have disabled the user activity tracking, this menu item is not shown.
Recent Activities
For more information, see Managing Your Settings.

Displays the apps you have searched for in Enterprise Search and used most frequently over the last 30 days. Only

 days working in the launchpad are counted. The apps are listed in order of usage frequency with the most used listed
rst. An app must be used at least twice to appear in the list.
Frequently Used
When you have disabled the user activity tracking, this menu item is not shown.

For more information, see Managing Your Settings.

A convenient tool for nding apps and adding them to your launchpad.

 For more information, see App Finder and Adding Apps to the Home Page (deprecated). If you work with spaces and
pages, the options are different. See Adding Apps to a Page for detailed information.
App Finder

This is custom documentation. For more information, please visit the SAP Help Portal 20
4/9/2023

Feature Description

A central area where you can view and maintain the settings for your launchpad.

 For more information, see Managing Your Settings.

Settings

Enables you to access the home page in edit mode so that you can organize your launchpad to suit your daily tasks.

 Once you have completed your editing, exit edit mode by clicking Done at the bottom of the home page or clicking
Exit Edit Mode in the user actions menu.
Edit Home Page
For more information, see Personalizing the Home Page (deprecated).

  Note
This option is only available if you work with spaces and pages, and if your administrator has enabled the
Edit Current Page personalization option. See Spaces and Pages for details.

Enables you to access the currently shown page in edit mode so that you can organize your launchpad to suit your
daily tasks. Once you have completed your editing, exit edit mode by clicking Done at the bottom of the page or
clicking Exit Edit Mode in the user actions menu.

For more information, see Adding Apps to a Page.

  Note
This option is only available if you work with spaces and pages, and have My Home acitvated, and if your
Edit My Home administrator has disabled the personalization option. When personalization is enabled, My home can be edited
when displayed with the option Edit Current Page. Also see Spaces and Pages for details.

Enables you to access your personal My Home in edit mode so that you can organize My Home to suit your daily
tasks. Once you have completed your editing, exit edit mode by clicking Done at the bottom of the page or clicking
Exit Edit Mode in the user actions menu.

For more information, see My Home (deprecated) and Adding Apps to a Page.

Allows you to contact support directly from the launchpad.

 For more information, see Contacting Support.

Contact Support

You can personalize an object page used in your app by adding, removing or rearranging sections. This is an

 experimental feature.

For more information, see Personalizing Object Pages (Experimental).


Personalize App

With key user adaptation, you can change the user interface of SAP Fiori apps directly in the launchpad, intuitively

 and without having to write new code.

For more information, see Adapting SAP Fiori UIs at Runtime - Key User Adaptation.
Adapt UI

 Display information for a speci c app and the launchpad.

Info For more information, see Information About App and Launchpad Version.

 Use this option to control what should happen with the data you entered in an app. When the history setting is
enabled by your administrator, an app may save the last ve values you have entered (only for supported apps). You
Input History
can enable or disable the value history with the option Track history of recently entered values. You can also delete
Settings
your history of saved values by clicking on Clear. Save your changes.

This is custom documentation. For more information, please visit the SAP Help Portal 21
4/9/2023

Feature Description

 Use this option to view the sessions that are associated with your user and that contain locks in SAP GUI or SAP Fiori
launchpad. If a session is blocking one of your apps, you can delete it in the My User Sessions area.
My User Sessions

 Caution
Please note that it is not possible to delete sessions that are related to drafts.

 Use this option to end your session in the launchpad.

Sign Out For more information, see Signing In and Signing Out.

App Finder
The app nder is a convenient tool for nding apps, all in one place, and then adding them to your home page or to one of the
pages.

The app nder lists all the apps available for your role that you may potentially use in your daily work. You can access the app
nder from the User Actions Menu.

When you work with pages in the spaces mode, the handling is slightly different as you may have several pages assigned. We will
show the differences below. See Entry Page for more information.

What can I do with the apps in the app nder?


In the app nder, each app displays one of the following icons:

Icon Description

Indicates that the app has not yet been added to any group

Add tile to groups

Indicates that the app is already assigned to at least one group or page (if you work in spaces mode).
You can click it to add the app to more groups or pages or to change the app's group assignment.

Add tile to additional groups or


remove from a group.

 Add Indicates that the app has not yet been added to any page. Is displayed if you work in spaces mode.

Add tile to a page

 Add Indicates that the app is already assigned to at least one page if you work in spaces mode. You can
click it to add the app to more pages or to change the app's page assignment.
Add tile to additional pages or
remove from a page.

The handling differs depending if you work with the home page or spaces and pages:

When you click these icons, a dialog box opens with a list of groups in your home page. You can select one of the groups or
create a new group and add the app to it. For more information about using the app nder in the home page, see Adding Apps
to the Home Page (deprecated).

This is custom documentation. For more information, please visit the SAP Help Portal 22
4/9/2023
When you work in spaces mode, a list of the available spaces and the contained pages is shown. Select one or more pages. The
app is added to a special section in the selected page: the Recently Added Apps. This section is shown as rst section. It
contains the apps you have added to the page with the app nder or as a bookmark. This is a locked section, so you can only
drag apps from here to other sections but no apps to this section. When the section is empty, it will be deleted automatically.
When you return to the page, you can drag the app to your preferred section. See Adding Apps to a Page.

Using the Launchpad


End users use the launchpad to launch their SAP Fiori apps. They can also add more apps to their home page, adapt the user
interface, and change the look and feel of their launchpad to suit their work environment.

What can you do in the launchpad?


Hover over each area for details about what you can do in the launchpad, click highlighted areas for more information.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

This is custom documentation. For more information, please visit the SAP Help Portal 23
4/9/2023

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

Signing In and Signing Out


When you want to work with the launchpad you have to be signed in.

When you open the launchpad URL, you are usually either signed in automatically via single-sign on or a sign-in screen is
displayed. There you enter your user name and your password for the launchpad. You get user name and password from your
adminstrator. Depending on your system con guration you can select other settings for start-up, e.g. the language.

After you have nished your work you should sign-off. Select Sign Out in the user actions menu. After sign-out a sign-out page or
the start page is displayed.

Automatic Sign-Out when Inactive


For security reasons usually a time for automatic sign-out is set. Your adminstrator can de ne the time, when the sign-out
should happen. When you have not been active in the system for this time, you are automatically signed out.

It can be con gured that a few minutes before this timeout, a warning is displayed, informing you that you will be signed out
soon. You can choose to stay signed in (this resets the timeout), or sign-out directly.

This warning is also shown, if you have switched to a different browser tab or minimzed the browser. The rst time the warning
should be shown in this case, you need to allow that the launchpad may show noti cations in the browser. Note that this feature
is not supported on mobile devices or in the Microsoft Internet Explorer.

This is custom documentation. For more information, please visit the SAP Help Portal 24
4/9/2023

Working with Recent Activities and Frequently Used Apps


Find your most used apps or open a recently used function in the Quick Access Dialog.

To access the lists, open the user actions menu and click Recent Activities. The Quick Access dialog shows you lists of your most
used apps and the last functions you have used in the launchpad. Each list displays a maximum of 30 items. You can directly
navigate to any of these apps or objects by clicking them.

 Note
This functionality is only available when you have enabled the track user activities options. For more information, see
Managing Your Settings.

Recent Activities
You see an interactive history of the items you have searched for in Enterprise Search and worked with recently. The apps or
objects are listed chronologically.

 Note
Apps and objects are only added to the Recent Activities list if you close them using the Home button or the back navigation
button.

This is custom documentation. For more information, please visit the SAP Help Portal 25
4/9/2023

Frequently Used Apps


Select Frequently Used in the user actions menu or select the second tab in the Quick Access dialog. The dialog displays the
apps you have searched for in Enterprise Search and opened or the apps used most frequently over the last 30 days. Only days
working in the launchpad are counted. The apps are listed in order of usage frequency with the most used listed rst. An app
must be used at least twice to appear in the list.

 Note
You can clear the history or stop tracking your user activity at any time in the Settings dialog box.

Searching for Business Objects and Apps


Search for business objects and apps, lter and save the search results.

 Note
To locate business objects using the search bar, Enterprise Search must be integrated and set up in your environment.
Otherwise, the search returns apps that are located only in your home page and the catalog. The search result list contains
all the business objects and apps you are authorized for. For example, you will nd all the apps that you have access to via
the business catalogs and business roles.

The search function is embedded in the shell bar. You start searching by clicking on  Search in the top right corner of the
launchpad.

First you may lter what kind of results you want to see by choosing one of the shown options on the left of the search bar or
selecting All.

Search Operators
For writing in the search bar you can use the following operators:

Operator Example Description

None shares warrants Finds results that contain both the word
“shares” and the word “warrants”.

OR shares OR warrants Finds results that contain either the word


“shares” or the word “warrants”.

* warr* Finds results containing words that start


with “warr”, for example “warrants”,
“warranty”, and “warranted”.

- shares - warrants Finds results that contain the word "shares"


but not the word "warrants".

"" "with best regards" Finds results that contain the exact phrase
“with best regards”.

If you can't nd the expected results try again using *, for example *12345 or *john*.

The search is case-insensitive.

This is custom documentation. For more information, please visit the SAP Help Portal 26
4/9/2023

Navigating in the Results


The result list is sorted by relevance automatically, which is calculated based on the following factors:

Weights of attributes, for example, a hit in the surname is ranked higher than a hit in the rst name.

Number of hits within an object (proportional to the text length and frequency of other words).

Once the search results are shown, several icons in the top right appear, that enable you to work with the search results.

 Export Results: By clicking on this icon you can download all of your search results (or the rst 1000, if there are more than
that) as a comma-seperated text le with an .xlsx extension which will open in the assigned application.

 Sort: You can choose the sort order to either be ascending or descending and also by which of the listed information you
would like to sort (e.g.: as best match, bussiness partner role, phone number). The sort options will be processed as soon as you
click Okay. Via Reset you will get to default settings.

 Share: You can save the search settings as tile or so called apps, which will then be pinned on your entry page or send them
via e-mail. If you choose to  Save as Tile, you can insert a Title, a Subtitle, a Description and assign it to a Group. This app will
then be pinned as tile to your Home Screen. For more information see Adding Apps to the Home Page (deprecated) or
Personalizing the Home Page (deprecated). If you chose to send the search results via mail your e-mail application will open up
and you only have to ll in the address of the recipient.

   Choose Display: The search results can be displayed as  List,  Table or  Map.

For each result you can decide to show more details  or hide them .

If your search results show employees, you can directly call or e-mail them by clicking on the dedicated information or click on
the name to show their address on online map services.

Filtering Search Results


You can further lter the results shown by clicking  Show lters in the top left. A panel on the left side of your search results
opens, which shows different lter possibilities depending on your search request. You can scroll through this panel and select
and deselect multiple lters.

For some lter aspects you can toggle between  Display as: Pie Chart,  Display as: Bar Chart and  Display as: List.

You reset all lters by clicking on  Reset Filters in the upper right part of the lter panel.

By clicking on the button Show More, you open a different view of the lter possibilities. The window that pops up contains the
same icons and lters as the panel, but also additional lter features:

De ne Conditions lets you add one or more precise lter conditions by selecting Equal to, Begins with, Ends with or
Contains and inserting letters or even whole words.

You can add another condition by clicking on  Add and delete an existing condition by clicking on  Remove next to the
condition that you wish to delete.

Filtering by Company Names

This is custom documentation. For more information, please visit the SAP Help Portal 27
4/9/2023

 Note
For this example the search results would show all Company Names, that start with an a .

Personalized Search
By clicking on  Account in the top right corner under  Settings you can decide what you want to happen with your
search activity.

Under  User Activities you can turn the tracking of your recent activities and frequently used apps on and off as well as
clear the search history.

Under  User Pro ling you can toggle between allowing personalized search or not.

 Note
 Settings also gives you Quick Access to  Recent Activities and  Frequently Used. For more information see Working
with Recent Activities and Frequently Used Apps.

Other Features
You can also use the App Finder to nd all your SAP Fiori, SAP GUI, and Web Dynpro ABAP apps, and then add them to your
home page. For more information, see App Finder and Adding Apps to the Home Page (deprecated).

You can also use the All My Apps navigation option to quickly access your home page groups and apps assigned to catalogs,
from anywhere in the launchpad. For more information, see Navigating Within and Between Apps.

You can personalize the launchpad, see Personalizing the Launchpad.

Navigating Within and Between Apps


End users can easily navigate in the launchpad between apps and within apps.

SAP Fiori launchpad offers different navigation possibilities:

Navigate within apps using hierarchy navigation.

This is custom documentation. For more information, please visit the SAP Help Portal 28
4/9/2023
Navigate between apps from various points in the launchpad.

 Note
Some of these options may not be available to you. This varies according to the platform you are using and the features that
are enabled.

Navigating within an app


Once you've launched an app you can navigate within the app itself using a convenient hierarchical navigation menu. To get to
the navigation menu, simply click the app's title in the shell bar.

You will see a history of your recent steps in the context of the current app that lead you to the current view. The rst entry in
the hierarchical menu is always Home, and as you continue navigating to different views within the app, more entries are added
to the top of the navigation path. When you work with spaces and pages, the page and space name on that you have opened the
app are shown as second entry in the menu.

Navigating between apps


There are various ways that you can navigate between apps:

Navigation option More information

Related Apps Located below the hierarchical navigation menu shown above.

Navigate to apps and objects that are closely related to the current app.

This is custom documentation. For more information, please visit the SAP Help Portal 29
4/9/2023

Navigation option More information

All My Apps Located in the hierarchical context menu of the shell bar when navigating within an app.

Use the All My Apps navigation option to quickly access any of your role-based apps from anywhere in
the launchpad, without having to open and scroll through the page. It is especially useful if you work
with a large number of apps because it allows you to reach apps assigned to catalogs without rst
adding the apps to your home page or page if you work with spaces and pages.

To access it:

When you are navigating within an app, click the app's title in the middle of the shell header,
and then click All My Apps at the bottom of the hierarchical navigation menu.

When you are in the home page, click Home  in the middle of the shell bar. Since there is no
hierarchical navigation menu when you are in the home page, All My Apps is opened
immediately.

Click the structured entries to drill down into the content assigned to your home page or pages if you
work with pages and spaces and catalogs. For example, the Home Page Apps entry provides you with
quick access to your home page groups. Your assigned catalogs are listed below the Home Page Apps
entry.

Recent Activities list Located in the user actions menu.

Click any app to navigate quickly to apps or objects that you recently worked with.

Frequently Used list Located in the user actions menu.

Click any app to navigate quickly to apps or objects that you use often.

 (Back) Located on the left of the shell bar.

Use it to navigate to the previous app (or object) that you opened.

Working with Noti cations


SAP Fiori launchpad provides a Noti cations window that lets you know about important tasks and requests requiring your
timely action or knowledge. They allow you to view immediate updates on the latest and most important events that are related
to your business role.

The launchpad consumes noti cations from the noti cation channel. The noti cation channel is a backend component that
aggregates noti cations from the different noti cation providers con gured in your environment. For some noti cation types
you can select to receive noti cations also on a mobile device or as e-mails.

How do I view my noti cations?

Click the  (Noti cations) icon on the right-hand side of the shell bar.

This is custom documentation. For more information, please visit the SAP Help Portal 30
4/9/2023

Notifications icon in the shell bar and the Notifications window

 Tip
The noti cations icon in the shell bar also shows a badge with the number of new noti cations you have received since you
last opened the Noti cations window. This number resets when you open the Noti cations window.

If you receive new noti cations while you have the Noti cations window open, the badge on the noti cations icon updates to
show you how many new noti cations you have received.

A popup alert noti es you when you receive a high-priority noti cation while you are working in an application or the app nder.

What can I see in the Noti cations window?


The Noti cations window lists all the noti cations that are relevant to you and your business role. The type of noti cations you
receive also depends on which noti cation providers and channels are con gured for you.In addition, you can choose yourself
which noti cation types you want to see in your Noti cations window.

This is custom documentation. For more information, please visit the SAP Help Portal 31
4/9/2023
The content displayed in each noti cation depends on the type of noti cation and how the noti cation channel is
con gured. Typically a noti cation shows a short description, the name of the requester or sender, and a timestamp.

Noti cations that require your action display buttons that allow you to quickly process the noti cation.

By default, your noti cations are sorted by date from newest to oldest (newest at the top).

Noti cations are color-coded according to their level of priority (green=low priority, orange=medium priority, and
red=high priority).

Unread noti cations are displayed in bold text.

What can I do in the Noti cations window?

Sort the noti cations At the top of the Noti cations window, choose By Date, By Type, or By Priority.

 Tip
Choose By Date again to toggle the sort order between ascending to descending, and back again.

Open the noti cation's Click on the noti cation. This opens the referenced business object in a SAP Fiori app that is
corresponding application con gured for the noti cation.

Process or take action on a Click the relevant action button displayed with each noti cation. If the action is successful, the
noti cation noti cation is removed from the Noti cations window.

 Tip
You can process all noti cations of the same type together by rst sorting the noti cations by type.

 Note
In some cases, certain noti cations are agged in a way that they remain displayed in your
Noti cations window even after you have processed the noti cation.

Close a noti cation Click the noti cation's  (Close) icon.

 Remember
Closing a noti cation that is expecting an action from you will dismiss the noti cation without
taking any form of action.

Which noti cation settings can I personalize?


In your Settings, you can personalize the following noti cation preferences:

Choose the noti cation types you want to see in your Noti cations window. For example, if you prefer not to see any
leave requests in the noti cations window, you can turn them off.

Choose whether or not to be noti ed by a popup alert whenever you receive a high-priority noti cation.

Set speci c noti cation types to always be agged as high priority noti cations, regardless of the default priority level
determined by the backend system.

Specify which noti cation types trigger native noti cations on your mobile device.

Specify which noti cation types trigger an additional e-mail.

For more information, see Setting Noti cation Preferences.

This is custom documentation. For more information, please visit the SAP Help Portal 32
4/9/2023

Working with the Digital Assistant


SAP offers a contextual collaboration tool that sits on top of SAP Fiori-based apps, for example SAP CoPilot or SAP
Conversational AI. Depending on which digital assistant is integrated, it is possible to gather and create artifacts such as notes,
screenshots, and objects and place them in ad hoc collections, all in the context of the app that you are working in.

The digital assistant is triggered with the  (Digital Assistant) icon in the SAP Fiori launchpad shell bar. The tooltip shows you
which tool is integrated in your system.

For information about SAP CoPilot key functionalities, refer to the SAP CoPilot User Guide. If you have integrated SAP
Conversational AI, see the respective application help.

Working with Built-In Support


Built-In Support provides an embedded and intuitive support experience, which is accessible in the SAP Fiori launchpad shell bar.

With various functions, such as searching for information in the SAP Support Knowledge Base, incident management, and
collaborating with SAP support experts for real-time conversations, it simpli es customer interaction with SAP support.

The Built-In Support UI can be accessed by clicking the  icon in the SAP Fiori launchpad shell bar. It provides public access to
content through search and recommended documentation. For accessing gated content, which requires an S-user or P-user, the
authentication and authorization are achieved through the integration of SAP Universal ID.

This is custom documentation. For more information, please visit the SAP Help Portal 33
4/9/2023

Start-up and settings dialog for Built-In Support

To access more support options and nd more information, go to the Built-In Support page.

Working With SAP Mobile Cards


SAP Mobile Cards is an application that allows you to share content from SAP Fiori-based applications from your desktop
computer's SAP Fiori launchpad to your Android phone or iPhone, which provides "any time from anywhere" access to the most
up-to-date business data available.

Here's what needs to happen before you can use SAP Mobile Cards:

This is custom documentation. For more information, please visit the SAP Help Portal 34
4/9/2023
You need to download the application from the Google Play Store (Android) or the Apple App Store (iOS).

Your system administrator must complete the required back-end con guration.

You or your system administrator must con gure the SAP Mobile Cards application for use on your device. See
"Registering the Application" in the User Guide (link below) for more information.

Once SAP Mobile Cards is con gured, you can begin sharing content from your SAP Fiori launchpad to the application on your
mobile device.

To add a card to the card deck:

1. Launch an application that supports SAP Mobile Cards. If you aren't sure which apps are supported, please contact your
system administrator.

2. Select the content you want to add to the application on your mobile device.

3. In the top-right of the shell bar of the launchpad, select , then select Add to Mobile. When you see "Successfully added
Card", it means the content has been added to your mobile device.

 Note
To share content from Overview applications, select an overview app, then select Add to Mobile, then choose the
content from the overview app that you want to share to your mobile device.

For more information about using SAP Mobile Cards, see SAP Mobile Cards for Android User Guide or SAP Mobile Cards for iOS
User Guide.

Contacting Support
End users can contact support from the launchpad.

Prerequisites
To receive support, SAP Solution Manager must be part of the system landscape.

Context
When the feature for contacting support is active, technical information, such as navigation data, errors, user details, and
server details, is collected while you work. If you choose to contact support, from the user actions menu or from an error
message, you can enter a free text to describe the problem. The free text and the technical data are used to create a support
ticket (for example an incident in SAP Solution Manager).

Procedure
1. In the user actions menu, select Contact Support; or in an error message, choose the Contact Support button.

2. Enter a short summary of your issue in the eld Subject and add a more detailed description of the problem in the eld
Description.

Choose Show Technical Data to view some of the technical data that will be appended to the ticket. You can see further
installation information in the About dialog (for further information, see Information About App and Launchpad Version).

3. Choose Send to create the support ticket (for example, an incident in SAP Solution Manager).

Related Information
This is custom documentation. For more information, please visit the SAP Help Portal 35
4/9/2023
User Actions Menu

Information About App and Launchpad Version


Display information for a speci c app and the launchpad.

Click on About in the user actions menu.

About dialog with technical information about app and launchpad

You see a dialog showing technical information for the selected app, the system and the environment. The information is mostly
used for support. The gure shows example information for the Create Purchase Requisition app. For other apps, different elds
may be displayed. A eld is not shown if no information is available.

Field Description

Application

Title App title

Technical Component ID Technical name of the opened app

This is custom documentation. For more information, please visit the SAP Help Portal 36
4/9/2023

Field Description

Component Application component (ACH) of the opened app

Framework ID Framework ID on that the opened app is based on (e.g. SAPUI5, SAP GUI etc.)

Framework Version Framework version on that the opened app is based on

Version Version of the opened app

System

Product Version Version of the used product, e.g. the SAP NetWeaver version.

Product Name Name of the used product

System Role Shows the system in which the launchpad runs (e.g. test or production)

Tenant Role Shows the role of the tenant in the system in which the launchpad runs (e.g. production or test client).

Environment

Device Type Device type of the used device

Touch Input Supported Indicates if the app supports touch input.

Optimized for Touch Input Indicates if the app is optimized for touch input.

Theme Shows which theme is currently selected for the launchpad.

User Agent Information on the used browser.

Usability Features in the Launchpad


SAP Fiori launchpad includes usability features, such as keyboard-only navigation, screen reader support, and high contrast
themes to assist you while working in the launchpad. Users seeking information about accessibility may also nd some valuable
information here.

Related Information
Keyboard Navigation in the Home Page
Adapting the Home Page with the Keyboard
Screen Reader Support in the Launchpad
Themes
Adapting a Page with the Keyboard

Keyboard Navigation in the Home Page


To navigate in the launchpad using the keyboard instead of the mouse, you use a combination of the Shift , F6 , and Tab keys.

Navigation Flow

The forward navigation of the F6 ow is: First clickable icon in shell bar Currently selected group in group selection
bar on the home page Last visited tile Close button (only in edit mode) First clickable icon in shell bar

This is custom documentation. For more information, please visit the SAP Help Portal 37
4/9/2023

F6 Action Flow

Pressing Shift + F6 reverses this ow. The rst clickable item can be for example the SAP logo, a company logo or the
Back button.

The forward navigation of the Tab ow is: Browser elds (for example tab or navigation bar) First icon in shell bar
Last selected group in the group selection bar on the home page Over ow icon in the group selection bar (if
displayed) Last visited tile Browser eld .

Tab Action Flow (when home page is in view mode)

You may need to rst press Enter or the Spacebar to open or display the selected user interface element.

The sections that follow describe how you navigate inside these launchpad elements with the keyboard.

Navigating in the Home Page

The home page displays groups of tiles and links. When you rst open your launchpad, the rst tile on your home page is in
focus. You can navigate between the tiles and groups using your keyboard as follows:

Keys Behavior

Left arrow , Right arrow, Up arrow and Navigate between tiles.


Down arrow

Home Navigate to the rst tile in the same group.

End Navigate to the last tile in the same group.

Page down Navigate from any tile in a group to the rst tile in the next group.

Page up Navigate from any tile in a group to the rst tile in the previous group.

Home and Ctrl Navigate to the rst tile in the rst group.

End and Ctrl Navigate to the last tile of the last group.

Enter or Spacebar Launch the selected tile.

Navigating in the Group Selection Bar

Apps are clustered in groups on the home page. The bar at the top of the home page displays quick links to all of your groups.
Depending on how your administrator has con gured the bar, it may behave as an anchor bar or a tab bar.

This is custom documentation. For more information, please visit the SAP Help Portal 38
4/9/2023

Example of the group selection bar in the launchpad

Use your keyboard as follows to navigate within the group selection bar:

Keys Behavior

Enter or Spacebar Select the group in the group selection bar. When you press the key, the focus is on the rst
tile in the group.

Tab or F6 Navigate from the group selection bar to the tiles area. The focus is on the rst tile in the
group.

Navigation in the Home Page Edit Mode

When you have opened the Home Page in edit mode, you can also navigate with F6 and Tab . The navigation with F6 has the
following ow:

Currently selected group in group selection bar on the home page Last visited tile First clickable icon in shell bar
Currently selected group in group selection bar Last visited tile Close button First clickable icon in shell bar

It is the same as in the home page view with an additional step for the Close button (see image above).

The navigation with Tab has the following steps:

Browser tab Browser navigation bar First clickable icon in shell bar Next icon in shell bar Currently selected group in
group selection bar on the home page Group Title Reset button or Delete button (if available) First tile in group Next
tile Add Group button Next group title etc. Close button Tab icon in browser header bar

Keyboard Shortcut: F2 (only in a group title in edit mode): Enter new group title. Enter con rms the title change; Esc
cancels the title change. Click Tab to con rm you action and move to the next element.

Related Information
Shell and Shell Bar
Home Page (deprecated)
User Actions Menu
App Finder

Keyboard Navigation with Spaces and Pages


To navigate in a launchpad page using the keyboard instead of the mouse, you use a combination of the Shift, F6, and Tab keys.

Navigation Flow
When you work with pages and spaces, navigation with F6 is: First clickable icon in shell bar Currently selected space in
the navigation bar Last visited tile First clickable icon in shell bar

This is custom documentation. For more information, please visit the SAP Help Portal 39
4/9/2023

Pressing Shift + F6 reverses this ow.

When you work with spaces and pages, the Tab navigation ow is: Browser elds (for example tab or navigation bar) First
icon in shell bar Next icons in shell bar Currently selected space in the navigation bar First tile in rst section First tile
in next section Browser eld

Pressing Shift + Tab reverses this ow.

Navigating when editing a page

When you edit a page, Tab navigation also includes the rst section header, the section title, and then the action buttons (Add
Tile,Show, Hide, Reset, or Delete, and Add Section). Before going back to the shell bar icons, the focus is set on the Close
button.

You may need to rst press Enter or the Spacebar to open or display the selected user interface element.

The sections that follow describe how you navigate inside these launchpad elements with the keyboard.

Navigating in the Page

The page displays sections with tiles. When you rst open your launchpad, the rst tile on your rst page is in focus. You can
navigate between the tiles and sections using your keyboard as follows:

Keys Behavior

Left arrow or Right arrow , Up arrow or Navigate between tiles in the same section.
Down arrow

Home Navigate to the rst tile in the same section.

End Navigate to the last tile in the same section.

Page down Navigate from any tile in a section to the rst tile in the next row or section.

Page up Navigate from any tile in a section to the rst tile in the previous row or section.

Home and Ctrl Navigate to the rst tile in the rst section.

End and Ctrl Navigate to the last tile of the last section.

This is custom documentation. For more information, please visit the SAP Help Portal 40
4/9/2023

Keys Behavior

Enter or Spacebar Launch the selected tile.

Keyboard Navigation in Noti cations and App Finder


Learn how to navigate in the Noti cations area and the app nder.

Navigating in the Noti cations Area

Use your keyboard as follows to navigate and use the Noti cations area (if it enabled in your system):

Keys Behavior

Tab Navigate between the elements in the Noti cations window in the following order:

1. By Date sort option

2. First or last selected noti cation or noti cation group

3. Close button in the selected noti cation or noti cation group

4. Action buttons, such as Approve and Deny, for the selected noti cation or
noti cation group

Left arrow or Right arrow Navigate between the sort options (By Date, By Type, By Priority) in the header bar of the
Noti cations area.

Enter or Spacebar Execute the selected sort option or press the selected button in a noti cation or
noti cation group.

When a noti cation is selected, pressing Enter opens the application related to the
noti cation.

Up arrow or Down arrow Navigate between the individual noti cations or noti cation groups.

 Tip
To move to the next or previous item in the list, the focus must be on the whole
noti cation item or group, not on one of its buttons.

Esc Close the noti cation window.

Navigating in the App Finder

Use your keyboard as follows to navigate in and use the app nder:

Keys Behavior

F1 Open the in-app help. The help carousel appears with help content or, additionally, further
information on how to nd help.

F6 Pressing F6 enables you to navigate in the app nder Catalog tab in the following order:

1. Catalog tab

2. First item on the left

3. First tile in the rst group

This is custom documentation. For more information, please visit the SAP Help Portal 41
4/9/2023

Keys Behavior

Pressing F6 enables you to navigate in the User Menu or SAP Menu tabs as follows:

1. User Menu or SAP Menu tabs

2. Select System dropdown list

3. First folder in the list on the left side of the screen

4. Title of rst folder

Tab Navigate from items in the left-hand column to the rst tile.

Navigate from an app to the  (Add tile) icon to add an app to a group.

Up arrow or Down arrow


Navigate between items in the left panel.

Navigate between apps.

Page Up or Page Down Move to the rst tile in the next group.

End or Home Move to the rst or last tile on the page.

Keyboard Shortcuts
You can use the following keyboard shortcuts in the launchpad.

Use Ctrl + F1 to view a popup window that lists the available keyboard shortcuts to quickly navigate to different areas in the
launchpad:

Keys Behavior

Alt + H Set the focus on either the logo or the home button.

Alt + A Set the focus on the app nder menu entry.

Ctrl + S Set the focus on the search bar in the app nder (works only when the app nder is
available, already open and the catalog search is enabled by the administrator).

Ctrl + Enter Save changes when editing the home page or the current page.

Alt + F Set the focus on the search icon.

Alt + M Set the focus on the user actions menu icon.

Alt + N Set the focus on the Noti cations menu entry.

Alt + S Set the focus on the Settings menu entry.

Ctrl + Comma Display the Settings dialog box.

Ctrl + Shift + F ( Cmd + Shift + Set the focus on the search entry eld.
F on Mac)

Adapting the Home Page with the Keyboard


You can move tiles or edit the layout of the home page using the keyboard.

This is custom documentation. For more information, please visit the SAP Help Portal 42
4/9/2023

 Note
Remember that you can't edit locked groups.

If you work with pages and spaces instead of the home page, see Adapting a Page with the Keyboard.

Moving Tiles or Links in the Home Page

You can can move a tile or a link to a new position. Set the focus on the tile or link, then press Ctrl and hold it. Use the left or
right arrow keys to move the tile or link to a new position in the group. Use the up or down arrow keys to move a tile or link to a
different group. It is possible to change a tile into a link by moving it into an available link section. You can also convert a link into
a tile.

Working in Edit Mode

You can edit the home page of your launchpad by choosing the Edit Home Page entry in the user actions menu. Once you have
completed your editing, exit the edit mode by choosing Close or choosing Exit Edit Mode in the user actions menu.

Keys Behavior

1. Click Alt + M to open the user actions menu. Switch the home page to edit mode.

2. Select the Edit Home Page entry in the user actions menu
with the arrow up or down key.

3. Press Enter or Spacebar .

The following actions apply only after you have switched to edit mode.

Add a new group.


1. Use the Up arrow or Down arrow until you get to the Add
Group button.

2. Press Enter or Spacebar .

Add a new tile.


1. In the group to which you want to add a new tile, select Add
Tile.

2. Press Enter .

Move tiles to another group.


1. Get to the tile you want to move.

2. Press Enter to open a list of options.

3. Use the Up arrow or Down arrow to get to the Move


option and press Enter .

4. Select the group to which you want to move the tile using
the Up arrow and Down arrow keys and then press
Enter .

Move tiles within a group.


1. Select the tile you want to move.

2. Use Ctrl + Up arrow or Ctrl + Down arrow to move  Note


the tile one row up or one row down. If the tile you are moving is at the beginning or or end of a group,
it moves to the previous or next group.
Or use Ctrl + Left arrow or Ctrl + Right arrow to
move the tile horizontally one position at a time.

This is custom documentation. For more information, please visit the SAP Help Portal 43
4/9/2023

Keys Behavior

Remove tiles from a group.


1. Select the tile that you want to remove from a group.

2. Press Delete .

Delete a group.
1. Navigate to the header of the group.

2. Press Tab until you get to the Delete button.

3. Press Spacebar or Enter to delete.

Rename a group.
1. Select the title of the group.

2. Press Tab until the text of the group name is in focus.

3. Press F2 to change the name.

Reset a group.
1. Select the title of the group.

2. Press Tab until you get to the Reset button.

3. Press Spacebar or Enter to reset the group.

Show or hide a group.


1. Select the title of the group.

2. Press Tab until you get to the Show or Hide buttons.

3. Press Spacebar or Enter .

Adapting a Page with the Keyboard


You can move tiles or edit the layout of the selected page using the keyboard.

 Note
This option is only available if you work with pages and spaces (see Entry Page for additional information). The spaces mode
does not support all features known from the home page, e.g there are no links or locked groups and tiles cannot be added in
Edit Mode, only with the app nder. If you work with the home page, see Adapting the Home Page with the Keyboard

Moving Tiles in a Page

You can move a tile or link to a new position. Set the focus on the tile or link, then press Ctrl and hold it. Use the left or right
arrow keys to move the tile or link to a new position in the section. Use the up or down arrow keys to move a tile or link to a
different section.

Working in Edit Mode

You can edit the currently shown page of your launchpad by choosing the Edit Current Page entry in the user actions menu.
Once you have completed your editing, exit the edit mode by choosing Close or choosing Exit Edit Mode in the user actions
menu.

1. Click Alt + M to open the user actions menu. Switch the home page to edit mode.

This is custom documentation. For more information, please visit the SAP Help Portal 44
4/9/2023
2. Select the Edit Current Page entry in the user actions menu
with the arrow up or down key.

3. Press Enter or Spacebar .

The following actions apply only after you have switched to edit mode.

Add a new section.


1. Use Tab until you get to the Add Section button.

2. Press Enter or Spacebar .

Move tiles to another section.


1. Get to the tile you want to move.

2. Press Enter to open a list of options.

3. Use the Up arrow or Down arrow to get to the Move


option and press Enter .

4. Select the group to which you want to move the tile using
the Up arrow and Down arrow keys and then press
Enter .

Move tiles within a section.


1. Select the tile you want to move.

2. Use Ctrl + Left arrow or Ctrl + Right arrow to move  Note


the tile horizontally one position at a time. If the tile you are moving is at the beginning or or end of a
section, it moves to the previous or next section.

Remove tiles from a section.


1. Select the tile that you want to remove from a section.

2. Press Delete .

Delete a section.
1. Navigate to the header of the section.

2. Press Tab until you get to the Delete Section button.

3. Press Spacebar or Enter to delete.

Reset a section.
1. Select the title of the section.

2. Press Tab until you get to the Reset button.

3. Press Spacebar or Enter to reset the section.

Show or hide a section.


1. Select the title of the section.

2. Press Tab until you get to the Show or Hide buttons.

3. Press Spacebar or Enter .

Screen Reader Support in the Launchpad


The screen reader reads out the contents of the user interface to you. Labels, headings, and descriptions help describe the
contents and visual elements of an application.

This is custom documentation. For more information, please visit the SAP Help Portal 45
4/9/2023
Screen reader support in SAP Fiori launchpad is based on built-in keyboard navigation and roles, and the names and states of
functional elements and areas. For example, in the launchpad the screen reader announces:

Menu options and how many there are.

Which tiles and which groups are in focus.

 Caution
Screen readers are 3rd party software not affiliated with or related to SAP products. SAP cannot grant that statements
about speci c behavior will always work with any combination of 3rd party software, or take responsibility for respective
issues in 3rd party software. Therefore, the descriptions in this topic serve only as a means for orientation and basic
information. SAP encourages all users to experiment with the most recent 3rd party software combinations that yield the
best result for their needs.

General Information

 Note
Before operating the launchpad with a screen reader, we recommend that you familiarize yourself with launchpad concepts
and structure.

Information about the launchpad areas and functional elements on a page is given in the following ways:

When focusing on an element using built-in keyboard navigation

With structural navigation using virtual navigation features of screen readers.

 Note
Virtual navigation is in-page navigation using special screen reader keys to read non-interactive page content such as
text and information about page structure and contained elements.

Some page content, such as plain page text and images, can only be accessed using virtual navigation.

Orientation
Use virtual modes (special screen reader modes for reading non-interactive page content) and landmark listings (lists of areas
that form the page structure) of screen readers to get an orientation of the hierarchical launchpad structure and the content of
the different areas. Some areas are only available for virtual cursor investigation (using special screen reader modes for
reading attributes of page content) when they are expanded using the respective launchpad buttons.

Identify and remember typical elements inside these areas (such as the rst named button, the rst element in a named list) to
help you access them later when you use the built-in keyboard navigation features.

 Note

Headings and their hierarchies (such as of tile groups and other regions) can be accessed using navigation by heading
features in virtual modes (hierarchy information such as paragraph or region heading levels)

Some pages are divided in subsections (such as regions and forms). Their names and hierarchies typically show up in
landmark listings of the page

Other elements show up in respective element listings (such as lists of buttons, lists of links)

This is custom documentation. For more information, please visit the SAP Help Portal 46
4/9/2023

Navigation and Interaction


We recommend that when using a screen reader you should navigate to, and operation functional elements in, non-virtual
modes. You may need to switch to virtual modes occasionally to access non-focusable page content.

There are three types of content in the different areas of the launchpad:

1. Focusable single elements such as buttons or input elds. Navigate between elements with the TAB key.

2. Focusable items in lists of elements such as the list of tile groups or list of tiles within a group. Navigate between
elements with the arrow keys.

3. Non-focusable single elements such as tile group headings, images, or additional text. Access using virtual cursor
functions.

There are also modal dialog boxes such as the Settings dialog box typically invoked as functions of respective buttons.

 Note

List items in the launchpad are typically active. Their activation triggers changes as part of the respective page or
opens up dialog boxes or new page areas.

Launchpad tiles are named active list items. Their activation triggers entire page changes by default.

Messages
Additional messages for users are announced in dialog boxes with respective titles and content. You may need to switch to
virtual mode to access non-focusable content in these dialog boxes. Short informational messages that do not require user
acknowledgment are announced automatically if the screen reader software can detect them.

Potential Issues
There can be con icts with the native keyboard bindings of screen readers and launchpad key bindings. In such cases, use
the key bypass functions of your screen reader to trigger the respective launchpad key bindings.

There may be unwanted automatic mode switching in screen readers while using the launchpad or apps. Make sure that
you detect these automatic mode changes and switch to non-virtual modes for correct keyboard navigation and
operation.

Virtual modes of screen readers may not be able to detect modal dialog boxes and the reading focus may escape from
the dialog box to the page background. If this happens, reopen the dialog box and listen to any indication of dialog box
boundaries when navigating in virtual mode.

Screen reader support in the launchpad is designed to work out of the box. Some important information for functions
may only be available in descriptions and tooltips of elements. Make sure that the respective features of the screen
readers are switched on, or that you can access them if needed.

If you encounter issues with screen reader speech output, make sure that:

You are using an updated combination of browser and screen reader.

If needed, any special support for screen readers is switched on in your browser.

No personalization, customization, or extra scripts that could in uence speech output are running.

Related Information
This is custom documentation. For more information, please visit the SAP Help Portal 47
4/9/2023
Using the Launchpad
Usability Features in the Launchpad

Themes
Various themes are prede ned to assist users with various color and vision preferences.

Usually, you can choose between the SAP default theme family Quartz (which supports dark and light settings), the SAP theme
family Horizon (supports dark and light settings in combination with high contrast), the SAP Belize themes in dark and light, or
the high-contrast themes High Contrast Black and High Contrast White. In addition, your administrator may provide a custom
theme, set a different default theme or restrict which themes are available for you.

Which themes are available, also depends on your personal system settings. When you have enabled the automatic dark mode
detection in the launchpad and use a Horizon or Quartz theme, a combined theme for light and dark theme is displayed. It is
called for example SAP Horizon. According to your color settings in your operating system, the light or the dark theme is used.
For example, when you have selected a Horizon theme and your color settings in your operating system are set to "dark", the
Horizon Evening theme is set. This also applies to the Horizon or Quartz High Contrast Dark and Light themes. For information
about changing the theme in SAP Fiori launchpad and the dark mode settings, see Managing Your Settings.

Related Information
Managing Your Settings

Personalizing and Adapting Apps


When running an app in the SAP Fiori launchpad, end users can personalize object pages and key users can adapt the user
interface for all users of the app (for example, a team lead can add a eld that's then available for all team members).

How can you personalize and adapt apps?


Hover over each area in the table for a description, click for more information.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

Adapting SAP Fiori UIs at Runtime - Key User Adaptation

This is custom documentation. For more information, please visit the SAP Help Portal 48
4/9/2023
With key user adaptation, you can change the user interface of SAP Fiori apps directly in the launchpad - intuitively and without
having to write new code.

Adapting SAP Fiori UIs can be this simple

Support special business cases, speed up work ows,


improve usability - there are many reasons why you may
want to adapt the user interface (UI) of your apps. With key
user adaptation, this couldn't be easier. It's highly intuitive
and requires no technical or programming skills. Just use
drag and drop or the context menu to make UI changes, for
example rearrange elds or groups, remove them or add
additional ones. Check out our overview video.

As opposed to personalization, the changes you make with


key user adaptation apply to the entire app and therefore to
all app users. You can even publish your UI changes as a
separate app, a so-called app variant, and make this app
variant available to other users. Open this video in a new window

Wait … What if I delete something important or even break the app?

Don't worry! Key user adaptation comes with a built-in safety net. It informs you whenever you're about to do something that's
worth double-checking, for example removing mandatory elds from the UI. You can also undo your changes and even discard
them all and reset the UI to the default app.

 Tip
Want to play around with a demo app and check out how key user adaptation works? Just open the SAPUI5 Demo Kit. On the
Demo Apps tab, choose one of the SAPUI5 Flexibility Demo Apps.

What are the requirements for using key user adaptation?

You run your SAPUI5 app on a desktop computer or laptop.

Your app is enabled for key user adaptation.

Your business role is authorized for the business catalog SAP_CORE_BC_EXT_FLEX.

You use the new FioriLaunchpad.html page.

If in doubt, simply open your app and check if your user actions menu contains the Adapt UI option. Also check Something Isn’t
Working like It Should?.

How do I start key user adaptation in an app?

This is custom documentation. For more information, please visit the SAP Help Portal 49
4/9/2023
Simply go to the user actions menu and choose Adapt UI.

Related Information
Adapting the UI
App Variants: All You Need to Know

Adapting the UI
When you are in the adaptation mode, you have many options to adapt the UI to your liking. You can also adapt and save certain
views.

Prerequisites
You have started the UI adaptation mode by choosing Adapt UI in the user actions menu.

Caution: Don’t mix systems or clients when you make UI changes

It’s possible that you distinguish between test and productive environments in your organization. When you adapt the UI of an
app, in this case it’s important that you make the UI changes only in the test environment and then transport or copy them to
your productive environment. For example:

Adapt the UI in the test system only and transport the changes to the productive system.

Adapt the UI in the test client only and copy the changes to the productive client.

This is custom documentation. For more information, please visit the SAP Help Portal 50
4/9/2023
Your productive system or client doesn't prevent you from making UI changes there, but it's important that you do not mix
these scenarios for one app (that is, making changes in both the test and the productive environment). This would lead to
severe UI adaptation con icts.

If you don't have or don't use a test system or client, please do everything in the productive environment.

Overview
Header Bar

Version history If the user interface of the current app has been adapted previously, you can switch to a recent
version or to the original app. Just click on the title of the current version to expand the version
history, then select a version from the dropdown list to display it.

See Drafts and Versioning.

Activate New Version Use  to activate the current draft or a selected version that is not currently active, so it
becomes a new version.

Discard Draft This option is only available when you display a draft that has not yet been activated.

Use  to discard all UI changes that you did in draft mode. You can then start adapting the UI
again, based on the last activated version.

Publish Version This option is only available when you display an unpublished version.

Use  to publish a version of a changed app or app variant to a target system. See Publishing
UI Changes and Publishing App Variants.

UI Adaptation and Navigation modes When UI Adaptation is activated, you can edit the current screen on which you started the
adaptation mode, but you cannot navigate using a button (for example, to another list item,
screen, or dialog box triggered by the button). To interrupt the adaptation mode and reach these
"hidden" elements, choose Navigation. Now you can navigate on the UI as usual, for example to
reveal other areas. Please note: Any changes you make while you're in the Navigation mode (for
example setting a lter) will not be saved later. So make sure you choose UI Adaptation again
before you make further changes that you want to preserve.

Visualization mode This highlights all or certain supported key user changes that have been made on the UI and are
part of the current UI. When you click on a highlighted change, you see details about all changes
made to this element, including a timestamp for when the changes were saved. When you're in
this mode, you will also see a dropdown list in the header bar that lets you lter for certain
change types. By default, you see All Changes. See Visualizing UI Changes.

Undo and Redo Use  to undo and  to redo the changes you made during your current session.

If you activate a new version, you cannot undo any changes that you did before activating the
new version.

Manage App Variants See Working with App Variants.

Save As This saves your UI changes as a new app variant, which you can then add as a new tile to your
SAP Fiori launchpad home page. See App Variants: All You Need to Know.

Save & Exit When you're done with your UI changes, use this option to exit the UI adaptation mode and
return to your running app or app variant. Unsaved UI changes are automatically saved to the
app or app variant from which you started the adaptation mode.

For the speci c kinds of changes you can make on the UI, check the subpages of this chapter.

This is custom documentation. For more information, please visit the SAP Help Portal 51
4/9/2023

Security
UI adaptation should not be used as a means to ful ll security requirements. UI changes affect only the visibility of the
respective elements on the UI. Example: If you remove a eld, it doesn't show up on the UI any longer. However, no other
security measures are applied that prevent a user from accessing the data associated with the removed eld. If you want to to
restrict access to certain data for security reasons, this has to be done in the back-end system via roles and authorizations.

Related Information
Drafts and Versioning
Publishing UI Changes
App Variants: All You Need to Know
Working with App Variants
Publishing App Variants
Something Isn’t Working like It Should?

Making UI Changes (Object Pages)


When you're in the adaptation mode of an object page, you can edit all UI elements (such as elds, groups of elds, or sections)
that get highlighted when you hover over or select them.

An object page is used to display and categorize all relevant information about an object.

 Note
Lots of change actions are available in UI adaptation. The possible actions depend on the type of UI element ( elds, groups,
sections, and so on) and the container that the UI element is part of.

Moving a UI Element

To move a UI element, just drag and drop it. When you drag a UI element, dashed boxes indicate where you can drop it. Drag the
element to its new location (indicated by a space) and drop it.

You can also cut and paste UI elements: Right-click the UI element and choose Cut from the context menu. The element gets
grayed out and a dashed box indicates where you can paste it. Right-click within the dashed box at the position where you want
to paste the cut element and choose Paste from the context menu.

Removing a UI Element

Select a UI element it and press Delete or choose Remove from the context menu. The element is then removed from the UI,
it's not permanently deleted from the app. You can add it again at any point within its original container. Exception: When you
delete a group of elds, the grouping information (group title and order of elds) gets lost, but the elds are still available and
can be added.

 Caution
Removing a eld does not prevent users from accessing the data associated with the eld. The eld is merely removed from
the UI and no other security measures are applied. If you want to implement security requirements to restrict access to
certain data, this has to be done in the back-end system.

Adding a UI Element

This is custom documentation. For more information, please visit the SAP Help Portal 52
4/9/2023
Right-click the UI element container where you want to add an element and choose Add from the context menu (for example,
Add: Field). Select the available elements that you want to add and choose OK. To add a new group, choose Create: Group from
the context menu.

 Note
If you want to add a eld, the list of available elds may vary depending on the context. This means that certain elds are
only available for certain object types but not for others.

You can also create a custom eld by choosing  in the dialogue for the available UI elements (SAP S/4HANA back end
required). To use the custom eld, you have to restart the app and the UI adaptation mode.

For more information about custom elds, see Custom Fields and Logic (please select the documentation version according to
your SAP S/4HANA Cloud version).

Renaming a UI Element

You can change editable text of a UI element. If you double-click it and the text (such as the title of a group of elds or a eld
label) gets highlighted, you can rename it. Just edit the text and press Enter . You can also right-click the element and choose
Rename from the context menu.

If you rename a UI element, the element will be visible under the new name in any language version of the app that you use.
Example: If you use an app in English and change the eld name Vendor to Supplier, this eld will also be visible as Supplier (in
English) in the Japanese version of the app.

To translate the renamed UI element for other language versions, your administrator needs to set up translation as described
here: Integrating Translation for UI5 Flexibility.

Combining and Splitting Fields

You can combine up to three elds so that they’re displayed in a single line. First, select a eld. Press and hold Ctrl while
selecting the other elds. Choose Combine from the context menu of one of the selected elds.

To split a combined eld, right-click it and choose Split from the context menu.

Changing Settings of UI Elements

If a UI element supports it, you can change its settings by right-clicking it and choosing Settings from the context menu. For
example, you can de ne the list of additional links that can be displayed in the popover of a link.

Resetting Changes

By choosing  (Discard Draft) in the header bar, you can discard all UI changes within the app and reset it to the last activated
version. This cannot be undone.

If the developers of your app have enabled this, you can also reset the UI changes made in certain parts (containers such as
certain tables or forms) of the UI without resetting the entire app. If this is enabled, you will see the Reset Container option
when you right-click a container. This option only resets the controls within this container.

Related Information
Something Isn’t Working like It Should?
Publishing UI Changes

This is custom documentation. For more information, please visit the SAP Help Portal 53
4/9/2023

Embedding Content (Object Pages)


You can embed content from external applications or websites to your object page app, for example, external videos or maps.
The content is then added to an iFrame.

Prerequisites
You have started the UI adaptation mode by choosing Adapt UI in the user actions menu.

Process
Adding Content

You can add external content to a header or as a section as follows:

1. Right-click an area where you want to embed external content, for example, a section. If you can add external content
there, you will see an Embed Content… context menu item. Depending on where you clicked, the menu item contains an
Embed Content: in Header and/or Embed Content: as Section part.

2. In the De ne Embedded Content dialog, specify the size of the new iFrame either as a percentage of the space that’s
available, in pixels, or in rem units.

3. Add the URL of the external content that you want to embed.

This could either be an absolute (full) URL or - if the embedded content is running on the same host as your app - a
relative (local) URL. With relative URLs, you start the URL with a forward slash and omit the host and port information.
This option is useful if the embedded content has the same path on different systems and only the host name is different
(for example if you have a quality system and a productive system).

Example for an absolute URL:

https://www.somewebsite.com/embed?more_URL_parameters

Example for a relative URL:

/images/image.png

 Note
There are some things that you have to keep in mind when you add the URL. For more information, see Things to
Watch Out For below.

4. You can now edit the URL manually or use the available values to add additional parameters to the URL of the embedded
content. The available values depend on the context of the area where you want to embed the content. You will only see
values that are exposed in the relevant context.

5. Choose Show Preview to preview the result. If the preview doesn’t show anything, check if the URL parameters are
correct. See also Things to Watch Out For below.

6. When you’re done, choose Save.

 Note
If you embed the content to a section, this creates a new section with the default title Embedded Content. You can rename
this section just like any other UI element.

This is custom documentation. For more information, please visit the SAP Help Portal 54
4/9/2023

Editing Embedded Content

If you want to change embedded content, right-click the content and choose Update Embedded Content to open the De ne
Embedded Content dialog.

Things to Watch out For


There are some things to keep in mind when you embed a URL:

Some websites let you generate special embedding HTML content for you to copy and paste. This HTML content
sometimes already contains iFrame information (<iframe src="...">...</iframe>). Since the iFrame will be
generated in UI adaptation mode, this prede ned iFrame information is not necessary. Only copy and paste the value of
the src attribute when you embed the URL. Otherwise, the preview will show a 404 error.

Example:

<iframe src="https://www.somewebsite.com/embed?more_URL_parameters" width="600" height="450" f

You only need the highlighted part.

Some technical restrictions of the target website or of the browser may prevent you from embedding it as an iFrame:

Some websites don’t allow embedding as iFrames at all, for example, if they use CSP or X-Frame-Options. If you
try to embed a URL of a website that restricts embedding, the preview will remain empty. If possible, contact the
web server administrator of the target website to ask if there is a way around this restriction.

Some websites use a frame busting mechanism. If you embed such a URL, the target website will not be displayed
in an iFrame. Instead, its content will try to take over the hosting parent, that is, your app. You may lose unsaved
data.

If authentication is required for the website you want to embed, the hosted site may use a login window or require
single sign-on. You can pass your current user information using parameters. If you want to authenticate the
same user, both websites must go through the same identity provider (IDP).

The browser may enforce security checks that prevent the embedded content from being loaded. Contact your IT
department to check if they can loosen these security checks within your organization.

Most browser show warnings or errors or will not load embedded content in case of "mixed content". Mixed
content occurs if you embed HTTP content to an HTTPS website (or vice versa). This is not recommended.

 Tip
If the server of the target website supports both HTTP and HTTPS, you can omit the protocol in the URL, for
example //somewebsite.com instead of http(s)://somewebsite.com. Your browser will then
automatically rst request the content with the HTTPS protocol, and if HTTPS is not available, it will request
the content with HTTP.

Special Characters (&, ", {...})

Under certain circumstances, you need to encode or escape special characters.

Embedding parameters: When you add values from the embedding context to the URL as parameters, you might
need to escape the values to generate a valid address. You can change the value description using an advanced
syntax.

Example: The current context provides the DocumentName eld, which contains characters like & or ". These
characters are usually forbidden in URLs. To use this value as a parameter, you can use expression binding. In this
example, you could change the {DocumentName} parameter to {=
encodeURIComponent(${DocumentName})}. For more information, see Expression Binding in the SAPUI5
documentation.

URLs with JSON payload: If the embedded URL contains a JSON payload, the curly brackets that are part of the
JSON need to be encoded ({ becomes %7B and } becomes %7D).

This is custom documentation. For more information, please visit the SAP Help Portal 55
4/9/2023

 Note
Curly brackets are ne in binding contexts but they need to be encoded in other parts of the URL.

Making UI Changes (Overview Pages)


When you're in the UI adaptation mode of an overview page, you can edit all UI elements (such as cards, elds, or link lists) that
get highlighted when you hover over or select them.

Introduction
An overview page (OVP) is a data-driven app type that provides all the information a user needs on a single page based on the
user’s speci c domain or role.

Adding a Card
You can add available cards that haven't been added to the UI yet or that have been removed. Right-click in the title area of an
existing card and choose Add: Card from the context menu. Select the available card that you want to add and choose OK. The
card is added to the UI.

Hiding a Card
You can hide existing cards that you don't want to be displayed initially. End users can still add cards themselves later. To hide a
card, right-click in the title area of an existing card and choose Hide: Card from the context menu.

Moving a Card
To move a card, right-click in the title area of an existing card and choose Cut from the context menu. Then right-click in the title
area of a different card and choose Paste from the context menu. The card is pasted above the other card.

This is custom documentation. For more information, please visit the SAP Help Portal 56
4/9/2023

 Note
End users without key user authorizations can also move cards for themselves by dragging and dropping them.

Editing a Card
Certain changes can be done directly on the overview page:

To change UI texts, right-click on a text, choose Rename, and change the text.

For table cards: To add a table column, right-click on an existing table column and choose Add: Column. Now, you can
choose which columns you want to add.

General Card Settings

To make more in-depth changes to the card, right-click in the title area of an existing card and choose Edit Card. The changes
that you can make depend on the type of card. If the Card Settings window has a dropdown list at the top, you can make various
changes to the basic card attributes or to individual views of the card.

Depending on the card type, you can change the following basic card settings:

Change the card title and subtitle.

Activate/deactivate the dynamic subtitle. Whether a dynamic subtitle is available, depends on the app.

Activate/deactivate the KPI header. If it's activated, you can add further KPI information to the card.

Activate/deactivate resizing of the card (if the app uses the resizable layout). If resizing is activated, you can set the
number of columns and rows for the card.

For link list cards and contact cards: Change the display type of the card.

For table cards: Change the settings for View By/View Fields By/Navigate To. The values that you can select for these
elements depend on the app.

For analytical cards and chart cards: Change the settings for View By/Navigate To/Type of Chart. The values that you
can select for these elements depend on the app.

View Settings

If the Card Settings window has a dropdown list at the top, you can make changes to the views that are available for the card.
Depending on the card type, you can change the following view settings:

You can add new views to a card and make settings for each one.

You can delete existing views for a card.

You can set a view as the default view.

The settings that you can make for each view depend on the card type and are similar to the options described under General
Card Settings.

When you've nished editing the card, choose Save. To reset the card to its default values, choose Reset Card.

Copying a Card
To copy a card, right-click in the title area of an existing card and choose Copy Card from the context menu. The card is cloned
automatically and agged as a Copy while you're in UI adaptation mode. You can then make individual changes to the copied or

This is custom documentation. For more information, please visit the SAP Help Portal 57
4/9/2023
original card.

Creating a Link List Card


To create a link list card, right-click in the title area of an existing card and choose Create Link List Card from the context menu.

Possible settings: Card Title, Card Subtitle, and Display Type are the same as when you edit a card. With , you can add links.
You can link to a URL or to a speci c application that is available for your launchpad. For each link, you can make further settings
(title, subtitle, image, etc.).

To delete a link, choose .

Creating a KPI Card

 Note
It depends on your current system whether this option is available.

To create a KPI card, right-click in the title area of an existing card and choose Create KPI Card from the context menu.

Possible settings: Card Title and Card Subtitle are the same as when you edit a card. To set a certain KPI, select it from the list
of available KPIs and choose Save.

Related Information
Publishing UI Changes
Something Isn’t Working like It Should?

Visualizing UI Changes
The Visualization mode provides the key users with both an overview of all key user changes made to the application as well as
detailed information for individual changes.

Prerequisites
You have started the UI adaptation mode by choosing Adapt UI in the user actions menu.

You have made at least one UI change.

Overview
When you're in Visualization mode, each UI control for which at least one change exists, is denoted with a blue dot as a change
indicator. The more changes exist for this control, the darker the change indicator becomes, giving the key user an intuitive heat
map that shows to which degree different parts of the app have been adapted.

This is custom documentation. For more information, please visit the SAP Help Portal 58
4/9/2023

Visualizing UI Changes
After you have chosen Adapt UI, choose Visualization in the header bar. When you hover over a control with a change indicator,
you see a border around it. Clicking anywhere on such a control opens a popover window that shows each change made for this
control with the following information:

Type Icon for the type of change, such as rename or move


This is custom documentation. For more information, please visit the SAP Help Portal 59
4/9/2023

Description Provides more information about the change. Examples: For a


renaming, the previous name of the element is shown; for a moved
control, a button is available to show where the control was moved
from, etc.

Date The date of the change is shown in an easily readable format. If you
want to know the exact time, hovering over the date shows it as a
tooltip.

Filtering Changes

In Visualization mode, the header bar contains a dropdown menu on the right to lter the changes that are visualized.

At the top of the dropdown menu, select which changes you want to view:

All: All changes (default).

Draft: Only changes that have not yet been activated.

Unsaved: Only changes that you've made in the current session and not yet saved.

You can lter for the following types of changes:

All (default)

Add

Move

Rename

Combine and Split

Remove

Other

In some cases, this dropdown shows a hint that a certain number of changes can't be visualized. There are several possible
reasons for this:

The non-visualized changes are part of a dialog or a popover that is currently not displayed.

This is custom documentation. For more information, please visit the SAP Help Portal 60
4/9/2023
The non-visualized changes aren't supported by the change visualization feature yet, such as table or lter changes.

The section, group, or form that contained the non-visualized change is no longer available (for example, because the key
user has deleted it).

Creating and Adapting Views


With the UI adaptation mode, you can change existing views, create new views, and manage available views for other users in
your organization.

Prerequisite
The app contains a view element, for example, a table with a view selector:

Create a New View


Essentially, any end user can create views for themselves. They can even make the views public for others if the administrator
has allowed this. This is described here: Personalizing Apps. As a key user, you can also create adapted views for other users and
even share them for certain roles only. Here's how this works.

1. In the user actions menu, choose Adapt UI.

2. Click on the UI element that you want to change, for example, a table and choose .

3. Make your preferred settings. The settings that you can make depend on the app and the UI element that you're
adapting.

4. Right-click on the view selector and choose Save View As.

5. Enter a unique name for your view.

6. If you want the view settings to be applied automatically when a user selects the view, select Apply Automatically.

7. If you want the view to become the default view when a user opens the app, select Set as Default.

8. Adjust the visibility of the view:

Leave it as visible for all users if the view should be available for every app user in your organization.

Add roles if you want to restrict the visibility to certain business roles:

a. Choose Add Roles.

This is custom documentation. For more information, please visit the SAP Help Portal 61
4/9/2023
b. Select at least one role that should be able to select the view when they use the app.

c. When you're done, choose Select.

d. Back in the Save View dialog, you can remove certain or all roles again.

 Caution
Restricting the visibility of a view merely hides the view on the UI for the respective users. It does not prevent users
from accessing the data associated with the view. No other security measures are applied, so if you want to
implement security requirements to restrict access to certain data, this has to be done in the back-end system.

9. Choose Save.

10. In the header bar, choose Save & Exit to save your UI changes as a draft, or choose  (Activate New Version) to save
them as a new version.

As soon as you've published your UI changes (see Publishing UI Changes), the end users can use the newly de ned view. If you've
selected certain roles for the view, it will be visible only to users with at least one of the selected roles.

 Note
If you as a key user don't have any of the assigned roles, you'll be able to see the view only in UI adaptation mode but not in
your personal view selector.

Change an Existing View


Here's how you can make changes to an existing view.

1. In the user actions menu, choose Adapt UI.

2. If you're not on the desired view, right-click on the view selector, choose Switch Views, and choose the view that you want
to change.

3. Choose  and adapt the view as needed.

4. Right-click on the view selector and choose either Save View to overwrite the selected view or Save View As to save the
view under a different name and optionally with different role assignments.

5. In the header bar, choose Save & Exit to save your UI changes as a draft, or choose  (Activate New Version) to save
them as a new version.

As soon as you've published your UI changes (see Publishing UI Changes), the changes are re ected for the end users.

Manage Views
This dialog lists the views that you or other key users have created in UI adaptation as well as public views created by end users
in this system. It does not show your personal views. If you want to delete your personal views, see Manage Views.

This is custom documentation. For more information, please visit the SAP Help Portal 62
4/9/2023

Manage Views

In the Manage Views dialog, you can perform the following actions:

To add a view to the view selector for end users or to remove it, click on the  Favorite icon.

To rename a view, click in an input eld and overwite the old name with a new name.

To determine which view should be displayed when the end user enters the app, select Default button for the respective
view.

To determine whether the view settings should be applied immediately when an end user selects the view (or, for the
default view, also when they enter the app), select Apply Automatically.

To change the role assignment for a view, choose  to open the Select Roles dialog, make your adjustments, and save
them.

To delete a view that you or another key user has created in UI adaptation or a public view that was created by an end
user in this system, click on the  Delete icon.

As soon as you've published your UI changes (see Publishing UI Changes), the changes are re ected for the end users.

Please note that the settings you make for favorites, Apply Automatically, and Default are not binding for your end users. They
can change these settings for themselves as described under Manage Views.

Related Information
Publishing UI Changes
Something Isn’t Working like It Should?

Keyboard Shortcuts
When adapting SAP Fiori UIs at runtime, the following key combinations improve accessibility and speed up your work.

Key combination What it does

Tab Moves forwards or backwards in the tab chain to select elements on the user interface (UI)

Shift + Tab

This is custom documentation. For more information, please visit the SAP Help Portal 63
4/9/2023

Key combination What it does

Arrow keys Navigates between groups and elds

Using the Left arrow and Right arrow keys, you navigate between groups and between elds
in a group. Using the Down arrow key, you navigate from a group to the rst eld in this group.
Using the Up arrow key, you navigate from a eld in a group to the group itself.

Enter Selects an UI element

Shift + F10 Opens the context menu

Ctrl + X Cuts a group or eld

Mac: Command + X

Ctrl + V Pastes a cut group or eld

Mac: Command + V

Ctrl + Z Undo

Mac: Command + Z

Ctrl + Y Redo

Mac: Command + Y

Esc Quits an editing function

Drafts and Versioning


When you as a key user adapt the user interface of an application, the adapted app is in a draft state. You can use drafts to
create different versions of the app.

Save UI Changes as Draft


To save UI changes as a draft, click Save & Exit.

Your changes are saved but won't be visible to end users yet. Later on, you can continue your work by simply starting UI
adaptation again.

In addition, as all key users share the same draft, you can also continue the work of other key users. Or you can have your work
veri ed by other key users, all without affecting any end users.

Discard a Draft
This option is only available when you display a draft that has not yet been activated.

To discard a draft, click  (Discard Draft).

You can then start adapting the UI again, based on the last activated version.

Activate a New Version


1. Click  (Activate New Version).

2. Enter a title for the new version.

This is custom documentation. For more information, please visit the SAP Help Portal 64
4/9/2023
Every time you activate UI changes, a new version is created. You can see the title of this version in the version history
dropdown list.

Display Available Versions


To display available versions, click on the title of the current version to expand the version history.

The dropdown list contains the most recent versions.

The version that is currently active is highlighted.

If you work in a test system from where UI changes are published to a productive system, you can see which versions have
already been published to the productive system.

At the bottom of the list, you always nd an entry for the original app.

 Note
If you adapted the UI of an application before the availability of the versioning feature, all changes that you made before the
availability of the versioning feature are included in a version named Version 1.

This version may contain changes that you have already published as well as changes that you have not published yet. If you
have not yet published all changes, Version 1 will appear in the Unpublished category, so you can publish it.

Switch to Another Version


1. Click on the title of the current version to expand the version history.

2. In the dropdown list, click on the title of the version that you want to display.

Reactivate a Version
This is custom documentation. For more information, please visit the SAP Help Portal 65
4/9/2023
1. Click on the title of the current version to expand the version history.

2. In the dropdown list, click on the title of the version that you want to reactivate.

3. Choose  (Activate New Version).

4. Enter a title for the new version.

Restore the Original App


1. Click on the title of the current version to expand the version history.

2. In the dropdown list, select Original App.

3. Click  (Activate New Version).

4. Enter a title for the new version.

Publishing UI Changes
You make your UI changes in a test system and publish them to transport them to the productive system. This chapter
describes this publishing step for adapted apps.

Prerequisites
The following prerequisite needs to be ful lled:

You have saved UI changes to the original app (or an existing and already published app variant) in the test system.

The changes that you want to publish need to be included in a version. You cannot publish draft changes. You can publish
either the most recent (active) version or any previous version that is yet unpublished.

Procedure
1. In the test system, open the adapted original app that you want to publish and choose Adapt UI in the user actions
menu.

2. In the version history, select a version that you want to publish.

3. Choose  (Publish Version).

4. You get a success message saying that your changes are now ready to be exported via a software collection.

5. Open the Export Software Collection app in your test system.

6. Open the software collection assigned to you. Usually, this is the Default Collection.

7. Choose one of the following options:

If you have already used this collection to export UI changes for this app, you see an entry with status Changed
for this item. In this case, select the entry and choose Export.

If you have not used this collection before to export UI changes for this app:

a. Choose Add Items and select the type UI Flexibility Variants and Changes.

b. Choose Go.

c. Select the item that corresponds to the app that you have adapted and choose OK.

d. Back in the collection, make sure that the correct item is selected and choose Export.

8. Open the Import Collection app in your productive system.

This is custom documentation. For more information, please visit the SAP Help Portal 66
4/9/2023
a. Import the software collection you created earlier.

After the import, all versions up to the version that you selected will be available in the productive system.

Deleting UI Changes from the Productive System


If you want to delete UI changes from the productive system, you rst reactivate a previous version in the test system and then
you use a software collection to export and import this version to the productive system.

Related Information
Export Software Collection
Import Collection

App Variants: All You Need to Know


You can create variants of apps (even if the apps are variants themselves). App variants are displayed as new tiles on your
home page of the SAP Fiori launchpad, and their UI can be adapted separately.

 Note
App variants are not supported in the SAP BTP ABAP environment.

Purpose
App variants are apps that you create based on UI changes that you as a key user made in UI adaptation. Instead of saving your
changes in your original app, you save them in a new app. These app variants are useful for special usage scenarios and their
speci c requirements, for example for countries, organizational units, or user groups. App variants are individual apps that are
still linked to the original app. Here's an example of a sales order app with variants for Europe and China:

Prerequisites
Some apps don’t support creating app variants. This option is then not available from the header bar in UI adaptation mode. (If
you're interested in the technical details: App variants are not supported by Scaffolding-based apps or apps whose SAPUI5
version is 1.28 or lower.)

This is custom documentation. For more information, please visit the SAP Help Portal 67
4/9/2023

Creating App Variants - General Process


Basic Steps (for the details, see Working with App Variants):

1. Adapt the UI in the test system.

2. Save your UI changes as an app variant.

3. Add your app variant to your SAP Fiori launchpad home page in your test system via the app nder.

4. Open the app variant in UI adaptation mode.

5. Publish the app variant.

6. Add the app variant to a software collection and export it from the test system.

7. Import the software collection to your productive system.

As soon as the import is nished, the app variant is available in the productive system. You and your end users can now add the
app variant to the SAP Fiori launchpad home page via the app nder (see Related Information).

 Note
For more detailed information about app variants and publishing them, see Working with App Variants and Publishing App
Variants.

Other Things to Consider


UI changes you make to the original app or a variant are not applied to other variants. But if the UI of the original app is changed
outside of key user adaptation, for example, by SAP or a developer, these outside UI changes are applied to your app on as well
as to all variants you've created from the app or its variants. Your key user UI changes are applied on top of such outside
changes.

Here's an example:

You create a new variant from an original app and a second variant from this new variant. If you as a key user then adapt the UI
of the original app or one of the app variants, these changes will only apply to the app or app variant where you make the UI
changes.

However, developer UI changes to the original app are applied to the original app and the variants.

Related Information
This is custom documentation. For more information, please visit the SAP Help Portal 68
4/9/2023
Working with App Variants
Publishing App Variants

Working with App Variants


Here's how you create and manage app variants.

 Note
App variants are not supported in the SAP BTP ABAP environment. If you choose Adapt UI in this environment, the Manage
App Variants and Save As options are not available.

Prerequisites
You have started the UI adaptation mode by choosing Adapt UI in the user actions menu.

The changes that you want to save as an app variant need to be included in a version. You cannot save draft changes as a
variant. You can save either the most recent (active) version or any previous version as an app variant.

Header Bar

Saving an App Variant


1. In the version history, select a version that you want to save as an app variant.

2. Choose Save As.

3. Enter a title for your app variant. The other information is optional.

4. Choose Save.

5. Your app variant is added to the launchpad home page of your test system automatically. You will get a noti cation.

 Note
As long as the creation is in process, you can freely navigate, but do not refresh your browser.

If you have personalized your home page, you must add the tile manually using the app nder.

This is custom documentation. For more information, please visit the SAP Help Portal 69
4/9/2023
You can now:

publish the app variant to a productive system by clicking the  (Publish Version) icon (see Publishing App Variants).

make further UI changes to your app variant and save them to a new version of this app variant using  (Activate New
Version).

after activating a new version, save it to a new app variant using Save As.

Managing App Variants


If you choose Manage App Variants, you can perform various actions for the original app and existing app variants:

Adapt UI = Opens the original app or the corresponding app variant in UI adaptation mode. Please note: This option only
works after your administrator has created a target mapping (see above).

Copy ID = Copies the ID of the original app or the corresponding app variant to give it to your administrator.

Delete App Variant = Deletes the corresponding app variant from the corresponding system.

 Note
You can't delete the original app in this dialog.

If you're working with test and production systems and you want to delete an app variant from the productive
system, delete the app variant from the test system rst, export the deleted app variant from the test system
in a software collection, and import the collection to your productive system. For more information, see
Publishing App Variants.

Related Information
App Variants: All You Need to Know
Publishing App Variants
Adding Apps to the Home Page (deprecated)

Publishing App Variants


You create your app variants in a test system and transport them to the productive system. This chapter describes this
publishing step for app variants.

 Note
App variants are not supported in the SAP BTP ABAP environment.

Prerequisites
The following prerequisite needs to be ful lled:

You have created an app variant and the app variant is available on your SAP Fiori launchpad home page.

Procedure
1. In the test system, open the app variant that you want to publish and choose Adapt UI in the user actions menu.

This is custom documentation. For more information, please visit the SAP Help Portal 70
4/9/2023
2. If you have created any versions for this app variant, select the version that you want to publish from the version history.

3. Choose  (Publish Version).

4. You get a success message saying that your changes are now ready to be exported via a software collection.

5. Choose Manage App Variants and copy the ID of the app variant to the clipboard.

6. Open the Custom Catalog Extensions app in your test system.

a. Search for the app variant using the copied ID from your clipboard.

b. In the search results, copy the ID of the found custom catalog extension (it ends with FLAV).

7. Open the Export Software Collection app in your test system.

a. Create a new software collection.

b. In the software collection, search for the custom catalog extension using the ID that you copied to the clipboard in
the previous step.

c. Add the custom catalog extension to the software collection.

d. Choose Add Missing Items. The ID of the app variant should be listed. Add it to the software collection.

e. Export the software collection.

8. Open the Import Collection app in your productive system.

a. Import the software collection you created earlier.

After the import, the app variant is available in the productive system and can be added to the SAP Fiori launchpad home page
using the app nder. See Adding Apps to the Home Page (deprecated).

Deleting an App Variant from the Productive System


If you want to delete an app variant from the productive system, the steps are essentially the same: You delete the app from
the test system rst and then you use a software collection to export and import the deletion to the productive system. See
also Working with App Variants.

Related Information
Custom Catalog Extensions
Export Software Collection
Import Collection

Something Isn’t Working like It Should?


Click on the sections below, to nd tips and solutions to the most common problems.

I can't see the Adapt UI option in the user actions menu


This can be due to the following reasons:

The app is not enabled for key user adaptation.

Your business role is not authorized for the business catalog SAP_CORE_BC_EXT.

Contact your administrator.

You don't use the FioriLaunchpad.html page.

Contact your administrator.

This is custom documentation. For more information, please visit the SAP Help Portal 71
4/9/2023

I'm getting a message that says the app is not enabled for adaptation or
personalization
This means that the application developer has deactivated these options for your app. If this application was developed in your
company, please contact your development team for further information.

I can't edit UI elements because I can't reach them


You have to toggle to navigation mode to edit UI elements, which are not directly on the UI but are triggered by actions or must
be navigated to, such as dialogs and popups. Choose Navigation in the header bar and click the element you want to navigate
to. To make UI changes, choose UI Adaptation. For more information, see Adapting the UI.

I’ve changed a UI element, but the change is not applied everywhere


UI elements that you change in one place might not be changed in all other places where they are used. For example, if you
rename a label, it's not changed everywhere in the app, and you must rename each occurrence individually.

Also, if you make changes in edit mode of the app, they might not be visible in display mode, and vice versa. If your change is
visible only in one mode, make the change also in the other (by toggling between adaptation and navigation mode as described
under I can't edit UI elements because I can't reach them).

I cannot add UI elements


If all elements are placed on the UI, there's nothing left in the dialog of the available elements. But you could still create new
custom elds and add them.

I cannot drag elds from one group to another


If you drag a eld from a group and another group is not selected as a drop zone, it is not possible to drop the eld in this group.
The reason for this is that the elds in each group come from different data pools that are incompatible with each other.

I cannot combine elds

This is custom documentation. For more information, please visit the SAP Help Portal 72
4/9/2023
If you select two or three elds, the Combine function gets available in the context menu. If you select more elds, it's grayed
out. Bear in mind that if you want to combine a combined eld, it may contain only two elds.

I cannot edit a view in key user adaptation


When editing a view in key user adaptation, make sure that you work in the same system where the view has been created.

For example, if you created a view in a test system, and then transported it to the production system, you cannot change this
view in the production system using key user adaptation. A view can only be adapted in the original system where it has been
created.

 Note
However, you can always personalize views for yourself, no matter in which system they have been created.

In the Manage App Variants overview, the Adapt UI option is inactive


Use the reload function of your browser to refresh the session. This should help.

Adapting UIs for Classic Applications


Adapting UIs with Screen Personas supports the transformation of classic applications into SAP Fiori-inspired designs. The
simpli ed versions of the applications are called avors. Flavors are a set of customizations applied to a classic application in a
speci c environment. Classic applications are also known as transactions. A single transaction can have multiple avors to
accommodate the business needs of different user groups.

For more information, see Manage UI Adaptations for Classic Applications.

At a high level, the following steps for creating a Screen Personas avor can be de ned:

1. Identify the processes to be simpli ed.

2. Simplify the processes.

3. Analyze the data requirements.

4. Build the simpli ed screens using Screen Personas.

5. Automate the process by using scripts.

Screen Personas UI Elements


Screen Personas provides the following elements for UI adaptation:

UI element Description

This is custom documentation. For more information, please visit the SAP Help Portal 73
4/9/2023

UI element Description

Flavor Manager The Flavor Manager is a toolbar at the top of the screen that
displays the most relevant avors.

From the Flavor Manager, the following editors can be accessed:

Flavor Editor.

Script Editor.

Template Editor.

Flavor Gallery The Flavor Gallery stores additional transaction-speci c avors


assigned to a user and can be accessed from the Flavor Manager.

Flavor Editor With the Flavor Editor, the users can edit, modify, or personalize
avors, as well as change the screen layout with the what-you-see-
is-what-you-get-editor. The following actions can be performed:

Hiding unnecessary UI elements.

Modifying text.

Adjusting UI elements.

The users can combine the related processes with tab merging and
apply conditional formatting to tables.

Script Editor Scripting offers developers a way to in uence the screen and
process ow by using JavaScript. For example, scripts can be
used to automate speci c tasks that users perform regularly.

Template Editor The Template Editor supports the creation of a common layout
across avors to ensure a consistent user experience. They can
contain any of the controls available in Screen Personas. For
example, a header template might include company branding and
elds for the user to populate.

Administration The administration environment provides control over all Personas


objects, such as avors, images, icons, and templates. It supports
administrators with avors management by de ning technical
details and assigning avors to users. The assignment to users is
done indirectly by grouping avors in the assignment categories.
Then, these assignment categories are used in the mapping
between user groups and business roles.

For more information, see the Screen Personas Application Help.

Personalizing Apps
You can personalize SAP Fiori apps directly in the launchpad.

You can personalize apps in the following ways:

Save your personal settings as a view, and manage views

Some user interface elements, like lter bars and certain tables, allow you to do personal settings and save these as a
view. If you do so, you can later re-apply the same settings just by selecting the view.

This is custom documentation. For more information, please visit the SAP Help Portal 74
4/9/2023
You can also manage the views that are displayed for you in the view selector. For example, when several views are
available for an app, you can select which one you want to be your default view.

Personalize link lists

Some apps provide link lists that you can personalize by adding or removing links from a prede ned set of links.

Related Information
Save Your Personal Settings as a View
Manage Views
Personalize Link Lists

Save Your Personal Settings as a View


Some user interface elements, like lter bars and certain tables, allow you to do personal settings and save these as a view. If
you do so, you can later re-apply the same settings just by selecting the view.

Context
If an app has a view selector where a Save As button is available, you can save your personal settings as a view.

Procedure
1. Do some personal settings in your app.

2. Click on the  Dropdown icon next to the name of the current view.

3. Choose Save As.

4. Enter a name for your view.

This is custom documentation. For more information, please visit the SAP Help Portal 75
4/9/2023

5. The following options are available:

Option Description

Set as Default Activate this if you want your view to be displayed by default when you enter the app.

Apply Automatically Activate this if you want the lter settings to be applied immediately when you select the view.

6. Click Save.

Results
When you click on the  Dropdown icon next to the list of views, your personalized view is available in the list of views.

Related Information
Manage Views

This is custom documentation. For more information, please visit the SAP Help Portal 76
4/9/2023

Manage Views
Some apps allow you to manage the views that are dislayed for you in the view selector. For example, when several views are
available for an app, you can select which one you want to be your default view.

Procedure
1. Click on the  Dropdown icon next to the name of the current view.

2. Choose Manage.

3. You can perform the following actions:

To add or remove a view from the dropdown menu, click on the  Favorite icon.

To rename a view, click in an input eld, and overwite the old name with a new name.

To determine which view should be displayed when you enter the app, select the Default radio button for the
respective app.

To determine whether the lter settings should be applied immediately when you select the view (or, for the
default view, also when you enter the app), select Apply Automatically.

To delete a view, click on the  Delete icon.

 Note

This is custom documentation. For more information, please visit the SAP Help Portal 77
4/9/2023
In case of public views: You can only delete public views that you have created yourself. Users with key user
authorization can also delete public views created by other end users. See Creating and Adapting Views.

 Note
Some of these actions might have been disabled by your administrator.

Related Information
Save Your Personal Settings as a View

Create Public Views


On some platforms, end users can publish a view to make it available to other end users.

Context
This feature is only available on some platforms, and it can be deactivated by your administrator.

Procedure
1. Do some settings in your app.

2. Click on the  Dropdown icon next to the name of the current view.

3. Choose Save As.

4. Enter a name for the view.

5. Activate the Public checkbox.

If you cannot see a Public checkbox in the Save View dialog, this feature is not available on your platform, or it has been
deactivated by your administrator.

6. Click Save.

Results

This is custom documentation. For more information, please visit the SAP Help Portal 78
4/9/2023
Your view is now available to other end users. For information to modify or delete a public view, see Manage Views.

 Note
You can only delete public views that you have created yourself. Users with key user authorization can also delete public
views created by other end users. See Creating and Adapting Views.

Personalize Link Lists


Some apps provide link lists that you can personalize by adding or removing links from a prede ned set of links.

Context
If a link list contains a More Links option, you can personalize which links you want to be displayed in the link list.

Procedure
1. Click on More Links.

2. Select the links that you want to be displayed in the link list. Deselect the links that you want to remove from the link list.

This is custom documentation. For more information, please visit the SAP Help Portal 79
4/9/2023

3. Click OK.

Personalizing Object Pages (Experimental)


You can personalize an object page used in your app by adding, removing or rearranging sections.

 Note
This feature is experimental. Experimental features are not part of the officially delivered scope that SAP guarantees for
future releases - this means that experimental features may be changed by SAP at any time for any reason without notice.

Experimental features are NOT FOR PRODUCTIVE USE. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.

Prerequisites
The personalization feature has been enabled for this app.

This is custom documentation. For more information, please visit the SAP Help Portal 80
4/9/2023

Here's how it works


Start the personalization mode by choosing Personalize App in the user actions menu. A footer bar at the bottom of the page
indicates that you are in the personalization mode. You can edit all UI elements that get highlighted when you hover over or
select them. Bear in mind that you cannot navigate in your app or interact with it (for example, make entries) in this mode.

 Note
If Personalize App doesn't show up in the user actions menu, the feature has not been enabled for your app.

Add section Choose  Add Section (or right-click the section and choose Add Section from the context menu),
select the available sections you want to add and choose OK.

Remove section Choose  (Remove) or right-click a section and choose Remove from the context menu. As the
section is not deleted permanently but only removed from the screen, you can add it any time from the
list of available sections.

Move section Just drag a section and drop it on the section where you want to place it. Alternatively, you can cut the
section (right-click it and choose Cut from the context menu), right-click the section where you want to
place it and choose Paste from the context menu.

To exit the personalization mode and return to your running app, choose Done from the footer bar (you can also choose Exit
Personalization Mode in the user actions menu).

Personalizing the Launchpad


As users you can personalize the launchpad to suit the way you work.

Follow the links to nd out more about the different ways to personalize the launchpad. Note that there are different options to
do this depending on the way your launchpad is con gured, e.g. if you work with the home page or with spaces and pages. See
Entry Page for more information.

See sections Personalizing the Home Page (deprecated) and Adding Apps to the Home Page (deprecated) to learn how to
adapt the home page to your needs.

This is custom documentation. For more information, please visit the SAP Help Portal 81
4/9/2023
If you work with spaces and pages, see sections Personalizing a Page and Adding Apps to a Page. Note that the personalization
options might differ from the options you are used to from the classic home page.

For general information on how you can adapt the launchpad, see sections Share Apps and Create Bookmarks for Apps and
Managing Your Settings.

There is also a tutorial available that gives you a short interactive introduction to the most important personalization options in
the home page.

Personalizing a Page
You can adapt and change your launchpad pages according to the way you want to work.

 Note
The ability to personalize the pages is enabled by your administrator. It is also important to know if you work in the spaces
mode or in the classic home page. See Entry Page for more information. How to edit the classic home page is described in
section Personalizing the Home Page (deprecated). Please note that the personalization of pages does not support all
features you know from the home page personalization.

When you rst open the launchpad, you see one or more pages with prede ned sections. In the edit mode, you can create new
sections, and manage existing sections. Your personalizations are kept, even if the administrator changes the page afterwards.
The tutorial Working with and Personalizing Spaces and Pages also shows you how to personalize a page.

How Can You Change the Layout?


You can drag and drop tiles to rearrange your page. You can also move tiles between sections. Note that the tile size might
change when you rearrange a tile: When you drag a tile to a row with tiles of another height the tile size is adapted (if the new
tile size is supported for this tile). An example: when you move a standard tile to a row that contains at tiles, the tile is changed
to a at tile as well. When you want to drag a tile to the link section to convert it to a link, you need to drag it next to another

link. When the symbol is shown, release the mouse button to insert the new link at that position.

To make other changes to the page, such as moving sections or removing tiles, you need to switch to the edit mode. Select Edit
Current Page in the user actions menu.

Now that you are in the edit mode, you can do the following:

Tile actions

Rearrange or move tiles or links: Drag the tile or link to its new location—in the current section or in another
section. Note that when you remove all tiles from a section, the empty section will no longer be shown in the
page. It is still visible in edit mode and you can add tiles to it.

Note that the tile size might change when you rearrange a tile: When you drag a tile to a row with tiles of another
height, the tile size is adapted (if the new tile size is supported for this tile).

Change the tile size or convert a tile to a link: Click on  (Over ow) and select the desired option, e g. Convert to
Flat Tile or Convert to Link in the menu. Also see Tiles, Links and Tile Sizes for a screenshot of the different tile
sizes.

This is custom documentation. For more information, please visit the SAP Help Portal 82
4/9/2023

When My Home is enabled, you can also pin any tile from any page directly to it. Select Add to My Home in the tile
context menu and this tile is added to the Recently Added Apps section on My Home. From there you can move it
to any section on My Home.

Section Actions

Add a section: In the space between existing sections or at the bottom, click Add Section. In the text box that
opens, enter a name for the new section, and press Enter .

Add apps to a section: To add new apps to the page, click Add Tile to open the app nder where you can search for
all the apps available to you. For more information, see Adding Apps to a Page.

Rename a section: Click in the section name and edit it. To discard the change while the text box is in focus, press
Esc .

Move a section: Drag the section to the new location in the page.

Hide a section: You can hide a section from the page. In the section header, click Hide Section. To show it again,
click Show Section. Note that your administrator may have chosen to disable the option to hide sections.

Delete a section: You can delete a section that you created in the personalization. In the section header, click
Delete Section. The section is deleted and its tiles are removed from the page.

Reset a section: You can reset a prede ned section that you personalized back to its initial state. To do this, click
Reset Section. If you have e.g. moved a tile to another section, and reset the rst section, the tile will be
contained in both sections.

 Note

This is custom documentation. For more information, please visit the SAP Help Portal 83
4/9/2023
Sometimes you see a Recently Added Apps section as rst section. It contains the apps you have added to the page with the
app nder or the bookmarking option. This is a locked section, so you can only drag apps from here to other sections but no
apps to this section. When this section is empty, it will be deleted automatically.

Related Information
Keyboard Navigation in the Home Page
Adding Apps to the Home Page (deprecated)
App Finder

Adding Apps to a Page


When you work in spaces mode, you can add apps to any sections in a page, or to sections that you create.

 Note
You can only personalize your pages, when your administrator has enabled the edit mode in the launchpad con guration.

You use the app nder to search for apps and then add them to one of your pages (also see App Finder).

Adding Apps in the App Finder


1. Select App Finder in the user actions menu.

2. Locate the app you want to add in the catalog. Apps are sorted into catalogs, so you can either browse all the catalogs or
use the search option to nd apps by their titles and keywords. You can also use the tag lter to nd apps from a speci c
catalog. If you do not see the search or lter options, your administrator may have disabled them. When you execute a
search, the results apply only to the currently selected tab. When you change tabs, the search automatically runs in the
new tab. Click  (Clear) to clear the ltered display.

3. Click the  (Add Tile) or  (Edit Assignment) icons below the app. The add tile icon indicates that the app has not yet
been added to a page. The edit assignment icon indicates that the app is already assigned to at least one page.

4. A window opens with the available spaces and the pages that are assigned to the spaces. Select one or more pages.

This is custom documentation. For more information, please visit the SAP Help Portal 84
4/9/2023

You can lter the list to show only the selected pages by clicking on the lter icon  . When you click OK, the app is added
to a special section in the selected page: the Recently Added Apps. This section is shown as rst section. It contains the
apps you have added to the page with the app nder or the bookmarking option. This is a locked section, so you can only
drag apps from here to other sections but no apps to this section. When the section is empty, it will be deleted
automatically. When you return to the page, you can drag the app to your preferred section.

Importing Apps and Personalizations from the Classic Home


Page to My Home (deprecated)
Learn how you can import your apps and personalized content to My Home.

 Note
This option is only available if you have worked with the home page before you switched to spaces and pages and if you have
personalized your home page. This means, if you have added apps yourself, created groups, converted tiles to links, added
bookmarks, etc. Then, you can import these adaptations to the new My Home.

Also note that the My Home feature is deprecated and will be removed in a future version.

This is custom documentation. For more information, please visit the SAP Help Portal 85
4/9/2023

Empty My Home

When you open My Home the rst time, it is empty.

How to import apps

On the top is a message strip explaining how to import your apps. Click on Import apps now to open the import dialog.

Select which groups you want to import to your My Home. All groups that were personalized in some form are
preselected already.

 Tip
SAP suggests that you only import your most important apps to create a rather lean page.

Click on Import to start importing.

When the import is nished, you see the content from the imported groups in sections that have the group names. You
can add more apps with the app nder or bookmarks the same way as you add apps to any page.

Related Information
This is custom documentation. For more information, please visit the SAP Help Portal 86
4/9/2023
Adding Apps to a Page
Personalizing a Page

Personalizing the Home Page (deprecated)


End users can adapt and change their launchpad home page according to the way they work.

 Note
The ability to personalize the home page is enabled by your administrator.

Also note that the home page feature is deprecated and will be removed in a future version. The home page is not available
in new systems (starting with version SAP S/4HANA Cloud 2302).

When you rst open the launchpad, you see prede ned groups. You can also create new groups, and manage existing groups.

How can I change the home page?


Drag and drop tiles or links to rearrange your home page. You can also move tiles or links between groups. In addition, you can
change tiles into links by dragging and dropping them in a link area. You can also convert a link into a tile with drag & drop. When
a group doesn't have a link area yet, you can create a link only in the edit mode.

Note, that drag and drop is not supported on mobile devices.

There is also a tutorial available that gives you a ve-minute-introduction to the most important personalization options.

How to change the home page with drag & drop

 Tip
If your home page is in tabbed mode, you can move a tile or link to a new group by dragging it to the target group in the
group selection bar. The tile or link will be moved to the end of the target group.

This is custom documentation. For more information, please visit the SAP Help Portal 87
4/9/2023
If you want to control where you want the tile to be positioned in the target group, drag the tile and hold it over the target
group, and then after the new group is shown, release the tile in the precise location within the group.

To make other changes to your home page, such as moving groups, removing tiles, and renaming tiles, you need to switch to
edit mode. To switch to edit mode, choose Edit Home Page in the user actions menu.

What can I change in the home page in edit mode?


Now that you are in edit mode you can do the following:

Action Description

Rearrange or move tiles and links Drag the tile or link to its new location—in the current group or in another group. You can
also click or tap the tile or link and use the Move button to select the group to which you
want to move it. This is useful if the target group isn't close to the original group in the
home page.

Note that when you remove all tiles from a group, the empty group will no longer be shown
in the home page. It is still visible in edit mode and you can add tiles to it.

Add a group In the space between existing groups or at the bottom of the home page, click or tap Add
Group. In the text box that opens, enter a name for the new group, and press Enter . The
new group, with a tile placeholder, is added to the home page.

Add apps to a group To add new apps to the home page, click Add Tile to open the app nder where you can
search for all the apps available to you.

 Remember
You cannot add tiles to locked groups.

For more information, see Adding Apps to the Home Page (deprecated).

Delete a group You can delete a group that you created. In the group header, click or tap Delete. The group
is deleted and its tiles and links are removed from the home page.

Only groups created by you have a Delete button.

Hide a group You can hide a group from the home page. In the group header, click or tap Hide. To show
the group again, click or tap Show.

 Note
Your administrator may choose to disable the option to hide groups.

Reset a group You can reset a prede ned group that you personalized, back to its initial state. To do this,
in the group header, click or tap Reset.

Rename a group Double-click or double-tap the group name, edit it in the text box, and press Enter . To
discard the change while the text box is in focus, press the Esc key.

Move a group Drag the group title to the new location in the home page.

Rename a tile Click or tap the tile and choose Edit Tile Information. In the Tile Information dialog box
that opens, enter a new title. You can also provide a subtitle and additional information.

Rename a link Click or tap the tile and choose Edit Link Information. In the Link Information dialog box
that opens, enter a new title. You can also provide a subtitle and additional information.

Convert a tile into a link Click or tap the tile and choose Convert to Link.

Convert a link into a tile Click or tap a link and choose Convert to Tile.

This is custom documentation. For more information, please visit the SAP Help Portal 88
4/9/2023

Action Description

Remove a tile or link Click or tap the  (Remove) button at the top right corner of the tile or link.

 Note
Prede ned groups can be locked to prevent personalization. In edit mode, locked groups are displayed above the My Home
group and cannot be modi ed.

To exit edit mode, click Close at the bottom of the home page or click Exit Edit Mode in the user actions menu.

What other changes can I make?


There are other settings for the home page that you can change, such as changing the display mode of content and setting a
new theme.

For more information, see Managing Your Settings.

Related Information
User Actions Menu

Adding Apps to the Home Page (deprecated)


You can add apps to any of the unlocked groups in your home page, or to new groups that you create.

Prerequisites
To personalize your home page, your administrator must rst enable edit mode in the launchpad con guration.

Please note that this feature is deprecated and will be removed in a future version. The home page is not available in new
systems (starting with version SAP S/4HANA Cloud 2302).

Context
You use the app nder to search for apps and then add them to your home page. The app nder typically comprises the Catalog
tab and the two SAP Easy Access menus, represented by the SAP Menu and User Menu tabs. For more information about these
tabs, see App Finder.

You use the app nder to search for apps and then add them to your home page. For more information, see App Finder.

 Note
If you work in the spaces mode, this works differently. See Entry Page and Adding Apps to a Page for additional information.

There are a few ways to add apps using the app nder:

Action More Information

This is custom documentation. For more information, please visit the SAP Help Portal 89
4/9/2023

Action More Information

Click App Finder in the user actions menu. This option allows you to add apps to one or more groups directly in the home page without
going into edit mode. You can also edit existing group assignments and create new groups
on-the- y.

For more information, see Adding Apps from the Catalog in the App Finder and Adding
Apps from the SAP Easy Access Menus in the App Finder below.

Click Edit Home Page in the user actions This option allows you to add and remove apps one group at a time.
menu, and then Add Tile in a speci c group.
For more information, see Adding Apps from Groups in the Home Page (Edit Mode) below.

 Tip
In edit mode you can make other changes to your home page, such as moving,
renaming, hiding, and deleting groups. See Personalizing the Home Page (deprecated).

 Remember
You cannot add tiles to locked groups.

Adding Apps from the Catalog in the App Finder

Procedure
1. Click App Finder in the User Actions Menu.

2. From the Catalog tab, locate the app that you want to add to your home page.

Apps are sorted into catalogs, so you can either browse all the catalogs or use the search option to nd apps by their
titles and keywords. You can also use the tag lter to nd apps from a speci c catalog.

 Note
If you do not see the search or lter options, your administrator may have disabled them.

When you execute a search, the results apply only to the currently selected tab. When you change tabs, the search
automatically runs in the new tab. Click  (Clear) to clear the ltered display.

3. Click or tap the (Add Tile) or (Edit Assignment) icons below the app.

 Tip
The icon indicates that the app has not yet been added to a group. The icon indicates that the app is
already assigned to at least one group.

4. Add the app to one or more groups in the Add to Groups dialog box. You can also create a new group and add the app to
it, or you can remove an app from a group by clearing its checkbox in the same dialog box.

Adding Apps from the SAP Easy Access Menus in the App Finder

Procedure
1. Click App Finder in the User Actions Menu.

This is custom documentation. For more information, please visit the SAP Help Portal 90
4/9/2023
2. Click either SAP Menu or User Menu.

The SAP Menu and the User Menu tabs are also called the SAP Easy Access menus. Each tab displays different apps in
folders, as con gured by your administrator. The procedure of adding apps to your home page, is the same for both
menus.

 Note
The SAP Easy Access menus are not supported on mobile devices.

3. If your administrator has con gured more than one system, when you open the SAP Easy Access menu for the rst time,
select a system.

 Tip
You can always select a different system by clicking Select System next to the name of the current system in the
navigation pane.

In the navigation pane on the left, you can now see the folders available in the selected system.

4. Navigate to the folder containing the apps that you want to add to your home page.

You can also use the search option to nd apps by their titles and keywords. If you cannot nd the search option, it may
be have been disabled by your administrator.

 Remember
When you execute a search, the results apply only to the currently selected tab. When you change tabs, the search
automatically runs in the new tab.

5. Click or tap the (Add Tile) or (Edit Assignment) icons below the app.

6. Add the app to one or more groups in the Add to Groups dialog box. You can also create a new group and add the app to
it, or you can remove an app from a group by clearing its checkbox in the same dialog box.

Adding Apps from Groups in the Home Page (Edit Mode)

Procedure
1. Click Edit Home Page in the User Actions Menu.

2. In the home page, click the plus icon in a group (it's the last tile in the group) to add a tile.

3. In the Catalog, User Menu, or SAP Menu tab, click the (Add to Group) or (Remove from Group) icons
below the app.

The selected app is added to or removed from the group.

Share Apps and Create Bookmarks for Apps


You can share apps or search results with your colleagues or create your own tiles with access to speci c app or search data.

You can choose between three options:

Share this information on SAP Jam (if available in your system).

Send an e-mail with a link to the search or app and your currently selected data to a colleague.

This is custom documentation. For more information, please visit the SAP Help Portal 91
4/9/2023
Save the app or search as a new tile in your launchpad.

Which options are available depends on the system con guration and the speci c app. If the share icon  (Share) is available,
click on it to see what you can do.

Start a search in the launchpad or open the app and select your data (e.g. by ltering or searching). Then select one of the
sharing options.

Share on SAP Jam


This opens a window where you select a group in SAP Jam where you add a link to this app or search. If you have no group, you
need to create one rst.

Send E-Mail
An e-mail draft is created that already contains a link to this app or search and a subject. Add the receipient and some
additional explaining text, if necessary. Click on Send.

Chat in Microsoft Teams


You can use the Chat in Microsoft Teams option to collaborate with co-workers by directly sharing a link to a business
application in the SAP system.

Save as Bookmark

 Note
This option is handled differently if you work with spaces and pages (see Entry Page for more information). You cannot
search for a personalized bookmark. We describe the differences below.

You can save the selected data as a new tile that then directly opens the selected data in the app or performs the saved search.

1. Click on the share icon  (Share) and select Save as Tile.

This is custom documentation. For more information, please visit the SAP Help Portal 92
4/9/2023

Creating a New Tile as Bookmark

2. Enter a title for the tile. For an app you should enter a new name to distinguish it from the existing app tile. You can enter
a subtitle and a description for the tile.

3. Then you select where the tile should be added.

If you work with the home page, you can select a group in the eld Home Page.

If you work with pages and spaces you select one or more pages. The tile is added to the Recently Added Apps
section on the selected pages. This is a locked section, so you can only drag apps from here to other sections but
no apps to this section. When the section is empty, it will be deleted automatically. When you return to the page,
you can drag the app to your preferred section.

Managing Your Settings


Users maintain launchpad settings in the Settings dialog of their SAP Fiori launchpad.

You can nd, view, and change the visual appearance of your launchpad, such as the theme, and con gure various functional
aspects, such as search settings, user default values, and usage analytics.

Where do I manage my settings?

This is custom documentation. For more information, please visit the SAP Help Portal 93
4/9/2023
In the user actions menu, choose Settings. A settings dialog opens for each of the relevant settings that you want to view or
edit.

What settings can I view or change?


Depending on your con guration, there are several tabs that show different settings parameters. The gure shows an example
of the theme settings.

 Note
Some settings are read-only and cannot be changed directly in the Settings dialog. You may also not see all the settings;
they may either be disabled by your administrator or not supported on your platform.

Setting Description

User Account View your account settings, such as name, e-mail, and server address.

Appearance Change your launchpad theme and display settings. See Themes for more information.

When using a hybrid device that combines touch and mouse events, you can turn on the Optimized for
Touch Input feature which increases the size and spacing of the controls on your screen so they are
easier to use with your ngertip.

You can choose if the tiles should be displayed in a small or a large size.

When you work with the Quartz or Horizon theme, you can use dark mode features for the launchpad.
When you use a browser that supports automatic color scheme detection (e.g. Google Chrome in a
current version), the current dark mode setting in your operating system settings will be re ected in
your launchpad. Activate Dark Mode to enable or disable the automatic dark mode detection for the
launchpad. If you use a browser that does not support automatic color scheme detection, you can
select a dark theme instead. Note that your administrator can disable this feature.

This is custom documentation. For more information, please visit the SAP Help Portal 94
4/9/2023

Setting Description

Home Page
 Note
Please note that this feature is deprecated and will be removed in a future version. The home page
is not available in new systems (starting with version SAP S/4HANA Cloud 2302).

Choose whether to show the content of all your groups all at once on the home page or to show only one
group at a time. The group selection bar at the top of the home page appears identical for both
options; however, they behave differently:

Show all content: Behaves like an anchor bar; choosing a group at the top of the home page
scrolls to the content assigned to the group.

Show one group at a time: Behaves like a tab bar; choosing a group displays the content
assigned to the group.

For large amounts of apps, showing one group at a time may be better.

 Note
If you work with spaces and pages, this tab is not available. See next line for more information.

Spaces and Pages


 Note

Check or change the spaces setting and My Home setting for the dashboard, as described in
Maintaining Settings for Spaces. If spaces are enabled, you see your apps in sections on one or more
pages. If the spaces are disabled, you see the classic home page. See Entry Page for more information
on the differences.

Language and Region View your login language, as well as date and time formats.

If the administrator has allowed it, you can select a different language for the launchpad and select
your preferred date and time formats. See Maintaining Your Language and Regional Settings for more
information.

User Activities Specify whether to track user activity.

Set Track my recent activity and frequently used apps to NO to stop tracking user activity. The
entries Recent Activities and Frequently Used are then removed from the user actions menu.

Click Clear to delete your user activities. If Track my recent activity and frequently used apps is set
to YES, the Recent Activities and Frequently Used lists are cleared, but the system continues to track
your activity and displays new items in the user activity lists.

For more information, see Working with Recent Activities and Frequently Used Apps.

User Pro ling Turn on Personalized Search to allow the system to collect data about your search behavior. This data
is used to improve future search results. You can also delete this collected data by clearing your
browser history.

Default Values View and edit default user-speci c parameter values used when launching your apps.

For more information, see Maintaining Your Default User Values.

Noti cations Personalize various settings that are related to the noti cations provided to you in the launchpad.

For more information, see Setting Noti cation Preferences.

 Remember
Click Save to apply your changes.

This is custom documentation. For more information, please visit the SAP Help Portal 95
4/9/2023
When an entry you make produces an error or a warning, a message icon is displayed in the lower left corner of the user
settings window. The icon shows the number of problems. Click on the icon to see detailed information about the warnings or
errors. The following gure shows an example.

Related Information
User Actions Menu

Maintaining Settings for Spaces


Activate spaces and My Home in the launchpad.

On this tab you can switch to the spaces layout. If spaces are enabled, you see your apps in sections on one or more pages. If the
spaces are disabled, you see the classic home page. See Entry Page for more information on the differences.

 Note
The home page is not available in new systems (starting with version SAP S/4HANA Cloud 2302). In this case the Spaces tab
is also not available.

When spaces are enabled, one or two settings can be available. Which options can be set, depends on your system setup.

Show My Home: You can add your preferred apps to My Home and adapt it to your needs (see My Home (deprecated)).
When you don't want to work with My Home, you can disable it here. Then, the rst page of the rst space will be
displayed when you start the launchpad or click on Home.

Show Import Message: Activate this to show the message strip for import from the home page again on My Home. Then
you can start importing your personalization of the home page on My Home. Note that this option is only shown when
you have enabled My Home and have personalized the classic home page before (also see Importing Apps and
Personalizations from the Classic Home Page to My Home (deprecated)).

Maintaining Your Language and Regional Settings


You can see and change your language and region settings for the launchpad in the User Settings dialog.

Open the User Settings dialog from the user actions menu and go to the tab Language & Region. Here you see your login
language, as well as the currently set date and time formats. Depending on the system settings, you can change the language
and the date and time formats to be used.

This is custom documentation. For more information, please visit the SAP Help Portal 96
4/9/2023

Language and Regional Settings in the User Settings Dialog

If the administrator has allowed it, you can select your preferred language (and region, if applicable) in the eld
Language and Region. You can also select Browser Language to use the language you use in your web browser.

When the elds Date Format and Time Format are shown (depending on the backend capabilities), you can select your
preferred date and time format.

Time Zone: For classic UI apps (e.g. Web Dynpro-based or SAP GUI apps), you should select your local user time zone.
SAP recommends that you set the same time zone here as in the client to ensure a consistent behavior.

When you don't know the type of an app, you can check it in the About dialog in the eld ID of the Application Framework
(see Information About App and Launchpad Version). If you aren't sure about the settings, please contact your
administrator.

Note that the time zone setting here is only saved on the frontend server. It doesn't apply to SAPUI5-based SAP Fiori
apps. These apps automatically use the browser setting for the time zone.

Select your preferred decimal format in the eld Decimal Format.

The launchpad is reloaded after you've saved your changes.

Maintaining Your Default User Values


Some applications can be launched with user-speci c default values. You can view these values and edit the default values if
necessary.

If you update any of the available values, the new value will be used in all applications that reference that value. You can save
several value sets and switch between them.

This is custom documentation. For more information, please visit the SAP Help Portal 97
4/9/2023

Currently used default values

Edit currently used values


1. Click the Settings option in the user actions menu. Select Default Values. You see the Saved Values, which are the values
used as default values in your system. You can change any displayed value, or just view the values.

2. Some values allow you to specify additional values. Click Additional Values.

3. If you have changed any of the values, a star is shown next to Saved Values. Click Save to save your changes to the
applied value set.

Applying values from a stored value set


You can apply so-called views (that represent value sets) which were saved as your personal value sets or saved as public value
sets.

1. Open My Views by clicking on the arrow next to the value set. The list shows all value sets that are marked as favorites.
This usually comprises your own de ned value sets and public value sets you selected as favorites.

2. If you don't see a speci c value set, click on Manage. The Manage Views list shows all available value sets. Click on the
star to add a value set to My Views.

3. To change your default values. select a different value set from the list. Check the values and then click on Save to import
the values to the currently used values.

This is custom documentation. For more information, please visit the SAP Help Portal 98
4/9/2023

 Tip
This can e.g. be used when you normally work with a standard parameter set but need a speci c parameter set for a speci c
business scenario. You can create two different parameter sets for the different business scenarios. You then usually work
with the standard set and apply the speci c parameter set when necessary. When you are done with the speci c case, you
apply the standard parameters again.

Saving a new value set


You can create a new parameter set, e.g for a speci c business scenario.

1. Click on the arrow next to the value set name, e.g. Saved Values as in the image above.

2. In the opening dialog, click on Save As.

3. Enter a new name for the parameter set in the eld View and select, if the value set should be public. Public means that
other users in the system can use the parameter set as well.

4. Enter the new values or change the existing values.

5. Click on the arrow next to the parameter set name and select Save in the opening dialog to save your changes.

6. If you want to work with the new value set directly, click on Save to apply it to the Saved Values. Those values are now
activated and will be used in your system.

Managing value sets


In the Manage Views you can add value sets to your favorites. In addition, you can rename or delete your own value sets. Note
that the Saved Values cannot be edited or deleted as they always re ect the currently active used values.

This is custom documentation. For more information, please visit the SAP Help Portal 99
4/9/2023
1. Click on the arrow next to the value set name, e.g. Saved Values as in the image above.

2. In the opening dialog, click on Manage.

3. When you want to add a value set to your favorites, click on the star. The value set will be added to My Views.

4. When you want to rename the value set, enter a new name in the eld View.

5. When you want to delete a value set, click on the x in the table row. Normally, you can only delete your own de ned value
sets. Only users with additional rights are allowed to edit or delete public value sets created by other users. It is good
practice to edit or delete only value sets you created yourself.

6. Click on Save.

Setting Noti cation Preferences


The launchpad displays noti cations that are related to your business role, such as leave requests or purchase orders. Usually
there are different noti cation types available, e.g. noti cations in the launchpad, mobile or e-mail noti cations. You can
personalize various preferences relating to which noti cations you want to receive, and how and where they are displayed.

Some of the noti cation preferences that you set affect all types of noti cations, while others are speci c to a noti cation type.

To access your noti cation preferences, in the user actions menu, open Settings Noti cations .

General Preferences
The setting Show High-Priority Noti cation Alerts affects all noti cations, regardless of their noti cation type. If you are
working in an app or the app nder, a popup noti es you immediately when you receive a high-priority noti cation. When this
setting is off, you will only see the high-priority noti cation when you are back in the home page view.

Preferences for Speci c Noti cation Types


Below the general preferences is a table listing the different types or categories of noti cations that you have received so far.
This table is empty until you receive your rst noti cation. The list expands over time as you receive different noti cation types
relating to your business role.

You can set the following preferences separately for each noti cation type:

This is custom documentation. For more information, please visit the SAP Help Portal 100
4/9/2023

Setting Description

High Priority Select this option to set the priority for all noti cations of the selected noti cation type to high. This
overrides the current priority of the noti cation set by the noti cation channel. The updated priority is
only set for that speci c user and it is not pushed to the backend system or to other users who may
have received the same noti cation.

This setting is useful when used in combination with the Show High-Priority Noti cation Alerts
setting.

 Remember
When you enable this setting, only new noti cations are updated with the high priority ag.
Noti cations you received earlier will not be updated.

Similarly, when you disable this setting, any earlier noti cations that were agged as high priority
will not return to their original priority level.

Mobile Noti cations Select this option to also receive native noti cations on your Android/iOS mobile device.

This option is available for some noti cation types only; if this option is disabled, then the noti cation
type cannot be broadcast to your mobile device. Your administrator also needs to con gure support for
mobile devices and you need to install the required client app on your device. Contact your
administrator for more details.

E-Mail Select this option to receive an additional e-mail for a noti cation. This option is only available for
some noti cation types; if this option is disabled, no e-mail noti cations can be sent. If your e-mail
address is not provided in the system, the column is not displayed and you cannot enable e-mail
noti cations. To check your e-mail address open Settings User Account .

Enable Turn off this option to stop receiving noti cations in the launchpad and mobile/e-mail noti cations for
the selected noti cation type.

 Remember
When you re-enable a noti cation type, you will see new noti cations received from that time
onwards. You won't receive older noti cations that were sent to you while the noti cation type was
disabled.

Related Information
Working with Noti cations

Administration Guide
This guide provides administrators with information on how to adapt the launchpad to the user's needs, for example by
activating additional features for end users.

Related Information
Manage Launchpad Settings
Managing Launchpad Spaces and Pages

Manage Launchpad Settings


With this app you can display and change parameters to con gure different aspects of the launchpad.

This is custom documentation. For more information, please visit the SAP Help Portal 101
4/9/2023

Key Features
This app provides the following key features:

Display parameters and their current values

Change the value of one or more parameters

Set all parameters back to their default value

Implementation Information
To use the app, you need the following:

Business catalog: SAP_CORE_BC_UI

Business role: SAP_BR_ADMINISTRATOR

To get the key information, including all the technical data you need for the installation and con guration, go to the SAP Fiori
apps reference library.

Available Settings
You can set the following parameters:

Parameter Description

APPFINDER_ENABLED Specify if your users have access to the app nder. If set to false,
the app nder will only be available if personalization is enabled.
Users can open all the apps in the app nder, which are assigned to
them according to their role assignment.

Note that this entry is set to false for all existing systems by
default. For new systems (starting with version SAP S/4HANA
Cloud 2302) the default is true.

DARK_MODE Specify if users are allowed to switch on the dark mode support for
the launchpad. This is only supported if the users have selected a
SAP Quartz theme.

When they use a current browser that supports automatic color


scheme detection, they can decide that the current dark mode
setting in the operating system settings will be re ected in the
launchpad. If they use a browser that does not support automatic
color scheme detection, they can enable or disable the dark mode
to switch easily between the dark and the light Quartz theme.

You can check the MDN page compatibility matrix to derive the
list of supported browsers. Support for this feature also depends
on the underlying operating system support as the same browser
can be used on different operating systems.

Also see Managing Your Settings.

DEFAULT_SEARCH_SCOPE_APPS Speci es the default search scope.

false: default search scope is All

true: default search scope is Apps

See: Searching for Business Objects and Apps

This is custom documentation. For more information, please visit the SAP Help Portal 102
4/9/2023

Parameter Description

HOMEPAGE_FEATUREDGROUP Set this parameter to true if the featured group should be


displayed as rst group on the launchpad home page. Please note
that this feature is not supported in the spaces mode.

See Home Page (deprecated).

 Note
This feature is experimental. Experimental features are not part
of the officially delivered scope that SAP guarantees for future
releases - this means that experimental features may be
changed by SAP at any time for any reason without notice.

Experimental features are NOT FOR PRODUCTIVE USE. You


may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with
data that has not been sufficiently backed up.

Note that this parameter is not available for new systems


(starting with version SAP S/4HANA Cloud 2302) as the home
page is no longer available.

HOMEPAGE_GROUPSELECTIONBAR_MODE Specify the default mode of the group selection bar on the home
page.

On the launchpad home page, apps are clustered in groups. These


groups are listed in the group selection bar at the top of the home
page. This bar can function either as an anchor bar or a tab bar.
With this parameter, you specify the default mode of the group
selection bar.

Valid values:

scroll

tabs: Sets the tab mode. The home page shows one group
at a time. When the user chooses a group, the home page
displays only the content for that group. For large amounts
of apps, showing one group at a time may be better.

See Home Page (deprecated)

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as the home
page is no longer available.

HOMEPAGE_PERSONALIZATION Specify whether users can personalize the content displayed in the
home page or in pages.

When set to false, the user can't perform the following actions:

Move, rename, delete, reset, or create groups/sections

Move or remove tiles

When false, the app nder is also disabled for users. Note that
this setting doesn't in uence My Home. When My Home is enabled
(parameter SPACES_MYHOME), users can edit it anytime.

See: Personalizing the Home Page (deprecated) and Personalizing a


Page

This is custom documentation. For more information, please visit the SAP Help Portal 103
4/9/2023

Parameter Description

HOMEPAGE_PERSONALIZATION_HIDEGROUPS Specify whether users can hide groups on the home page or
sections on a page in edit mode.

When set to true, the Hide option is displayed in the group header.
Note that home page personalization must be enabled for this
option to take effect (see parameter
HOMEPAGE_PERSONALIZATION).

See: Personalizing the Home Page (deprecated) and Personalizing a


Page

INPUTFIELD_HISTORY Enable this parameter so that the system saves the values a user
has entered into a eld in an app (only for SAPUI5 apps using
smart controls that are supporting a history). When a user sets the
cursor in a eld, the last ve entries are shown as a value list. We
recommend to enable this setting.

Users can enable or disable the history and delete their recently
entered values. See User Actions Menu for more information.

NAVIGATION_RECENTACTIVITY Specify whether users can see and access a list of apps and
objects in the Quick Access dialog that they have recently worked
with and used the most.

Set to false to stop collecting data about the user's most recent
and most used items, and hide the Recent Activity and Frequently
Used lists from the user actions menu.

See: User Actions Menu

SEARCH_BUSINESS_OBJECTS Speci es if business objects are included in the search scope.

true: search for business objects is activated

false: search for business objects is deactivated. Users can only


search for apps.

See: Searching for Business Objects and Apps

SEARCH_SCOPE_WITHOUT_ALL Speci es whether the All connector is displayed in the  search


bar in the shell header.

true: The All connector is not used. The default search scope is
Apps.

false: The All connector is used.

See: Searching for Business Objects and Apps

SESSION_TIMEOUT_INTERVAL_IN_MINUTES Enter the timeout period in minutes according to platform


con guration for session timeout. If you enter -1, you disable the
timeout.
See Con guring the Automatic Sign-Out

SESSION_TIMEOUT_REMINDER_IN_MINUTES Enter the time in minutes before session timeout when the keep
alive popup window should be displayed. If you enter 0, no dialog
will be displayed.

This is custom documentation. For more information, please visit the SAP Help Portal 104
4/9/2023

Parameter Description

SESSION_TIMEOUT_STOP_DATA_REFRESH Determines the time a user has to be inactive before the tiles stop
sending polling data refresh requests. After a de ned idle time the
ABAP server terminates the session for security reasons.

Enter the time in minutes. If you enter -1, you disable the timeout.

See Con guring the Automatic Sign-Out.

SPACES If you want to enable spaces and pages for your users, set this
parameter to true. False means that the home page is shown.

The default value is true

See: Enabling Spaces and Managing Launchpad Spaces and Pages

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as the home
page is no longer available and spaces are enabled by default.

SPACES_CUSTOM_HOME Set this parameter to true if you want to use My Home in SAP
S/4HANA Cloud. You can use the application if you’ve con gured
spaces and pages in your SAP Fiori launchpad settings. We
recommend using My Home in SAP S/4HANA Cloud. Note that you
have to set the parameters SPACES and SPACES_MYHOME to true
as well.

The default value is true.

For more information, see Enabling Spaces, Best Practices for


Managing Spaces and Pages, and My Home in SAP S/4HANA
Cloud.

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as My Home
in SAP S/4HANA Cloud is enabled by default.

SPACES_ENABLE_USER If your users should be able to switch between the spaces and the
classic home page, set the parameter SPACES_ENABLE_USER to
true. Users then can decide in the user settings, which layout they
prefer.

See: Enabling Spaces and Managing Launchpad Spaces and Pages

The default value is false.

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as the home
page is no longer available and spaces are enabled by default.

This is custom documentation. For more information, please visit the SAP Help Portal 105
4/9/2023

Parameter Description

SPACES_MYHOME Enable the My Home space for all your users. Users can con gure
My Home according to their individual preferences. See My Home
(deprecated) for more information.

Note that this setting is only relevant, when you have enabled
spaces for your users with at least one of the parameters SPACES
or SPACES_ENABLE_USER.

If your users have de ned a My Home page and you activate the
parameter SPACES_CUSTOM_HOME, the content de ned is shown
in the favorites section on My Home for SAP S/4HANA Cloud.

If you deactivate SAP_MYHOME, users can't see their personal My


Home anymore.

The default value is true.

See: Enabling Spaces.

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as My Home
in SAP S/4HANA Cloud is enabled by default.

SPACES_SORT_CRITERION Specify how the spaces are sorted for the users in the navigation
bar. title indicates that spaces are sorted according to the
space title. id indicates sorting according to the space ID.

See: Sorting the Spaces for a detailed description and additional


sorting options.

THEMING_DEFAULT_THEME Change the default theme for SAP Fiori launchpad by entering a
theme ID. The speci ed theme is applied to the launchpad home
page and content embedded in the launchpad.

The theme should support the design guideline SAP Fiori 2.0 or
SAP Fiori 3.

You have the following options:

Set a different SAP standard theme. The default theme is


sap_fiori_3 (Quartz theme)

Set a custom theme created with UI theme designer

For further information on creating custom themes, see Setting


Custom Themes for the Launchpad.

This is custom documentation. For more information, please visit the SAP Help Portal 106
4/9/2023

Parameter Description

UI5FLEX_ENABLE_VARIANTS Specify if users are allowed to create and adapt views and
whether they're allowed to share them (see Save Your Personal
Settings as a View).

This is a global setting. There are three options:

PUBLIC (default)

Users are allowed to create and adapt new views. By


selecting the Public checkbox, they can also share them
with other users.

PRIVATE

Users are allowed to create and adapt new views, but the
Public checkbox is not displayed, preventing users from
sharing views.

NONE

Users are not allowed to create or adapt views. They can


still set a view as favorite and change their default view.
Optionally, they can also choose whether a view should be
applied automatically, meaning a search should
immediately be triggered as soon as the view is selected.

This setting supersedes SAP Note 2658662 . If you have


implemented this SAP Note, you need to revert it for this launchpad
con guration parameter to have an effect.

UI5_PLACEHOLDER_SCREEN Enable the parameter to render placeholder screens and improve


the perceived performance when loading. We recommend to enable
the parameter unlesss problems with the placeholder loading arise.

USERSETTINGS_CONTENTDENSITY Specify whether end users can view and toggle the Optimized for
Touch Input option.

This setting is intended for users of hybrid devices that combine


both touch and mouse events. Set to false to hide the Optimized
for Touch Input option from the Settings dialog box.

See: Managing Your Settings

USERSETTINGS_GROUPSELECTIONBAR Specify whether end users can personalize the group selection bar
in the home page.

In the Home Page setting in the Settings dialog box (accessed from
the Settings entry in the user actions menu), end users can
personalize whether the group selection bar in the home page
functions as an anchor bar or a tab bar.

When set to false: The Home Page setting is hidden from the
Settings dialog box; meaning that users won't be able to change the
display mode of their home page.

The default value is false.

See: Managing Your Settings

 Note
Please note that this parameter is not available for new systems
(starting with version SAP S/4HANA Cloud 2302) as the home
page is no longer available.

This is custom documentation. For more information, please visit the SAP Help Portal 107
4/9/2023

Parameter Description

USERSETTINGS_SET_LANGUAGE With this parameter you can enable your users to change the
launchpad language themselves (see Managing Your Settings).

USERSETTINGS_SET_THEME Specify whether end users can select a different theme in the
Settings dialog box in the Appearance section.

When set to false, the end user can see the current theme, but
cannot select a different one.

When set to true, the end user can select the theme to use.

See: Managing Your Settings.

XHRLOGON_MODE Specify the mode for XMLHttpRequest (XHR) logon. Possible


values are frame (this is the default), reload and
logoffAndRedirect (parameter logoffAndRedirect is not
applicable).

Usually, a user logs on to the system at the beginning of a session.


The logon is performed when the main HTML page of the launchpad
is loaded. For subsequent data requests sent by apps (using
XMLHttpRequest), a user usually has a valid session. But after a
session timeout, it might be required to authenticate such XHR
requests. For that authentication is performed in an iFrame by
default. Security restrictions for the logon page might prevent
rendering of the logon page in an iFrame. By choosing option
reload, the XHR logon will only show a message to the user and
reload the main HTML page, so that a logon can be performed. By
default, the XHR logon uses an iFrame to display the logon page.
Only if this is not possible due to restrictions of the logon page, it
can be con gured to a different mode.

Usually, you don't have to change this parameter. Check the


settings, if you experience problems with authenti cation requests
triggered by SAP Fiori launchpad or SAP Fiori apps based on
SAPUI5.

Example: If the involved logon page cannot be loaded inside an


iFrame and the user session on the ABAP front-end server times
out, the SAP Fiori launchpad shows a dialog with a white screen.
Then select XHR logon mode reload.

Con guring the Automatic Sign-Out


For security reasons, a user should be signed-out automatically after a certain time of inactivity. You can set the time for
automatic sign-out and de ne if a warning before sign-out is displayed.

When a user has not been active in the system for a speci c time, they can be automatically signed out.

 Note
The parameters described here only affect the launchpad HTTP security session. They control the timeout for the SAP Fiori
launchpad and all stateless applications (SAPUI5-based applications). Stateful applications (for example SAP GUI for HTML
or Web Dynpro apps) use an application session in addition, which has set a different timeout. The SAP Fiori launchpad
parameters have no in uence on the application session timeout.

This is custom documentation. For more information, please visit the SAP Help Portal 108
4/9/2023
The launchpad offers two different possibilities to specify how the automatic sign-out should be handled. We recommend that
you only set parameters for one of the solutions, not for both.

Server-Driven Sign-Out
You can use the parameter SESSION_TIMEOUT_STOP_DATA_REFRESH to work with the ABAP-server driven sign-out. This is
the default setting. The ABAP-Server driven sign-out is set to 30 minutes. With the parameter set here you determine the time
a user has to be inactive before applications (e.g. dynamic tiles or noti cations) stop sending polling requests for refreshing
data. This is necessary because as long as the client sends requests, the server will not terminate the session. After the client
has stopped sending requests the server session-side timeout can apply. The idle time depends on your system con guration.
When the ABAP server terminates the security session, the user is logged off from the local ABAP server. Depending on the
system and single sign-on con guration the user is either signed-in to the launchpad automatically again via single-sign on or
the sign-in screen is displayed.

Enter the time in minutes. The default value is 15 minutes. If you enter -1, you disable the timeout. If you set e.g. 15 minutes for
SESSION_TIMEOUT_STOP_DATA_REFRESH and the server timeout is set to 30 minutes, the security session will be ended
after 45 minutes of inactivity.

UI-Driven Sign-Out
You can also set parameters for a UI-driven sign-out. With this setting, the users are automatically signed-out from the
launchpad, open applications in the launchpad and all SAP products that also use the same Identity Provider (depending on
con guration).

A few minutes before this timeout, a warning can be displayed, informing them that they will be signed out soon. If several
browser tabs with the launchpad are opened, the user activity is monitored in all tabs within the same browser.

You de ne the times for automatic UI-driven sign-out with two parameters:

Use the parameter SESSION_TIMEOUT_INTERVAL_IN_MINUTES to enter the timeout period in minutes for the
security session timeout. The maximum value is 71582 minutes. If you enter -1, you disable the automatic sign-out. This
is the default setting.

With the parameter SESSION_TIMEOUT_REMINDER_IN_MINUTES you can set the time when a popup window
reminding the user of the automatic sign-out will be displayed. Enter the time before session timeout in minutes. The
default value is 5 minutes. If you enter 0, no dialog will be displayed.

To ensure that the activity and idle time is monitored correctly across several open browser tabs or windows you need to enable
a feature in the browser settings. It is called localStorage or DOMStorage depending on the browser vendor. If the feature is
disabled, logoff might be performed earlier and not synchronized between different browser tabs or windows.

An automatic sign-out might also be raised although the user is still active in the following situations:

an app is opened in a new window and not hosted by the launchpad shell, e.g. a link to SAP SuccessFactors

the user uses different browser instances (e.g. Chrome and Firefox) in parallel

Enabling Spaces
There are two parameters and one user setting that in uence if the launchpad uses spaces or the home page for displaying the
apps.

 Note

This is custom documentation. For more information, please visit the SAP Help Portal 109
4/9/2023
Please note that this feature is not available for new systems (starting with version SAP S/4HANA Cloud 2302) as the home
page and the parameters described here are no longer available. The default layout is spaces and pages.

The layout of the page area can be changed. You can either show the classic home page layout where all apps are shown on one
page in different groups. Or you can enable the spaces. The spaces contain a page that shows apps for a speci c user group
de ned by the business role. (How to de ne a page is described in section Editing a Page).

If you want to enable spaces and pages for your users, set the parameter SPACES to true. False means that the home
page is show as standard setting. Note that this setting is applied to all users. You should have created and assigned
spaces and pages for all business roles you have assigned to your users, before you switch to spaces. Also see Step by
Step: Create a New Space and Page for a Business Role.

If you only have de ned a few pages so far, you should not yet enable the spaces mode for all users with the parameter
SPACES. Instead, you can set the parameter SPACES_ENABLE_USER to true and ask those users with roles for that
pages are available, to switch to the spaces mode themselves. They can then start working with pages.

If your users should be able to switch between the spaces and the classic home page, set the parameter
SPACES_ENABLE_USER to true. Users then can decide in the user settings, which layout they prefer. See Managing Your
Settings for more information. Please note that the user settings overwrite the custom settings you de ne here.

How to set parameters is explained in section Manage Launchpad Settings .

Examples
There are four possible con gurations:

If all users should see the spaces layout and be able to switch between the layouts, set SPACES and
SPACES_ENABLE_USER to true.

If all users should only see the spaces layout, set SPACES to true, and set SPACES_ENABLE_USER to false.

If all users should see the home page by default but be able to switch between the layouts, set SPACES to false, and set
SPACES_ENABLE_USER to true.

If you want to deactivate the spaces layout completely for now, set SPACES and SPACES_ENABLE_USER to false. Then
the home page is always displayed.

When you have enabled spaces, you can also enable My Home for your users with the parameter SPACES_MYHOME.

Managing Launchpad Spaces and Pages


Learn how to manage the launchpad spaces and pages as well as create and edit pages and spaces.

The following sections describe how to create and edit your own spaces, how to de ne speci c pages for different user groups
and how to edit existing pages. The following gure shows how the layout with spaces and pages looks and how the different
elements work together.

This is custom documentation. For more information, please visit the SAP Help Portal 110
4/9/2023

Spaces layout and related elements

Advantages of the launchpad spaces and pages


The spaces mode was developed to offer more exibility to in uence the launchpad layout for speci c user groups. Pages are
assigned to users via spaces that are assigned to business roles. The business role de nes which users see a speci c space. If
you enable spaces for your users and de ne speci c spaces and pages for them you can reach a better t. By de ning pages
with meaningful sections you can de ne in which order the apps are sorted on the page. You can e.g. sort the most used apps in
the top-level section and then create separate sections for apps that belong together. SAP delivers prede ned spaces and
pages that you can use to start (see Working with Prede ned Spaces and Pages).

Tutorial
For a quick overview of the new features you can use the tutorial Managing Launchpad Spaces and Pages. The ve-minute-tour
shows you how to create a space and page and to enable the spaces for your users.

Next steps
First, check out the Tools and Prerequisites for Managing Spaces and Pages. If everything is set up, read How to Create and
Assign Spaces and Pages.

Tools and Prerequisites for Managing Spaces and Pages


Find out what you need to set up spaces and pages in the SAP Fiori launchpad.

There are several tools you use and several prerequisites that have to be met to create and manage spaces and pages:

Maintain Business Roles: Here you create a space and select the role the space belongs to. See Maintain Business Roles
for detailed information.

The business catalog SAP_CORE_BC_UI_FLD is assigned to you. It contains the following apps.

Manage Launchpad Spaces app: Here you create and manage spaces and you de ne the page assignment. You
can also check to which business roles a space is assigned. This app has two main views: the spaces overview and

This is custom documentation. For more information, please visit the SAP Help Portal 111
4/9/2023
the space details. See Manage Launchpad Spaces for more information.

Manage Launchpad Pages app: Here you e.g. create new pages, de ne the page content and edit existing pages.
This app has two main views: the pages overview and the page details. See Manage Launchpad Pages for more
information.

The business role template SAP_BR_ADMINISTRATOR provides access to the catalog.

The adaptation transport organizer (ATO) has to be con gured and activated. When you create, copy or delete spaces or
pages, the spaces or pages are transported using the ATO. For related information see the blog entry Essentials:
Transport and Extensibility Scenarios.

When you want to translate your own pages and spaces, you can use the built-in translation option. See Translating a
Space and Translating a Page.

How to Create and Assign Spaces and Pages


To create a new space and page and make it available for a speci c user group you need to perform different steps.

The following image shows an overview of the steps necessary to create and assign spaces.

This image is interactive. Hover over each area for a description. Click highlighted areas for more information.

Please note that image maps are not interactive in PDF output.

 Note
There are several possible sequences to perform the different tasks, but keep in mind that you need to carry out all steps
before the new page is visible for your users.

Which sequence is best for you, depends on your system con guration and your authorization management. You need to
have the rights to manage roles or work with someone who has it.

Spaces also have to be enabled in your system. In most systems this is already done, if not, you can enable spaces yourself
(see Enabling Spaces for the different options).

Also see section Tools and Prerequisites for Managing Spaces and Pages to inform you what is necessary to perform all steps.

This is custom documentation. For more information, please visit the SAP Help Portal 112
4/9/2023

Relations
The following image shows how the different objects work together.

Relations of spaces, pages, catalogs, roles and users

Scenarios
In general, you can always decide to create pages or spaces from scratch or start with SAP-delivered spaces or pages.

Step by Step: Create a New Space and Page for a Business Role shows a top-down process with all necessary steps to create a
completely new space and page for a speci c business role.

Working with Prede ned Spaces and Pages


A space and page delivered by SAP can be used directly (when you work with role templates provided by SAP) or as a starting
point to create your own space and page for a business role.

SAP provides spaces (space templates) and pages for different business role templates. An SAP-delivered space contains one
or more pages de ned by SAP. The pages contain the apps that are relevant for the users with that speci c role.

The Prede ned spaces overview tab in the Manage Launchpad Spaces app contains all spaces provided by SAP or that are
available for your product scope. SAP uses the following name scheme: The space ID has the same name as the business role
template the space is created for: SAP_BR_<BASE_ROLE>[_<CONTEXT>], for example SAP_BR_AR_ACCOUNTANT. The space
title re ects the work area that the space is designed for. You can use this information to identify which spaces might be
interesting for your user group.

The Manage Launchpad Pages app shows a list of all prede ned pages in the pages overview. Click on a speci c page to see the
page details, such as the apps and sections that are prede ned. You can also open the page preview to see how it looks (also
see Editing a Page).

How to work with SAP-delivered spaces and pages


You can directly use SAP-delivered spaces and pages when you work with roles that are based on role templates delivered by
SAP. For this you need to assign the SAP-delivered space to a business role. This is a rather fast way to get started with spaces
and pages.

If you want to change a prede ned space or page, you have to create a copy and use an ID with a customer namespace pre x.
You can decide if you want to copy and assign the pages belonging to a space, too. When you work with your own catalogs, you
can copy the prede ned spaces or pages to your system and assign them to your business role. Then you can see how the SAP-
delivered spaces and pages look.

This is custom documentation. For more information, please visit the SAP Help Portal 113
4/9/2023
The Prede ned Spaces Overview tab contains all of the spaces from SAP that are available for your SAP product scope.
Eligibility is checked for roles, spaces, pages, and apps so you will only see objects within your SAP product scope for the page
creation.

Technically, an SAP-delivered space is assigned to a business role template. By this connection, either the SAP-delivered spaces
can be assigned directly, or a space derived from an SAP-delivered space can be created for a business role based on the
business role template in the Maintain Business Roles app. You can use an SAP-delivered space to easily create a customized
space and page for a role.

Assigning and working directly with SAP-delivered roles and spaces


When starting with spaces and pages, you can apply the SAP-delivered spaces to several roles at once. This feature can also be
used for example for derived/region-speci c roles, where all users with the general role also should have at least one of the
derived roles. For this you can use the mass change option in the Maintain Business Roles app. See Assigning Spaces to Several
Business Roles at Once and Mass Changes for detailed information.

For country/region-speci c business roles, when a user has both roles (for example the general role and the Italian country role)
and you use both associated SAP-delivered spaces, the content of both will be merged: Additional apps or sections with apps
will be added to the SAP-delivered pages of the respective SAP-delivered space.

The pages are merged automatically; the users will see one space with all apps from the SAP-delivered spaces. This works best
when you use business role templates from SAP as a basis, as this ensures that the user has access to all the apps in a space
(the catalog assignment is done by business role assignment).

Note that the SAP-delivered spaces and pages are read-only. Customer administrators can't edit these, but need to create a
copy to edit them. Assigned SAP-delivered spaces and pages are updated automatically, when SAP provides a new version.
Note that users can personalize the SAP-delivered pages (when personalization is enabled by the customer administrator), the
personalization is kept when an SAP-delivered space or page is updated by SAP.

Copying and customizing SAP-delivered spaces


When you want to start with an SAP-deliverd space and then adjust it to your needs, you have to copy it rst. There are two
ways to copy SAP-delivered spaces:

Create a new space from an SAP-delivered space and directly assign it to the role in the Maintain Business Roles app.
Select the Create and Assign Launchpad Space based on SAP-Delivered Space option in the Maintain Business Roles
app (see Assigning a Space to One Business Role).

Copy an SAP-delivered space to your system in the Manage Launchpad Spaces app (see Copying a Space). When you
use this option, the space ID, title, description, and the page or pages with apps from the SAP-delivered space are
assigned to the new space, but the space is not assigned to a role. You need to assign the space to see which apps are
available for the users.

After the copy process you can then use the space and pages "as is" or adapt them to the speci c needs of your user group.
There are several ways to adapt a page: You can see all pages that belong to a space in the Manage Launchpad Spaces app
(Pages tab), or see all pages in your system in the Manage Launchpad Pages app. Select a page and click Edit.

Related Information
Step by Step: Create a New Space and Page for a Business Role
Editing a Page
Manage Launchpad Spaces
Manage Launchpad Pages

This is custom documentation. For more information, please visit the SAP Help Portal 114
4/9/2023

Assigning Spaces
To make a space available for users, it has to be assigned to the user's business role.

No matter if it is a SAP-delivered space, a newly created space or a copied space: a space always needs to be assigned to the
business role of the users so that it is visible for them. You can also assign a speci c space that is already assigned to another
role. It is also possible to assign several spaces to one role by repeating this process, or assign a space to several business roles.

The launchpad offers several options to assign spaces to roles:

Assigning Spaces to Several Business Roles (see Assigning Spaces to Several Business Roles at Once)

Assigning a Space to One Business Role

 Note
Please note that local changes are not possible at all in a productive system if the Adaptation Transport Organizer (ATO) is
con gured. In this case, the space assignment in the Maintain Business Roles app can't be edited. Switch for example to your
quality system to create and assign pages and spaces.

Related Information
Working with Prede ned Spaces and Pages

Assigning Spaces to Several Business Roles at Once


When you have a space that is designed for a group of related business roles (e.g. country-speci c roles or subroles) you can
assign it to several business roles at once.

Depending on the space type (SAP-delivered space or customer-de ned space) there are different ways to assign the spaces in
the Maintain Business Roles app:

1. Use the button Assign Launchpad Spaces (for a customer-de ned space): this is described below.

2. Use the Mass Change Wizard – Assign Launchpad Spaces option (for customer-created or SAP-delivered space). How
to work with the Mass Change Wizard is explained in How to Make Mass Changes to Business Roles.

3. Use the Mass Change Wizard – SAP-Delivered Spaces for Business Role Templates option (for SAP-delivered spaces).
How to work with the Mass Change Wizard is explained in How to Make Mass Changes to Business Roles.

How to assign a space with the Assign Launchpad Spaces option:


1. Open the Maintain Business Roles app (see Maintain Business Roles for detailed information).

2. Select all roles to which the space should be assigned.

This is custom documentation. For more information, please visit the SAP Help Portal 115
4/9/2023

3. Click Assign Launchpad Spaces. A dialog showing all de ned spaces is displayed.

4. Select the space that should be assigned to the selected business roles and click OK.

Assigning a Space to One Business Role


You can assign a space also when editing a business role.

This is custom documentation. For more information, please visit the SAP Help Portal 116
4/9/2023
When you are editing a role, you can directly assign a SAP-delivered space or an existing customer-de ned space, or you can
create a new space from scratch or based on an SAP-delivered space.

1. Open the Maintain Business Roles app (see Maintain Business Roles) and select the business role that you want to
assign a space to.

2. Go to the Assigned Launchpad Spaces tab. The tab shows which spaces are assigned to the role and you can add spaces
to the role or remove spaces from it. Click  to sort the spaces. Note that this only applies to the sorting in this list.
How the spaces in the launchpad user interface can be sorted is explained in Sorting the Spaces.

3. Click Edit and then click on Add to add a space to this role.

 Note
Please note that local changes are not possible at all in a productive system if the Adaptation Transport Organizer
(ATO) is con gured. In this case, the space assignment in the Maintain Business Roles app can't be edited. Switch e.g.
to your quality system to create pages and spaces.

4. The Add Launchpad Space dialog opens. First, select if you want to use an existing space, or to create a new space in the
Assign Space to Business Role eld. You have four different options:

a. For many business roles, a SAP-delivered space with prede ned pages is available (see Working with Prede ned
Spaces and Pages). Then you have two options:

You can either create a new space based on the SAP-delivered space with the option Create Spaces
Based on SAP-Delivered Spaces. The dialog suggests a new space ID, description, and title based on the
information given by SAP. You can modify all three entries if necessary. For some roles, several SAP-
delivered spaces are available. Then you can choose additional SAP-delivered spaces that should also be
copied and assigned to this role by clicking on the + icon.

Click Create and Assign Space to create a customer-speci c copy of the space or spaces and directly
assign it to the selected role. You then return to the Assigned Launchpad Spaces tab. The assigned space
is shown in the list. Save the business role and leave the app.

You can work directly with the SAP-delivered space. For this select the option Use SAP-Delivered Space
and select a space from the list of SAP-delivered spaces. Note that all spaces delivered by SAP are shown.
The space titles relate to the work area; in addidtion, you can nd out which SAP-delivered space was
created for a speci c role template in the Business Role Templates app.

This is custom documentation. For more information, please visit the SAP Help Portal 117
4/9/2023
b. You can create a new space with pages for the business role. This is described in detail in Step by Step: Create a
New Space and Page for a Business Role. The Create Page from Business Catalogs and Groups checkbox
determines if the page should contain the content provided by the groups. With this option, you can create a page
that is based on the classic home page for this user group (see Creating a Space and Page with the Home Page
Content). If you deselect it, an empty page is created and you can de ne content from scratch. Click Create New
Space.

c. You can assign an already existing launchpad space to the role. Choose Use Existing Space and the Select a
Space eld is displayed. Click in the eld to show a list of all of the spaces available in your system. Select the
respective space from the list. The list closes. Click Assign Space to proceed and return to the Assigned
Launchpad Spaces tab. The assigned space is shown in the list. Save the business role and leave the app.

The role assignment is also shown in the Manage Launchpad Spaces app: in the Roles column of the space overview or in the
space details Roles tab.

You can also assign one space to several roles at once. This is explained in Assigning Spaces to Several Business Roles at Once.

Removing a Space from a Business Role


You can remove a space assignment from a business role.

In general, there are two ways to remove spaces: You can remove a space from a speci c role (described below), or you can use
the Mass Change Wizard and select all roles from which you want to remove the assigned spaces. How to work with the Mass
Change Wizard is explained in How to Make Mass Changes to Business Roles

1. Open the Maintain Business Roles app and select the business role for which you want to change the space assignment.

2. Go to the Assigned Launchpad Spaces tab and click on Edit.

3. Checkmark one or more spaces that you want to remove from the role and click on Remove.

4. Save the role.

Please note that this only removes the assignment of the space to a business role. The space and the related page are not
deleted. If you already use the space mode productively, you should assign a different space to the role. Otherwise it might be
that the users don't have a space and page assigned to them anymore and see an empty page.

Related Information
Step by Step: Create a New Space and Page for a Business Role

Step by Step: Create a New Space and Page for a Business Role
This is a step-by-step procedure to set up a new space with one or more pages for the users assigned to a speci c business role.

There are several ways to set up spaces and pages. In the following instructions, we describe a complete top-down procedure
where you start from scratch. Check the Tools and Prerequisites for Managing Spaces and Pages section to see if you have all
necessary tools and rights.

1. Open the Maintain Business Roles app and select the business role for which you want to create a space and a page (see
Maintain Business Roles).

2. Go to the tab Assigned Launchpad Spaces and click on Edit. Then click Add to add a space to this role.

This is custom documentation. For more information, please visit the SAP Help Portal 118
4/9/2023

 Note
Please note that local changes are not possible at all when you are working in a production system and the
Adaptation Transport Organizer (ATO) is con gured. In this case, the space assignment in the Maintain Business
Roles app can't be edited. Switch e.g. to your quality system to create spaces and pages.

3. The Add Launchpad Space dialog opens. Select the Create New Space option in the Assign Space to Business Role eld.
The Create Page from Business Catalogs and Groups checkbox determines if the page should contain the content
provided by the groups. With this option, you can create a page that is based on the classic home page for this user
group (see Creating a Space and Page with the Home Page Content). Deselect it to create an empty page.

4. For a new space you need to enter the following information:

The space ID. It is mandatory, it starts with a Z, can't start with a number, and can't contain special characters.
The ID should be no longer than 32 characters. Please note that you can't change the ID afterwards.

A mandatory description for the space. It can be up to 100 characters long.

A mandatory title for the space that can be up to 100 characters long. To ensure a consistent user experience, we
suggest you use title case and nouns. Users will see the title in the launchpad navigation bar.

5. Click Create and Assign Space. The new space is assigned to the selected business role and shown in the Assigned
Spaces list.

6. Click on the space entry in the list to go to the space details view of the Manage Launchpad Spaces app (see Details
View for Spaces). Note that you are now in a different app and your changes to the role have not been saved yet. This is
done in step 12.

Here you see the space information in the Pages tab. It shows the empty page that was created and assigned to the
space. The page ID is entered automatically as it is identical to the space ID. The page title and description are also
copied from the space. Both can be changed if necessary. Here you can also add other pages to the space (see Details
View for Spaces).

7. Now you need to de ne your page content. Click on a page to see or edit it. You are directed to the Manage Launchpad
Pages app (see Manage Launchpad Pages and Page Details).

8. Click Edit to start. De ne one or more sections for your page and add the apps that you want your users to see to these
sections. See sections Editing a Page and Tile Catalogs for a detailed description.

This is custom documentation. For more information, please visit the SAP Help Portal 119
4/9/2023
9. You can check how the page looks for your users. Click Page Preview. You can edit the page further, if necessary.

10. When you are satis ed with the page, save your changes.

11. Return to the Maintain Business Roles app with the back button. The assigned space is shown in the list on the Assigned
Launchpad Spaces tab. Save the business role as well. The space is then automatically assigned to the user group via
the business role.

 Tip
To make the page visible for users, it might be necessary to switch to the spaces mode if not done already. There are two
parameters to do this. See Enabling Spaces for detailed information.

Creating a Space and Page with the Home Page Content


If you want to use the content of the classic home page for the new spaces concept, you can import the content to a new space
and page.

You can import the apps of the classic home page to a newly created space and page. Select Create a New Space in the
Maintain Business Roles app and activate the checkbox Create Page from Business Catalogs and Groups (see Step by Step:
Create a New Space and Page for a Business Role for all the steps necessary).

With the catalogs that are assigned to the business role, it is determined which apps are available for the users with this
business role. The groups that are assigned to the business role determine the layout of the page that will be created. When
you create a space, a new page is created automatically that will contain a section for each group. The section will contain all
apps from the group that are also available in the catalogs. The group title will be used as the new section title. After you have
created the new space and page, you will be redirected to the space in the Manage Launchpad Spaces app that contains a new
page with the apps from the group.

Click on the page and you are redirected to the Manage Launchpad Pages app. You can now edit all the page content that was
created automatically. First check, if all the apps your user group needs, are there. Then remove apps that are not needed. You
can add apps that are helpful for the users as well. See Editing a Page for detailed information on how to work with the editor.

 Tip
Focus on your user group and only show apps on the page that these users really need. You can remove apps or complete
sections that are not necessary for them. You can combine sections by moving apps to one section and removing the other
section. Don't forget that you can also rename a section.

Some guidelines: A page should have no more than ve sections and a section should contain 2 to 8 apps.

Best Practices for Managing Spaces and Pages


Read this for tips on creating and handling spaces and pages.

Context
Spaces and pages offer more exibility to in uence the launchpad layout for different user groups. Each user sees one or more
spaces that contain one or more pages. The pages show apps clustered in different sections. Spaces and pages are assigned to
users via the business roles. Read Managing Launchpad Spaces and Pages for an in-depth description of the concept.

This is custom documentation. For more information, please visit the SAP Help Portal 120
4/9/2023
SAP delivers prede ned spaces and pages for selected business roles. You can use them as model to explore the new layout
concept. Also see Working with Prede ned Spaces and Pages.

Recommendations
When switching to spaces or creating your own spaces, we recommend adhering to the following guidelines:

Consider using SAP-delivered spaces and pages:

For a faster implementation: SAP provides spaces and pages tailored to SAP role templates. You can assign these SAP-
delivered pages and spaces to roles that are based on SAP role templates to provide tting apps to your users. With the
Mass Change wizard in the Maintain Business Roles app you can select several roles and then assign all SAP-delivered
spaces and pages available for these roles in one go. Note that if you select the Use SAP-Delivered Spaces option, you
can’t edit the content provided. When you want to adapt the SAP content, you need to copy the SAP-delivered content
rst.

Structuring recommendations when creating your own spaces and pages:

Keep it simple and lean in the beginning: Create one space per business role. If this is not suitable for the way your roles
are designed, you can also think about either assigning one space to more roles or assigning several spaces to one role.

Less is more: Aim for lean pages. Only add those apps to a page that the users work with regularly. If you allow users to
personalize their pages, they can add further apps to the pages themselves.

A lean launchpad is easier to navigate, and quicker to load. This is especially true for supervisor and
managerial roles, where you are most likely to include dynamic data tiles such as Smart Business KPIs on your page. A
few well-chosen KPIs help your managers focus on maintaining key thresholds. For example, keeping within their
allocated budget, or reaching sales revenue targets. Each KPI comes at a small performance cost of an additional call
to retrieve current KPI data. So, while useful and while some of this data can be temporarily cached to minimize
these data calls, the number of dynamic data tiles should be kept to the essentials.

Consider creating two or more pages for one space if there is a large number of relevant apps. In the SAP-delivered
spaces and pages, the pages re ect the tasks within the work contexts of the user groups.

SAP recommends including no more than ve sections on one page. A section should contain between three and seven
apps. Ideally, there are not more than 25 apps on the whole page.

Re ect “Day in the Life of” working patterns of your users: Focus on the user group for this page and choose the
appropriate apps required by them to ful ll their daily tasks. Structure the pages according to the sequence of tasks
performed by the users.

Apply the “Insight-to-Action Approach”: Offer initial orientation on the page at the top-level entry point ("Insight") and
from there offer drill down to the necessary tasks ("Action"). The idea is to rst help users identify what they need to
work on and then guide the navigation to the actions resulting from the insights.

Aim to be coherent and consistent across all your business roles, e.g. use consistent titles for spaces, pages and
sections etc.

Aim to create reusable pages with a common layout for usage in different spaces.

You can in uence how spaces are sorted in the user interface as described in Sorting the Spaces.

When testing your own spaces, adhere to real-world conditions and keep the number of roles small. You should not
assign too many roles to one user.

Related Information
How to Create and Assign Spaces and Pages
https://experience.sap.com/ ori-design-web/sap- ori-launchpad-spaces/

Manage Launchpad Pages


With this app you can manage the launchpad pages, de ne the layout of pages and edit, copy or delete existing pages.

This is custom documentation. For more information, please visit the SAP Help Portal 121
4/9/2023

Key Features
This app provides the following key features:

See all pages availabe in your launchpad.

De ne the layout of a page and select apps that should be displayed.

Edit an existing page.

Copy an SAP-delivered page or a customer-created page.

Delete a customer-created page.

Supported Device Types


Desktop

Implementation Information
Business catalog: SAP_CORE_BC_UI_FLD

Business role: SAP_BR_ADMINISTRATOR

Pages Overview
When you open the Manage Launchpad Pages app, you see a list of all pages in your system.

By default, the pages are sorted by the Changed On date, the newest page is shown on top. The tab Customer-Created shows
all pages you have created in your system. The tab Prede ned shows all pages provided by SAP (see Working with Prede ned
Spaces and Pages for detailed information).

Manage Launchpad Pages

There are different options available to manage the pages, it also depends if you select a customer-created or prede ned page.
For customer-created pages, the following options are available:

This is custom documentation. For more information, please visit the SAP Help Portal 122
4/9/2023
Search for a page.

Sort, lter or group the list entries to see only pages that t your criteria (see below for detailed information).

Open an existing page to see the content in detail: Click on a page in the list.

Copy an existing page (see Copying a Page).

Edit an existing page (see Editing a Page).

Open a page preview to see how the page looks like for the user (from page details view, also see Selecting a Role
Context).

Delete a page (see Deleting a Page).

 Note
For prede ned pages the options to edit or to delete a page are not available. You can open the page details and the page
preview to see how e.g. an SAP-delivered page looks like. But you need to copy prede ned page to your system rst, before
you can actually work with it. Copying can be done here, in the page details, or in the Manage Launchpad Spaces app, where
you can copy a prede ned space together with its assigned pages.

Select a page and then select the option you want to perform in the header line or next to the page.

Adapting the Pages List


You can in uence in which order the pages should be shown and you can group the pages by certain criteria. By using lters you
can decide which pages should be shown in the list.

To sort your pages according to values in one column, click on  in the header bar. Select ascending or descending order
in the area Sort Order and the column you want to use for sorting in Sort By.

This is custom documentation. For more information, please visit the SAP Help Portal 123
4/9/2023
Define Your Sort Order

The selected sort order is indicated in the column header of the respective column in the page overview with the icons
 for ascending sorting, or  for descending sorting.

To lter the list to only see pages that match your de ned criteria, click on . Click on a column you want to use for
ltering, e.g. Changed By. Then select a value, e.g. your name, to see only pages that apply to the selected value. In our
example, you will only see the pages that were changed by you as the last changer.

You can group the pages according to the values in a speci c column. Click on .

Page Details
The Page Details view is part of the Manage Launchpad Pages app. It shows all information for a page.

You can open this page by clicking on a page in the overview. You might also open the page in the Pages tab of the space details
view in the Manage Launchpad Spaces app. Then you are redirected to this view (also see Details View for Spaces).

Example of a customer-created page

There are three tabs:

General: Shows you all general page information, as e.g. the ID, title, information about who created or changed the
space and when.

Page Content: Shows the page layout with the sections and the assigned apps. When the page is a customer-created
page, you can edit the page content and the page header, copy the page or delete it. You can also open a preview for the
page and adapt this view for one or more roles (see Editing a Page).

When the page is prede ned (by SAP), you can see the layout and you can open the page preview. You can't edit a
prede ned page or select a role context for it. To do this, you need to copy the page rst. By this, you create your
customer-speci c version of the page that you can edit afterwards (see Copying a Page).
This is custom documentation. For more information, please visit the SAP Help Portal 124
4/9/2023
Space Assignment: Shows to which spaces this page is assigned to. To sort your spaces according to values in one
column, click on  in the header bar. Select ascending or descending order in the area Sort Order and the column you
want to use for sorting in Sort By.

When you click on a space in the list, you are redirected to the space details of the space in the Manage Launchpad
Spaces app. With the button Manage Launchpad Spaces you open this app with the spaces overview.

Creating a Page
Learn how to create a page for a speci c user group.

Here we describe how you create an empty page from scratch.

How to Create a Page


1. Select Create in the Manage Launchpad Pages app or select the option Also Create a Page, when creating a new space
in the Manage Launchpad Spaces app.

2. In the Create dialog, enter an ID for the page. The ID of customer-de ned pages must start with a Z. The ID can only
contain letters, 0-9 and _ or /. Other special characters are not allowed. The ID cannot be changed afterwards.

3. Enter a description for the page. It will be shown e.g. in the Manage Launchpad Spaces app.

4. Give a short describing title for the page in the eld Title. The title will be shown in the space menu.

5. Click on Create to generate the page. An empty page is displayed in the edit page view. See Editing a Page to learn how
to add apps to your new page.

 Note
Keep in mind that a page always has to be assigned to a space to make it available to your users. If you have created a page
from scratch, you need to assign it in the Manage Launchpad Spaces app. Read Details View for Spaces for a description.

Editing a Page
Learn how to add apps to a new page and adapt an existing page.

You can open the edit page mode by clicking Edit in the page details or in the page overview. The gure shows an example page
in edit mode.

This is custom documentation. For more information, please visit the SAP Help Portal 125
4/9/2023

Editing a page

How To Edit the Page Header


You can change the page title or the page description if necessary. Go to the tab General Data and enter new values. Note that
you cannot change the page ID.

How to Edit the Page Content


1. Open the Tab Page Content.

2. There is already one empty section in the page. Enter a meaningful name for it.

3. Add more sections to your page if useful.

4. Add apps from the tile catalogs to the sections. If the list of tile catalogs is not displayed, click on Show Catalogs. See
section Tile Catalogs to learn which tile catalogs and apps are shown here.

5. You can search for an app in the tile catalogs list or in the search eld. You can also lter the list according to different
criteria. See Tile Catalogs for detailed information.

6. Click on Add to add it to one section or drag and drop the app to a section. You can select different tile sizes or select the
link layout by clicking on the arrow next to Add. Select an option to add the app accordingly. When you don't select an
option here, the app is added in the preferred tile size (usually as standard tile). Flat and at wide tiles are added in a
new row below the standard-sized tiles. Links are added in an area below the tiles in the selected section the same way
as in the home page. See Tiles, Links and Tile Sizes for more information on the different tile size options.

7. You can also select several apps by ticking the boxes in front of each app title. When you have selected all apps you want
to assign to a section, click on Add in the catalog header. You can select a tile size or the link layout by clicking on the
arrow next to Add and selecting the appropriate entry. Select one or more sections in the list and click Add.

8. Save your changes.

This is custom documentation. For more information, please visit the SAP Help Portal 126
4/9/2023

 Note
Sometimes apps with the same title appear several times in the tile catalog. This happens if there are apps with e. g.
different targets, e. g. on a desktop or on a mobile. An icon shows for which target the app is intended.

When you edit a page that is personalized by a user, the personalizations are kept.

When you work on a smaller device, e.g. a tablet, or zoom in, the tile catalogs list might be hidden. You can then switch
between the page and the tile catalogs list with the buttons Show Catalogs and Show Page.

 Tip
We collected a list of helpful tips how to create a meaningful page in Best Practices for Managing Spaces and Pages.

Check for Possible Issues


If there are errors or inconsistencies on the page, you are noti ed. A message icon showing the number of problems is displayed
in the footer. Click on the message icon in the footer to see more information on the issues.

Dialog showing two messages for a page

There are three different kinds of messages that are also re ected in the icon color. The message icon color always presents
the highest existent severity:

Information: informs about a display issue, e.g. if you have not assigned the page to a space or the space to a role. The
message icon will be displayed in gray.

Warning: displayed for inconistencies, e.g. when a section title is missing, as SAP recommends this to ensure a consistent
user experience. You need to con rm the warning when you save a page. The message icon will be displayed in orange.

Error: prevents you from saving a page. A message is displayed when you try to save. Errors may occur e.g., if you have
selected a tile that cannot be displayed for the users in a page. The app then is displayed in a failed state with an x). For
example, this can be a tile with an incorrect target mapping or a tile that is not available for the user (due to the role
assignment or the business catalog assignment). The message icon will be displayed in red.

If a tile is involved, the tile information popover also shows information about the problem. It can be opened by clicking on the
tile.

Show Preview
To see how a page actually looks like you can open the page you edit in a preview. Click on Page Preview. The preview is opened
in a popover. If you select a speci c role, the page preview shows how the page will look like for the users with this role (see
Selecting a Role Context).
This is custom documentation. For more information, please visit the SAP Help Portal 127
4/9/2023

Tile Catalogs
The catalogs show the apps that you can add to the page.

The catalog view is part of the Edit Pages view. A catalog contains a collection of apps. You select the apps here to add them to
the page.

The catalog view has two tabs:

Derived From Roles: Depending on the role assignment of the page you can see one or more catalogs. If you have no role
assignment yet, this list is empty.

Manually Selected: This list shows all catalogs you have manually added for the page. In the beginning, this list is empty.
You can add all catalogs you need to the list.

 Note
The authorization to see and use a speci c app and the corresponding tile is checked on catalog level, based on the tile
intent. Therefore, users see only those tiles on a page that are referenced from a catalog that is part of a role the user is
assigned to. In addition, the corresponding target mapping needs to be part of an assigned catalog.

If the catalog view is not shown, click on Show Catalogs. You can change the sort order of the catalogs with .

Each app in a catalog has an entry showing the app title and subtitle. When you click on the information icon, additional app
information is displayed (also see Tile Information).

Adding Catalogs
You can add all catalogs available in your system to the tab Manually Selected. So you can access all apps independent of the
catalog's role assignment. You need to do this when the space is not assigned to a role and thus no catalogs derived from the
role are available.

1. Click on Catalogs (or click on the More icon and select Catalogs).

2. In the Select Catalogs view, check one or more catalogs you want to use for the page design. You can search for any
catalog.

3. Click on Select. The catalogs and the apps assigned to them are added to the Manually Selected tab.

 Note
When you add apps from catalogs that are not from a catalog assigned to the roles of the user, theses apps will not be
shown to the user.

How to Add Apps to the Page


There are three options to select apps for the page:

You can drag and drop an app from the catalog to a section.

You can click on Add next to the app title. Select the section or sections to which you want to add the app in the popover.

You can select several apps by marking the checkboxes in front of the apps. Then you add them all to one or more
sections by clicking on Add in the tool bar above the catalog view. Select the section or sections to which you want to add
the app in the popover.

This is custom documentation. For more information, please visit the SAP Help Portal 128
4/9/2023

Tile Information
For each app, detailed information is available.

You can open detailed app information for apps assigned to the page by clicking on the app (when you view a page in the page
details) or by clicking on the over ow icon  when you are editing a page.

This is custom documentation. For more information, please visit the SAP Help Portal 129
4/9/2023
The pop-over shows detailed information e.g. for the semantic object that is used, the Fiori ID, the app detail or the tile type. You
can see, in which technical and business catalogs the tile is contained. You can also see for which devices the app is available:
desktop, tablet and/or mobile. Here you can e.g. change the tile size of an assigned app or convert it to a link. Select a new
entry in the eld Tile Size. Preferred indicates the preferred tile size the tile was designed for.

 Note
Custom tiles might only be displayed in the standard tile size here (they show a Custom tag to identify them). In the actual
page they will be displayed in the designed size, e.g. wide for news tiles.

Each app in a catalog has an entry showing the app title and subtitle. When you click on the information icon, additional app
information is displayed. The pop-over shows nearly the same information as described above.

Selecting a Role Context


By selecting one or more roles for a page in edit mode or the preview, you can see which apps a page contains for speci c user
groups.

In the edit mode you may see catalogs from different business roles for your page, if you have assigned the space that contains
the page to several business roles. (This can be done if you select the option Use Existing Space, when assigning spaces to
roles. See Assigning a Space to One Business Role for additional information.) In addition, you might have added more catalogs
manually (see Tile Catalogs) and have selected apps from those catalogs. Apps from manually selected catalogs are always
shown in a dimmed grey and have a warning because they have no role assigned.

You can lter the tile catalogs list, the edit view and the page preview to one or more speci c roles. By this you see only the apps
available for this speci c role(s). Click on Select Role Context and select the roles. The button text shows the number of roles
you have selected. In addition, the catalog view header indicates that you have ltered the tile catalogs list.

The preview will show all apps that are available for the selected roles according to the catalog assignment. By this you can can
check how the page will be displayed for a user with one or more roles. When you have apps that are not assigned to a catalog
of the role, you need to deselect all roles in Select Role Context to see them. The preview then shows all apps independend of
the role assignment.

Translating a Page
You can localize a page for another language.

If you want to translate a speci c page, you have two options:

1. Use the Maintain Customizing Translations app (see for detailed information).

2. Export XML les of the page, translate the texts and upload the translated les. This is described below.

Translating page content using an XML le


Open the Manage Launchpad Pages app and then open the page in edit mode. Then select Translate and Download. In the
opening dialog, select one or more languages, to that this page should be translated. Click on Download.

This is custom documentation. For more information, please visit the SAP Help Portal 130
4/9/2023

Language selection when translating a page

A zip le with an XML le for each selected language will be created and saved on your computer. The folder name contains the
page ID, the system name and the export date. The le name of the exported XML le consists of the language codes of source
and target language and the page name, i. e. EN_DE_ZBR_PRODN_ACCOUNTANT.xml. The XML le contains the translatable
text for the selected page: the page title and the section titles. If some text is already translated, the translated text is also
exported.

Translate the texts and then pack the the XML les in a zip le. Note that you should only compress the les, not a folder. You
don't have to import the les all at the same time, you can import one or more language les rst and repeat the import later
for other languages. Then you have to import the .zip folder in the Manage Launchpad Pages app. Open the page you have
translated in the edit mode. Then select Translate and Upload. Select the .zip folder. The translations are imported.

See Translating a Space for further information.

Copying a Page
You can copy an existing customer-created page or an SAP-delivered page and then edit the new page.

Select the page you want to copy in the Manage Launchpad Pages app, either in the overview or in the page details view. You
can nd the pages from SAP on the tab Prede ned in the overview. Pages from SAP have to be copied to your customer system
before you can use or edit them. Read Working with Prede ned Spaces and Pages rst for a detailed description how to work
with the feature.

This is custom documentation. For more information, please visit the SAP Help Portal 131
4/9/2023
Click on Copy and a dialog is shown where you enter a new page ID, a description, and a title. The page ID has to start with Z_ ,
as you can only add pages to this namespace, which is reserved for your customer-created objects.

Example of a Copy Page Dialog

Note that you need to assign the page to the space of the user group to make it available for the users.

Deleting a Page
You can delete a page that is no longer needed.

In the Manage Launchpad Pages app, you can delete an existing customer-created page. To delete a page, select it and click on
Delete in the pages overview or in the page details. Con rm the warning message. The page will be deleted from the system.

You should check that you don't delete the only page in an assigned space, or assign a different page to this space when you
delete the only page. You see all assigned pages in the Overview of Launchpad Spaces. If an assigned space doesn't contain a
page anymore, users might see an empty space in their launchpad.

Manage Launchpad Spaces


With this app you can create and manage spaces for the SAP Fiori launchpad. With spaces you can design the launchpad layout.
Spaces are organizational units that combine several pages in a menu that is shown in the navigation bar of the launchpad. The
pages then contain the apps for the end users. The app provides an overview showing all spaces available in your launchpad and
a detailed view for the spaces.

Key Features
You can use this app to:

Manage existing spaces

Create new spaces

See and sort the pages that belong to the space

Add or remove pages to or from a space


This is custom documentation. For more information, please visit the SAP Help Portal 132
4/9/2023
See to which role or roles the space is assigned to

Edit space title and description

Supported Device Types


Desktop

Implementation Information
Business catalog: SAP_CORE_BC_UI_FLD

Business role: SAP_BR_ADMINISTRATOR

Overview of Launchpad Spaces


The Manage Launchpad Spaces Overview displays all available spaces and offers options to manage your spaces.

There are two different lists available: the customer-created spaces and the prede ned spaces. You can switch between the two
lists with the tabs over the list. By default, the space changed as last one is shown on top of the list. The following gure shows
an example of a list of customer-created spaces.

Spaces overview in the Manage Launchpad Spaces app

The Prede ned list contains all spaces from SAP that are available for your product scope (see Working with Prede ned
Spaces and Pages for detailed information). As the prede ned content cannot be changed, you can open the space
details by clicking on a space in the list, but you are not allowed to modify these spaces.

The Customer-Created list contains all spaces you have created yourself. You can create a new space here, copy or
delete an existing space. Click on a space in the list to go to the space details view. Or click on the pencil icon to directly

This is custom documentation. For more information, please visit the SAP Help Portal 133
4/9/2023
open the space in the edit mode. See Details View for Spaces for more information.

In both lists, you can search for a space, lter the list, or sort the list according to your own sort criteria.

Adapting the spaces lists


You can in uence in which order the spaces should be shown and you can group the spaces by certain criteria. By using lters
you can decide which spaces should be shown in the list.

To sort your spaces according to values in one column, click on  in the header bar. Select ascending or descending
order in the area Sort Order and the column you want to use for sorting in Sort By.

The selected sort order is indicated in the column header of the respective column in the page overview with the icons
 for ascending sorting, or  for descending sorting.

To lter the list to see only spaces that match your de ned criteria, click on . Click on a column you want to use for
ltering, e.g. Changed By. Then select a value, e.g. your name, to see only spaces that apply to the selected value. In our
example, you will only see the spaces that were changed by you as the last changer.

You can group the spaces according to the values in a speci c column. Click on  and select a value.

Details View for Spaces


The details view shows all information on spaces and the pages assigned to the spaces.

The view has three different tabs:

General: shows space information as e.g. space ID, title and creation information

Pages: shows all pages that are assigned to the space

Roles: shows all roles the space is assigned to

Details of a Space with Two Pages

Note that you can only edit information for a customer-created space. When you have opened an SAP-delivered space you can
only view the information or copy the space to create a customer space based on it.

Viewing general space information

This is custom documentation. For more information, please visit the SAP Help Portal 134
4/9/2023
In the General tab you can see all general space information, as e.g. the title, information about who created or changed the
space and when. You can edit the title and the description. The title will be shown in the navigation bar of the launchpad. Note
that you cannot edit the space ID.

Viewing the page assignment


In the Pages tab you can see and add or remove the pages that are assigned to the space. In addition, you can de ne the order
the pages are later shown in the space menu in the navigation bar of the launchpad. The page visibility de nes if a page is
displayed in the launchpad.

Viewing roles
The Roles tab shows the business roles the space is assigned to. With the button Maintain Business Roles you can directly open
the Maintain Business Roles app where you can see and edit how the spaces are assigned to a role.

Related Information
Editing a Space

Creating a Space
Learn how to create a launchpad space.

A space is an organizational unit that contains one or more pages. It can be assigned to one or more business roles. The pages
contain the apps the user works with. A space is shown in the navigation bar of the launchpad. When you click on it, the rst
page of the space is shown. When you click on the arrow next to the space title, a menu with the pages assigned to this space is
shown. Spaces and the associated pages are assigned to users according to their roles. So, the space and role relation
determine, which apps the users will see in their launchpad.

The option to create a new space is available in different apps, e.g. in the Manage Launchpad Spaces app or in the Maintain
Business Roles app. These options give you more exibility where to start de ning your spaces: You can start by attaching a
space to a role or by de ning a space from scratch rst.

You can create a space based on a prede ned space with the copy option (see Copying a Space) or you can create a new and
empty space as described in the following section.

How to create a new space


1. In the Manage Launchpad Spaces app, click on Create.

This is custom documentation. For more information, please visit the SAP Help Portal 135
4/9/2023

Dialog to create a space with a page

2. Enter a unique space ID, a description and a title for the space. All three entries are mandatory. The space ID has to start
with a Z. Note that you cannot change the space ID anymore. The space title will be shown in the navigation bar.

3. You can decide, if you want to create a page for the new page now, too. Select Also create a page and enter a page ID, a
description and a title for the page. All three entries are mandatory. The page ID must be unique, and it has to start with
a Z. The title will be shown as a menu item in the space menu. See Manage Launchpad Pages for detailed information.

4. Click on Create to create the new space and page, if applicable. The new space is displayed in the spaces detail view.

 Note
When you have created the space, you can add existing or new pages in the space details view. Don't forget to assign the
space to the business role or roles it is designed for.

Editing a Space
You can edit general space information, assign new pages to a space or remove currently assigned pages in the Manage
Launchpad Spaces app.

Editing the general space information


In the General tab you can see all general space information, as e.g. the title, information about who created or changed the
space and when. You can edit the title and the description. The title will be shown in the navigation bar of the launchpad. Note
that you cannot edit the space ID.

This is custom documentation. For more information, please visit the SAP Help Portal 136
4/9/2023

Editing the page assignment


In the Pages tab you can see and add or remove the pages that are assigned to the space. In addition, you can de ne the page
order and the page visibility.

Add or remove pages: The list on the right side shows you all pages available for the launchpad. You can select one or
more pages and then click on Add or drag & drop them.

De ne the page order: The order here determines how the pages are shown in the space menu for your users. The rst
page is displayed, when a user clicks on the space name. The rst page of the rst space is shown, when a user clicks on
Home. You can sort the pages with the arrow up and down keys or by drag & drop.

Set page visiblity: You can decide to hide a page so that your users won't see it by clicking on Set Hidden. You can e. g.
hide a page, when you are editing it and don’t want to show it to your users yet.

 Note
When you work on a smaller device, e.g. a tablet, or zoom in, the list of selectable pages is hidden. You can then switch
between the list of available pages and the list of assigned pages with the buttons Show Available Pages and Show Selected
Pages.

Copying a Space
Learn how to copy a prede ned space, e.g. an SAP-delivered space or an existing customer-created space.

When you want to use a prede ned space for your users or when you want to create a new space that is similar to one of the
existing spaces, you can copy the space. During the copy process you can decide how to handle the pages that are assigned to
the space. Afterwards you can adapt the copied space to your needs. Please read Working with Prede ned Spaces and Pages
rst to understand how they work exactly.

1. Select the space you want to copy in the overview or in the space details view of the Manage Launchpad Spaces app.

This is custom documentation. For more information, please visit the SAP Help Portal 137
4/9/2023
Copy a space step 1

2. Enter a unique space ID, a description and a title for the new space. All three entries are mandatory. The space ID must
be unique and has to start with a Z. Note that you cannot change the space ID anymore. When you have entered all
information, click on Step 2.

3. Select how to proceed with the pages that are currently assigned to the original space. You can decide to ignore them
(Ignore All), you can assign the existing pages to the new space (Assign All) or you can copy the pages (Copy All). It is
also possible to select different options for each page: Select an action for the page in the list column Page Action. When
you copy a prede ned space, you can only copy or ignore the assigned pages; prede ned pages cannot be assigned
directly.

Copy a space step 2

4. If you have selected pages to be copied, you now need to enter a new page ID, description and title for each page. The
page ID must be unique, and it has to start with a Z. When you are done, click on Review to see a preview of the new
space with the selected pages.

This is custom documentation. For more information, please visit the SAP Help Portal 138
4/9/2023
5. Click on Edit if you want to change the space details or the selected pages. When you are satis ed with the new space,
click on Save. The space then is added to the customer-created spaces list.

 Note
You can add new or existing pages to the new space in the space details view. Don't forget to assign the new space to
the business role or roles it is designed for (see Assigning a Space to One Business Role).

Translating a Space
You can localize a space for another language.

If you want to translate a speci c space, you have two options:

1. Use the Maintain Customizing Translations app (see for detailed information).

2. Export XML les of the space, translate the texts and upload the translated les. This is described below.

Translating space content using an XML le


If you want to translate a speci c space, open the Manage Launchpad Spaces app and then open the space in edit mode. Then
select Translate and Download. In the opening dialog, select one or more languages, to that this space should be translated.
Click on Download.

Language selection when translating a space


This is custom documentation. For more information, please visit the SAP Help Portal 139
4/9/2023
A zip le with an XML le for each selected language will be created and saved on your computer. The folder name contains the
space title, the system name and the export date. The le name of the exported XML le consists of the language codes of
source and target language and the space ID, i. e. EN_DE_ZBR_PRODN_ACCOUNTANT.xml. The XML le contains the
translatable text for the selected space: the space title and the description. If some text is already translated, the translated
text is also exported.

Translate the texts and then pack the XML les in a zip le. Note that you should only compress the les, not a folder. You don't
have to import the les all at the same time, you can import one or more language les rst and repeat the import later for
other languages. Then you have to import the .zip folder in the Manage Launchpad Spaces app. Open the space you have
translated in the edit mode. Then select Translate and Upload. Select the .zip folder. The translations are imported.

See Translating a Page for further information.

Deleting a Space
You can delete a space that is no longer used.

To delete a space select the option Delete in the spaces overview or the space details. Con rm the security prompt and the
space will be deleted from your system. Note that you cannot delete a space that is still assigned to a rule. You can remove the
role assignment in the Maintain Business Roles app.

See Removing a Space from a Business Role.

Sorting the Spaces


You can in uence the sort order of the spaces in the launchpad UI in different ways.

There are several ways to control in which order the spaces are displayed in the navigation bar of the launchpad user interface
(see Spaces and Pages for the user view).

First, you can decide, if the spaces should be sorted by space ID or by space title. This can be controlled with the launchpad
con guration parameter SPACES_SORT_CRITERION. The default sort criterion is space title. Sorting by title gives you more
exibility as you may change the title later; the space ID can't be changed after you have created the space. How to set the
parameter is explained in Manage Launchpad Settings.

 Note
The spaces are sorted lexicographically in both cases and capitalization is considered. Spaces are sorted according the
following criteria: Special characters ( e.g "_", "-" and "/") are sorted rst, then numbers, then small letters before capital
letters ( e.g. abc before aBC).

If this sorting is not sufficient, you can enhance it by adding individual priority values to selected spaces. You can add priority
values from -100 to 100. Imagine this as as scale spanning from -100 to 100: The lower the value of the priority, the further left
the space is shown in the navigation bar. The value indicates the position: -100 means that this space will be shown as rst
space. It is not necessary to assign priorities to all spaces. A space with no de ned priority value will be handled as having
priority 0. Spaces with the same sort priority will be sorted according to the space title or space ID (as de ned with the
parameter SPACES_SORT_CRITERION).

When you de ne priorities, remember that the individual users won't see all the spaces but only those spaces that are assigned
to their user roles. So, it is probably not necessary to de ne values for all spaces and a strict hierarchy, but rather sufficient to
only de ne sort priority values for the most important and the least important spaces.

This is custom documentation. For more information, please visit the SAP Help Portal 140
4/9/2023
It is not possible to de ne different sort priorities for a space that is used for different roles. If you want to de ne different sort
priorities in different contexts, you need to copy the space and then add a different priority to the new copied space.

Example, how spaces are sorted according to priorities

Space Title Sort Priority Position

ZFavorites -100 1

Z_BR_Employee -20 2

Z_BR_BILLING_CLERK 0 3

Z_BR_BILLING_SUPERVISOR 0 4

Z_BR_RERTURNS_REFUND_CLERK 50 5

How to enter a sort priority


You enter the sort priority values in the Manage Launchpad Spaces app in the tab General. Search the space you want to give a
sort proirity value. Open the tab General and click on Edit. Enter a value from -100 to 100 in the eld Sort Priority. Values may
include up to three decimal numbers. Save your changes and process with the next space if necessary.

Expose Launchpad Content to Launchpads on SAP BTP


An overview of the process for integrating content to the launchpads running on SAP BTP. This process is composed of a
content exposure ow and a content consumption ow.

The following services on SAP BTP support content exposure:

SAP Build Work Zone, standard edition

SAP Build Work Zone, advanced edition

SAP Cloud Portal service

 Note
In the following exposure section, we will talk about exposing launchpad content to SAP BTP. With that, we mean that you
can expose content to one of the above mentioned services running on SAP BTP.

Content Exposure Flow


The following graphic provides an overview of the components that are required for the content exposure ow:

This is custom documentation. For more information, please visit the SAP Help Portal 141
4/9/2023

The following table describes the steps that are required to set up the content exposure ow:

System Tool Task More Information

Content Provider System Communication System, Create a communication Manage Communication


Communication User and arrangement and a
Communication Arrangement communication system for the
apps communication scenario
SAP_COM_0647.

Content Provider System Maintain Business Roles app Select and expose the roles you Select Roles for Exposure
want to integrate in the
launchpads on SAP BTP.

SAP BTP Cockpit Create a design-time Con gure Destinations


destination to de ne the
location from which the
launchpads on SAP BTP should
fetch the exposed content.

Content Consumption Flow


After completing the content exposure ow, you need to go through the content consumption ow, at the end of which it will be
possible to launch applications from the launchpads on SAP BTP.

The following table provides an overview of the steps that are required to set up the content consumption ow:

System Tool Task More Information

Corporate Identity Provider Identity Authentication tenant Con gure the corporate identity Content Consumption -
(IdP) provider to send the mail Launchpad Service
assertion attribute in addition to
Content Consumption - Portal
sending the login name as the
Service
subject name identi er.

This is custom documentation. For more information, please visit the SAP Help Portal 142
4/9/2023

System Tool Task More Information

Content Consumption - SAP


Proxy to Corporate Identity Identity Authentication tenant Con gure the Identity
Work Zone
Provider Authentication tenant to be a
proxy between the launchpads
on SAP BTP subaccount and the
corporate identity provider.

SAP BTP Cockpit Con gure trust between your


subaccount and the Identity
Authentication tenant as proxy.

Con gure a runtime destination


for OData from which the
launchpads on SAP BTP fetch
the data to display on dynamic
tiles.

Con gure a runtime destination


from which the launchpads on
SAP BTP fetch the resources at
runtime.

Content Provider Communication System Create a communication Con gure Communication for
system. the Content Consumption

Launchpads on SAP BTP Provider Manager Consume the exposed content Content Consumption -
(roles) by con guring a content Launchpad Service
provider system, using the
Content Consumption - Portal
design-time and runtime
Service
destinations, and adding the
roles to the subaccount.
Content Consumption - SAP
Work Zone
Launchpads on SAP BTP Site Directory/Work Zone Assign one or more roles to your
Directory site.

SAP BTP Cockpit Assign the role collections


created on the platform to the
corresponding content provider
users using the following email
format: <user
alias>@example.com

Manage Communication
The communication management apps allow you to integrate your system with launchpads on SAP BTP to enable data
exchange.

Related Information
Create a Communication System with Inbound and Outbound Users
Create Communication Arrangement

Create a Communication System with Inbound and Outbound


Users
Communication systems are created to enable the communication among different systems.
This is custom documentation. For more information, please visit the SAP Help Portal 143
4/9/2023

Context
The communication system represents the system you want to communicate with, in this case the SAP Build Work Zone,
standard edition. Communication users are used by solutions to authenticate themselves to be able to post data. The
communication users are assigned to the communication system you want to use.

Procedure
1. Open the Communication Systems app from the SAP Fiori launchpad.

2. On the initial screen, click New.

3. In the New Communication System dialog, de ne an ID and a name for the new system.

4. In the Host Name eld, enter the callback URL, such as portal-service.cfapps.<datacenter>.<domain>. The
URL is needed to enable the content change noti cation. See Set Up Automatic Updates of a Content Provider - SAP
S/4HANA.

If you don't want to enable the content change noti cation, enter a host name of your choice as this is a required eld. In
this case, however, you will have to trigger the content synchronization manually on the content provider side on SAP
BTP.

5. Add a technical user for inbound communication.

a. Under Users for Inbound Communication, choose Add.

b. In the New Inbound Communication User dialog, select SSL Client Certificate or User Name and
Password as authentication method.

 Recommendation
We recommend you use the client-based authentication (X.509).

c. Choose New User. You will be redirected to the Communication User app.

d. De ne user name and description.

e. Depending on the selected authentication method, either upload the required X.509 client certi cates or provide
a password.

 Note
You need to include a trusted certi cate authority (CA) certi cate. The list of known and trusted CAs can be
found here: 2801396 .

f. Choose Create.

6. Add a technical user for outbound communication.

a. Under Users for Outbound Communication, choose Add.

b. In the New Outbound Communication User dialog, choose New User. You will be redirected to the
Communication User app.

c. In the New Outbound Communication User dialog, choose None as authentication method.

d. Choose Create.

Related Information
How to Create Communication Systems
How to Create Communication Users

This is custom documentation. For more information, please visit the SAP Help Portal 144
4/9/2023

Create Communication Arrangement


You create a communication arrangement to enable the communication between your system and SAP BTP.

Prerequisites
You have created a communication system with inbound and outbound users. See Create a Communication System with
Inbound and Outbound Users.

Context
This scenario allows you to expose apps for selected roles to the SAP Build Work Zone, standard edition. To connect the
systems, you need a communication arrangement.

Procedure
1. Open the Communication Arrangements app from the SAP Fiori launchpad. Already existing communication
arrangements are listed on the initial screen

2. Select New.

3. In the New Communication Arrangement window, select the communication scenario SAP_COM_0647. The arrangement
name is pre lled with SAP_COM_0647.

4. Select Create.

5. The Communication Arrangement screen opens.

6. Under Common Data in the Communication System eld, select the communication system that you have created
earlier using the value help.

The users assigned to the communication system and the required authentication types are displayed under Inbound
Communication and under Outbound Communication.

In the Inbound Services section, the URLs to the service endpoints are displayed.

7. Under Additional Properties in the Logical Target Identi er eld, enter an ID of your choice to uniquely identify the
target of the callback URL. This ID is used in the content change noti cation process. Example: PORTAL_SERVICE_EU1.

8. Under Additional Properties in the Unused Exposure Content: Expiration (Days) eld, de ne after how many days
unused exposure content will be deleted.

The default value is set to 100 days. If you want to disable the parameter, you can set it to 0.

9. In the Exposure Log Level eld, you can specify which messages you want to see in the exposure log. The default value is
2 (Show entities with errors and warnings). For more information, see Display Launchpad Content Exposure Logs.

10. Enter the job execution details for scheduling the exposure job. We recommend to set the job frequency to hourly.

After the communication arrangement is saved, it might take a while until the job is scheduled by the job framework.
When the Job Status eld is displayed as active, the job will run as de ned.

11. Save the arrangement.

Related Information
How to Create a Communication Arrangement
Enable Content Change Noti cations

Select Roles for Exposure


This is custom documentation. For more information, please visit the SAP Help Portal 145
4/9/2023
You can expose SAP Fiori launchpad content to SAP BTP by choosing speci c roles. The related content, such as groups,
catalogs, pages, spaces, or SAP-delivered spaces or pages, can then be consumed by launchpads on SAP BTP.

Prerequisites
You have created a communication system and a communication arrangement for communication scenario
SAP_COM_0647. See Manage Communication.

Procedure
1. Open the Maintain Business Roles app from the SAP Fiori launchpad. See Maintain Business Roles.

2. Select the roles relevant for exposure.

3. Choose Expose to SAP BTP.

4. Con rm your selection by clicking Expose in the dropdown list.

5. The Exposed to SAP BTP column now indicates that the role you selected will be exposed.

Related Information
Assigning Spaces

Display Launchpad Content Exposure Logs


With this app, you can check the application log created when publishing launchpad content to SAP BTP. You can check, for
example, when the publishing run started, if the publishing was successful or if there were any issues.

Implementation Information
To use the app, you need the following:

Business catalog: SAP_CORE_BC_UI_MON

Business role: SAP_BR_ADMINISTRATOR

To get the key information, including all the technical data you need for the installation and con guration, go to the SAP Fiori
apps reference library.

Exposure Log Level


In your communication arrangement, you can de ne which log messages should be displayed. This can be useful if, for example,
you want to only see the log messages from entities that couldn't be exposed.

This setting considers the overall exposure status of an entity. This means that if you, for example, select 2 - Show entities with
errors and warnings, messages from successfully exposed entities will not be stored in the log. This is the default value to
prevent your log le from growing too big. If you increase the log level, logs for successfully exposed entities or even requests to
the API will be logged.

In the Exposure Log Level eld, you have the following options:

1 - Show entities with errors

2 - Show entities with errors and warnings (default)

This is custom documentation. For more information, please visit the SAP Help Portal 146
4/9/2023
3 - Show entities with errors, warnings and success messages

9 - Show all entities including API calls

See Create Communication Arrangement.

Enable Content Change Noti cations


You can enable content change noti cations between your system and your launchpad on SAP BTP.

Prerequisites
You have created a communication system with inbound and outbound users. See Create a Communication System with
Inbound and Outbound Users.

In the communication system, you have added the callback URL in the Host Name eld. See Create a Communication
System with Inbound and Outbound Users .

You have created a communication arrangement to connect the systems. See Create Communication Arrangement .

Context
You can enable content change noti cations, so that the content is automatically fetched and synchronized in SAP BTP. Before
that, the administrator the SAP BTP had to manually fetch the content.

The system uses callback URLs that are provided by SAP BTP. These callback URLs are called when the content has changed.

Procedure
To enable automatic content change noti cations, you need to do the following:

1. Open the Communication Arrangements app.

2. Add a logical name in the Logical Target Identi er eld. This ID is related to the callback URLs that have been created in
the launchpads on SAP BTP.

3. Enter the job execution details for scheduling the exposure job. After the rst job run, the Job Status eld is displayed as
active.

Results
Your content noti cation is enabled once you have lled both of the elds.

For a detailed step-by-step instruction on how to create a communication arrangement, see Create Communication
Arrangement.

Con gure Communication for the Content Consumption


Administrator should create a communication system to enable the content consumption.

A SAML Bearer Assertion Provider is set up and the corresponding SAML2 con gurations, which enable trust with the SAP BTP
subaccount by both E-Mail and User Alias, are thereby created.

Prerequisite

This is custom documentation. For more information, please visit the SAP Help Portal 147
4/9/2023
You have downloaded, in the SAP BTP cockpit, the trust certi cate from the subaccount runtime destinations, by navigating to
Connectivity Destinations and selecting Download Trust. For more information, see Con gure Destinations.

Procedure

1. Log in to SAP Fiori Launchpad as an administrator.

2. Launch the app Communication Systems.

3. Create a new communication system, as follows:

a. Specify the System ID and System Name.

b. Select Inbound Only.

c. Set SAML Bearer Assertion Provider to ON.

d. Keep the User ID Mapping Mode setting to User Name.

e. Upload the certi cate le that you downloaded from your subaccount as the Signing Certi cate.

f. Specify a unique Provider Name as SAML Bearer Issuer, in the following format:

cfapps.<region>.hana.ondemand.com/<unique_name>

g. Save the communication system.

Protect Against Clickjacking


To secure your content from clickjacking threats, complete the following steps.

Context
Clickjacking attacks trick the user into triggering actions within an application by hijacking mouse clicks.

Procedure
1. On the Clickjacking Protection tab page, in the Trusted Hosts section, choose +Create to add a new host.

2. On the Add Trusted Host screen, enter the following data:

Trusted Host Name: <subdomain>.launchpad.cfapps.<region>.hana.ondemand.com

Schema: HTTPS

Port: 443

 Tip
If the value of Trusted Host Name exceeds the 64 characters limit, you can replace launchpad.cfapps with
*.cfapps

3. Choose Add to save the entry.

For more information about the Maintain Protection Allowlists app, see Maintain Protection Allowlists .

Manage UI Adaptations for Classic Applications

This is custom documentation. For more information, please visit the SAP Help Portal 148
4/9/2023
Adapting UIs with Screen Personas supports the transformation of classic applications into SAP Fiori-inspired designs. The
simpli ed versions of the applications are called avors. Flavors are a set of customizations applied to a classic application in a
speci c environment. Classic applications are also known as transactions. A single transaction can have multiple avors to
accommodate the business needs of different user groups.

For more information, see Adapting UIs for Classic Applications.

Administrators can prepare the creation of UI adaptations and manage the avors in the administration environment of Screen
Personas.

De ne Prerequisites in the Administration Environment


De ning prerequisites is an optional step to ensure consistency and de ne boundaries. The avor designer can create avors
without any speci c settings.

Create UI Adaptations in the Design Time


UI adaptations are created in the design time by a avor designer with business knowledge or a person closely connected to the
business area for which the avors are created. After creation, the administrator manages these artifacts in the administration
environment.

Manage Flavors and Assignments in the Administration Environment


When the avors as UI adaptations are created, the administrator can manage avor assignments to users indirectly by
grouping them in the assignment categories.

Manage Screen Personas Access


To manage access to Screen Personas for SAP S/4HANA Cloud, you need to use the Personas Administrator global role, the
appropriate business role template, and business catalog.

The following table describes typical user types along with their tasks and how they are mapped to business roles and business
catalogs. With these two components, the access and privileges are assigned to business users.

Roles and Assigned Tasks

Global role Task description Business role template Business catalog Application

Personas Access to SAP_BR_ADMINISTRATOR SAP_CORE_BC_UI_PER_ADM_PC Manage Flavors


Administrator administrator
environment to
manage avors that
are the UI
adaptations with
Screen Personas.

Flavor Designer Access to Adapt UI in SAP_BR_ADMINISTRATOR SAP_CORE_BC_UI_PER_DSG_PC Adapt UI for classic


the user actions applications.
menu of SAP Fiori
launchpad for
creating avors that
are the UI
adaptations with
Screen Personas.

This is custom documentation. For more information, please visit the SAP Help Portal 149
4/9/2023

Global role Task description Business role template Business catalog Application

Access to design
time destination for
creation of UI
adaptation by using
Screen Personas.

Employee Access to Adapt UI in SAP_BR_EMPLOYEE SAP_CORE_BC_UI_PER_USE_PC Adapt UI for classic


the user actions applications.
menu of SAP Fiori
launchpad for
launching and
selecting between
avors that are
assigned UI
adaptations.

For more information, see the Screen Personas Administration Guide.

Setting Custom Themes for the Launchpad


This section explains how you can make a custom theme available in the SAP Fiori launchpad, and how you can set it as the
default theme for all users. As a result, the SAP Fiori launchpad is displayed, for example, with the color scheme and the logo of
your company.

Alternatively, you can keep the SAP standard theme (or set another SAP theme as default) and just provide additional custom
themes that the users can select in the user settings of the SAP Fiori launchpad.

You can specify whether users are allowed to select a different theme from the themes available in the user settings. But keep
in mind that some users might prefer a high-contrast scheme.

To set a custom theme, only a few con guration steps are required in SAP BTP, Neo environment (for which you need a
productive account) and in your own system.

 Restriction
This section is only relevant if you use SAP BTP, Neo environment. SAP Cloud Foundry is NOT supported for this scenario.

Prerequisites
You need a productive account for SAP BTP, Neo environment.

You need users with admin rights for SAP BTP, Neo environment, and your own system.

Related Information
What Is SAP BTP, Neo Environment

Con guration Overview


The table below lists the tasks required for the initial setup of a custom theme.

This is custom documentation. For more information, please visit the SAP Help Portal 150
4/9/2023
You perform the tasks in SAP Business Technology Platform (BTP) and in your system.

 Note
After you've completed these tasks, you can change the theme at any time, add new themes, or remove the themes from
the SAP Fiori launchpad in your system.

Initial Setup of a Custom Theme

Task Task Description System More Information


Number

1 Enable the UI theme designer. BTP Enabling the UI Theme Designer Service

2 Create a custom theme using the UI theme BTP Creating a Custom Theme
designer.

3 To access the custom theme on the BTP, create and BTP Creating an HTML5 Application (themeproxy)
publish an HTML5 application (themeproxy).

4 Create a communication arrangement for the UI Your system Creating a Communication Arrangement
theme designer scenario (SAP_COM_0086), to
Manage Launchpad Settings
make the custom theme available in the SAP Fiori
launchpad.

 Recommendation
In this communication arrangement, you can
enter the custom theme as the default theme or
as an additional theme. We strongly recommend
that you have a test phase rst and enter the
custom theme only as an additional theme. If
tests by selected users are successful, enter
your theme as the default theme (which applies
to all users as soon as you save the
communication arrangement).

 Note
There’s an additional option to make a theme the
default theme: You can use the
THEMING_DEFAULT_THEME parameter in the
Manage Launchpad Settings app.

5 Specify whether users are allowed to select a Your system Manage Launchpad Settings
different theme from the themes available in the
user settings.

To do so, use the USERSETTINGS_SET_THEME


parameter in the Manage Launchpad Settings app.

Enabling the UI Theme Designer Service

Prerequisites
You are logged on to the SAP BTP cockpit with your admin user.

Procedure
This is custom documentation. For more information, please visit the SAP Help Portal 151
4/9/2023
1. Choose Services.

2. Search for the UI Theme Designer service and click it.

3. If the status is Not enabled, choose Enable.

 Note
It can take a couple of seconds for the status to turn to Enabled.

4. If needed, add a user to the account as a Member with the Account Developer role or set up a user as described here:
Setting up Permissions for a Custom Identity Provider.

Results
You can now launch the UI theme designer by clicking the Go to Service link.

Creating a Custom Theme

Prerequisites
You are logged on to the SAP BTP cockpit with your admin user.

You have enabled the UI theme designer.

Context
In this step, you create a custom theme using the UI theme designer.

Procedure
1. Choose Services and search for the UI theme designer.

2. Click the UI Theme Designer tile.

3. Choose Go to Service.

4. Choose Create a New Theme.

5. Follow the instructions on the screen: choose a base theme, give the theme a name and ID (can also be done later), and
choose Create.

6. On the Target Pages pane on the left, do the following:

a. Choose SAPUI5 Application Previews and select the SAP Fiori launchpad checkbox.

b. Select SAP Fiori launchpad.

7. In the Quick pane on the right, upload your company logo and set your colors.

To upload the company logo, choose the button to the right of the Company Logo eld.

A preview of the SAP Fiori launchpad with your choices applied is displayed in the middle of the screen.

8. Save and publish your theme.

To do so, proceed as follows:

a. In the menu bar, choose Theme Save & Publish .

b. Keep or change the theme ID and the theme name.

c. Choose Save & Publish.

This is custom documentation. For more information, please visit the SAP Help Portal 152
4/9/2023

Creating an HTML5 Application (themeproxy)

Prerequisites
You are logged on to your SAP BTP cockpit with your admin user.

Context
You use this task to create an HTML5 application with the name themeproxy and deploy it to your SAP BTP account.

 Caution
The application makes all of your themes in your SAP BTP account visible on the public internet, without any authentication
or authorization checks.

Procedure
1. Choose Applications HTML5 Applications .

The list of applications is displayed.

 Note
For technical reasons, the list includes an application whose name contains the name of the custom theme that you
have just created. It is created automatically by the system. Ignore this application. It's mandatory to create a new
application with the name themeproxy as follows.

2. Choose New Application.

3. Enter themeproxy for the application name.

4. Click the pen icon at the right end of the themeproxy application row.

The Web IDE service is started and the Clone Git Repository dialog box is displayed.

5. Choose Clone.

The Git Ignore System les dialog box is displayed.

6. Choose Commit and Push.

7. Click the </> (Development) icon.

8. In the workspace, right-click themeproxy and choose New File .

9. Enter neo-app.json for the le name and choose OK.

10. Paste the code from Application Descriptor (neo-app.json) into the le.

11. Save the le.

12. Right-click themeproxy and choose Deploy Deploy to BTP .

The dialog box Deploy Application to SAP BTP is displayed.

13. Choose Deploy.

The Successfully Deployed dialog box is displayed.

14. Choose Open the application’s page in the SAP BTP cockpit.

The overview page for the themeproxy application is displayed.

15. Copy the application URL (without https://). It is required for the communication arrangement in your system (next
task).

This is custom documentation. For more information, please visit the SAP Help Portal 153
4/9/2023

 Example
themeproxy-youraccount.dispatcher.xxy.hana.ondemand.com.

Application Descriptor (neo-app.json)


 Source Code
{
"authenticationMethod": "none",
"securityConstraints": [
{
"permission": "AccessApplicationDescriptor",
"description": "Access application descriptor",
"protectedPaths": [
"/neo-app.json"
]
}
],
"routes": [
{
"path": "/",
"target": {
"type": "service",
"name": "theming",
"preferLocal": true,
"entryPath": "/themes"
},
"description": "Themes"
}
]
}

Creating a Communication Arrangement

Prerequisites
On SAP BTP, you’ve created a custom theme and the themeproxy HTML5 application.

 Note
The URL of the HTML5 application is required for this task. You get it from the last step of Creating an HTML5
Application (themeproxy).

You’re logged on to your system with your admin user.

Context
With this task, you can make the custom theme the default theme or add the custom theme as an additional theme.

Procedure
1. Open the Communication Arrangements app.

2. Create a new communication arrangement for the communication scenario SAP_COM_0086.

If you want, change the proposed arrangement name (SAP_COM_0086).

This is custom documentation. For more information, please visit the SAP Help Portal 154
4/9/2023
3. In the Additional Properties section, enter the custom theme as an additional theme or as a default theme (which
applies to all users as soon as you save the communication arrangement).

 Recommendation
We strongly recommend that you have a test phase rst and enter the custom theme only as an additional theme. If
tests by selected users are successful, you can enter your theme as the default theme. Alternatively, you can use the
THEMING_DEFAULT_THEME parameter in the Manage Launchpad Settings app.

For a default theme, you must enter the following data:

ID of the custom theme

Optional: name that will be displayed in the user settings of the SAP Fiori launchpad

If you don't enter a name, the label that was speci ed for the custom theme in the UI theme designer is displayed.

 Note
The translation of the name is currently not supported.

4. In the Common Data section, create a communication system. To do so, proceed as follows:

a. Choose New to the right of the Communication System eld.

b. Enter THEMEPROXY for the system ID and for the system name.

c. Choose Create.

d. For the host name, enter the URL of the themeproxy HTML5 application (be careful not to include http://).

e. Add a new user for outbound communication.

To do so, click the + (plus) sign to the right of the User for Outbound Communication eld.

f. Important! For the authentication method, select None.

g. Choose Create.

h. Save the communication system.

5. Go back to the communication arrangement and enter None for the user for outbound communication.

6. Save the communication arrangement.

Results
After you’ve logged off and on again to your system, your custom theme is available according to your con guration, as follows:

If you’ve entered the custom theme as an additional theme (recommended!), the SAP Fiori launchpad is unchanged but
the theme is now available in the User Actions menu under Settings Appearance .

If you have set the custom theme as a default theme (only after thorough tests!), the SAP Fiori launchpad is displayed
with the new theme for all users.

Exception: Users who have switched their theme previously in the user settings of the SAP Fiori launchpad keep their
theme. But they can switch to the new default theme in the user settings, since it is listed there.

 Note
If the SAP Fiori launchpad looks broken when you log back on and you have set the custom theme as the default theme, x
the situation immediately so that users are not prevented from working.

Start the troubleshooting by checking whether you have set up the communication arrangement correctly. To be able to
access the communication arrangement, you need a working launchpad for yourself rst. You get it by inserting the

This is custom documentation. For more information, please visit the SAP Help Portal 155
4/9/2023
parameter for the SAP Fiori 3 standard theme (sap-theme=sap_fiori_3&) in the URL of the launchpad, wrapped with a
? (question mark) and an & (ampersand), as shown in the following table:

URL Without Theme URL With SAP Fiori 3 Theme

https://<your https://<your instance>.scmibp.ondemand.com/ui?


instance>.scmibp.ondemand.com/ui#Shell-home sap-theme=sap_ ori_3&

After you’ve xed the communication arrangement (if necessary), call up the launchpad again without the parameter. If the
launchpad is still broken, delete the communication arrangement to deactivate the custom theme and to return the users to
a working launchpad with the SAP standard theme.

Then continue troubleshooting by analyzing the custom theme and the HTML5 application.

Changes After the Initial Setup


After you've completed the initial setup, you can add additional custom themes, change custom themes, and remove custom
themes.

The following table provides an overview of the changes and the related activities on SAP Business Technology Platform (BTP)
and in your system:

What? How?

Changing a custom theme (logo, colors, …) 1. On the BTP, do the following:

a. Change the custom theme in the UI theme designer.

b. Save and publish the custom theme.

2. In your system, reactivate the communication arrangement to refresh the cache.

 Note
Refreshing the cache is required because the custom theme is cached in the
back end for a long time.

Adding custom themes


1. On the BTP, create and publish the custom themes.

2. In your system, enter the custom themes as additional themes in your


communication arrangement.

Removing custom themes 1. In your system, remove the custom theme from the communication arrangement.

Users are switched to the SAP default theme if necessary.

2. On the BTP, delete the custom theme.

 Note
Make sure that you perform the steps in this order, not the other way round.

This is custom documentation. For more information, please visit the SAP Help Portal 156

You might also like