SAP Fiori Launchpad For SAP S4HANA CLOUD
SAP Fiori Launchpad For SAP S4HANA CLOUD
SAP Fiori Launchpad For SAP S4HANA CLOUD
PUBLIC
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.
This is custom documentation. For more information, please visit the SAP Help Portal 1
4/9/2023
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.
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.
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.
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.
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.
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.
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.
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.
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
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
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.
There are various ways that lead to an invite to give more speci c feedback:
Time-controlled survey
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.
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.
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.
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.
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:
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.
This is custom documentation. For more information, please visit the SAP Help Portal 5
4/9/2023
Launch the All My Apps navigation option.
Entry Page
The entry page is the heart of the SAP Fiori launchpad. It is where you open your SAP Fiori apps.
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.
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.
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.
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.
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 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.
For information about more personalization options, see Personalizing the Home Page (deprecated) and Personalizing a Page.
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 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 .
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
This is custom documentation. For more information, please visit the SAP Help Portal 10
4/9/2023
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
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.
Converts a few selected tiles into a 4x2 wide tile. To do so, you can use the toggle button available next to a tile.
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.
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
Contact Support
You can personalize an object page used in your app by adding, removing or rearranging sections. This is an
experimental feature.
With key user adaptation, you can change the user interface of SAP Fiori apps directly in the launchpad, intuitively
For more information, see Adapting SAP Fiori UIs at Runtime - Key User Adaptation.
Adapt UI
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.
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.
Icon Description
Indicates that the app has not yet been added to any group
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 Indicates that the app has not yet been added to any page. Is displayed if you work in spaces mode.
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.
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.
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.
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
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
Note
You can clear the history or stop tracking your user activity at any time in the Settings dialog box.
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:
None shares warrants Finds results that contain both the word
“shares” and 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*.
This is custom documentation. For more information, please visit the SAP Help Portal 26
4/9/2023
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.
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.
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.
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.
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.
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
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.
Click any app to navigate quickly to apps or objects that you recently worked with.
Click any app to navigate quickly to apps or objects that you use often.
Use it to navigate to the previous app (or object) that you opened.
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.
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
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.
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).
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.
Remember
Closing a noti cation that is expecting an action from you will dismiss the noti cation without
taking any form of action.
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.
This is custom documentation. For more information, please visit the SAP Help Portal 32
4/9/2023
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.
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
To access more support options and nd more information, go to the Built-In Support page.
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.
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
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
This is custom documentation. For more information, please visit the SAP Help Portal 36
4/9/2023
Field Description
Framework ID Framework ID on that the opened app is based on (e.g. SAPUI5, SAP GUI etc.)
System
Product Version Version of the used product, e.g. the SAP NetWeaver version.
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
Optimized for Touch Input Indicates if the app is optimized for touch input.
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
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 .
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.
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
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.
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
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.
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).
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
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
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
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.
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
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
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:
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.
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
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:
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.
Page Up or Page Down Move to the rst tile in the next group.
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.
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.
Ctrl + Shift + F ( Cmd + Shift + Set the focus on the search entry eld.
F on Mac)
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.
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.
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.
The following actions apply only after you have switched to edit mode.
2. 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 .
This is custom documentation. For more information, please visit the SAP Help Portal 43
4/9/2023
Keys Behavior
2. Press Delete .
Delete a group.
1. Navigate to the header of the group.
Rename a group.
1. Select the title of the group.
Reset a group.
1. Select the title of the group.
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
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.
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.
The following actions apply only after you have switched to edit mode.
4. Select the group to which you want to move the tile using
the Up arrow and Down arrow keys and then press
Enter .
2. Press Delete .
Delete a section.
1. Navigate to the header of the section.
Reset a section.
1. Select the title of the section.
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:
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:
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
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:
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
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 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.
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.
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?.
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.
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.
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.
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?
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.
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.
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
Prerequisites
You have started the UI adaptation mode by choosing Adapt UI in the user actions menu.
Process
Adding Content
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).
https://www.somewebsite.com/embed?more_URL_parameters
/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.
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
If you want to change embedded content, right-click the content and choose Update Embedded Content to open the De ne
Embedded Content dialog.
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:
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.
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.
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.
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:
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.
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.
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.).
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.
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:
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:
Unsaved: Only changes that you've made in the current session and not yet saved.
All (default)
Add
Move
Rename
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).
Prerequisite
The app contains a view element, for example, a table with a view selector:
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.
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.
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:
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.
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.
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.
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.
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
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.
Mac: Command + X
Mac: Command + V
Ctrl + Z Undo
Mac: Command + Z
Ctrl + Y Redo
Mac: Command + Y
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.
You can then start adapting the UI again, based on the last activated 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.
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.
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.
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.
4. You get a success message saying that your changes are now ready to be exported via a software collection.
6. Open the software collection assigned to you. Usually, this is the Default Collection.
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.
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.
Related Information
Export Software Collection
Import Collection
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
3. Add your app variant to your SAP Fiori launchpad home page in your test system via the app nder.
6. Add the app variant to a software collection and export it from the test 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.
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
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
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.
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)
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.
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.
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).
b. In the software collection, search for the custom catalog extension using the ID that you copied to the clipboard in
the previous step.
d. Choose Add Missing Items. The ID of the app variant should be listed. Add it to the software collection.
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).
Related Information
Custom Catalog Extensions
Export Software Collection
Import Collection
Your business role is not authorized for the business catalog SAP_CORE_BC_EXT.
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.
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).
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.
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.
At a high level, the following steps for creating a Screen Personas avor can be de ned:
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.
Flavor Editor.
Script Editor.
Template Editor.
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:
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.
Personalizing Apps
You can personalize SAP Fiori apps directly in the launchpad.
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.
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
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.
This is custom documentation. For more information, please visit the SAP Help Portal 75
4/9/2023
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.
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.
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
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.
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.
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.
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
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).
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.
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
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).
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.
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
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.
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
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.
There is also a tutorial available that gives you a ve-minute-introduction to the most important personalization options.
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.
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.
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.
Related Information
User Actions Menu
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:
This is custom documentation. For more information, please visit the SAP Help Portal 89
4/9/2023
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.
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.
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.
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.
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.
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.
This is custom documentation. For more information, please visit the SAP Help Portal 92
4/9/2023
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.
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.
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.
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.
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.
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.
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.
Noti cations Personalize various settings that are related to the noti cations provided to you in the launchpad.
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
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)).
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
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.
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
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.
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.
1. Click on the arrow next to the value set name, e.g. Saved Values as in the image above.
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.
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.
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.
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.
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.
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
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:
Implementation Information
To use the app, you need the following:
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.
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.
This is custom documentation. For more information, please visit the SAP Help Portal 102
4/9/2023
Parameter Description
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.
HOMEPAGE_GROUPSELECTIONBAR_MODE Specify the default mode of the group selection bar on the home
page.
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.
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:
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.
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).
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.
true: The All connector is not used. The default search scope is
Apps.
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.
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.
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.
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.
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.
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.
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.
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).
PUBLIC (default)
PRIVATE
Users are allowed to create and adapt new views, but the
Public checkbox is not displayed, preventing users from
sharing views.
NONE
USERSETTINGS_CONTENTDENSITY Specify whether end users can view and toggle the Optimized for
Touch Input option.
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.
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.
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.
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.
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
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.
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 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.
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.
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.
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).
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.
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.
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.
Assigning Spaces to Several Business Roles (see Assigning Spaces to Several Business Roles at Once)
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
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.
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.
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.
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.
3. Checkmark one or more spaces that you want to remove from the role and click on Remove.
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.
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 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.
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.
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:
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.
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/
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:
Implementation Information
Business catalog: SAP_CORE_BC_UI_FLD
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).
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.
Open a page preview to see how the page looks like for the user (from page details view, also see Selecting a Role
Context).
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.
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).
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.
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
2. There is already one empty section in the page. Enter a meaningful name for it.
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.
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.
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.
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.
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.
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.
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.
This is custom documentation. For more information, please visit the SAP Help Portal 130
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
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.
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.
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.
Key Features
You can use this app to:
Implementation Information
Business catalog: SAP_CORE_BC_UI_FLD
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.
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.
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.
General: shows space information as e.g. space ID, title and creation information
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.
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 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.
This is custom documentation. For more information, please visit the SAP Help Portal 135
4/9/2023
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.
This is custom documentation. For more information, please visit the SAP Help Portal 136
4/9/2023
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.
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.
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.
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.
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.
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.
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
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.
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:
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.
The following table provides an overview of the steps that are required to set up the content consumption ow:
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
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.
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
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.
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.
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.
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.
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
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.
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.
Related Information
How to Create a Communication Arrangement
Enable Content Change Noti cations
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.
5. The Exposed to SAP BTP column now indicates that the role you selected will be exposed.
Related Information
Assigning Spaces
Implementation Information
To use the app, you need the following:
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.
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:
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
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:
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.
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
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>
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.
Schema: HTTPS
Port: 443
Tip
If the value of Trusted Host Name exceeds the 64 characters limit, you can replace launchpad.cfapps with
*.cfapps
For more information about the Maintain Protection Allowlists app, see Maintain Protection Allowlists .
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.
Administrators can prepare the creation of UI adaptations and manage the avors in the administration environment of Screen
Personas.
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.
Global role Task description Business role template Business catalog Application
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.
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
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.
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.
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.
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.
Prerequisites
You are logged on to the SAP BTP cockpit with your admin user.
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.
3. Choose Go to Service.
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.
a. Choose SAPUI5 Application Previews and select the SAP Fiori launchpad checkbox.
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.
This is custom documentation. For more information, please visit the SAP Help Portal 152
4/9/2023
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 .
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.
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.
10. Paste the code from Application Descriptor (neo-app.json) into the le.
14. Choose Open the application’s page in the SAP BTP cockpit.
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.
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).
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.
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.
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:
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://).
To do so, click the + (plus) sign to the right of the User for Outbound Communication eld.
g. Choose Create.
5. Go back to the communication arrangement and enter None for the user for outbound communication.
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:
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.
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?
Note
Refreshing the cache is required because the custom theme is cached in the
back end for a long time.
Removing custom themes 1. In your system, remove the custom theme from the communication arrangement.
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