Configuring SAP Fiori Launchpad

Objective

After completing this lesson, you will be able to configure SAP Fiori launchpad.

Configuration Options

The image details configuration approaches. FLP Configurations include basic configuration, personalization, and runtime adaptation. Additional configurations cover user assistance, notifications, and support.

The SAP Fiori launchpad (FLP) has many configuration options. There are several basic configurations and also advanced configurations needing other additional technical settings elsewhere. The configurations depend on the release of the software component SAP_UI. There are two approaches to configure the FLP:

Customer settings
Define customer settings using the transaction /UI2/FLP_CUS_CONF. This is recommended since SAP S/4HANA 1809. These settings are valid for one system client.
Target Mapping
Define target mappings in catalogs. This is recommended since SAPUI5 1.40. These catalogs can then be assigned to users via roles as usual.

Note

Originally, it was also possible to create and upload a configuration file as a third option. This option is deprecated since SAPUI5 1.40 and was removed with SAP S/4HANA 2022.

To configure the additional settings needed for context-sensitive user assistance, notifications, and contact support, consult the SAP online documentation for your system release or ask your system administrator.

SAP Fiori Launchpad Customer Settings

Watch the video to understand SAP Fiori Launchpad Customer Settings.

Note

The transaction /UI2/FLP_SYS_CONF allows the configuration of the FLP for all clients. However, these settings are saved in the SAP namespace. They count as modifications, including all the drawbacks.

SAP Fiori Launchpad Configuration via Custom Catalog

Screenshots of an app descriptor in a technical catalog configuring the system info bar of the SAP Fiori launchpad. Highlighted fields are for the semantic object Shell, the action bootConfig, any value for componint ID, no tile checkbox, and configuration parameters list.

Target mappings for configuring the FLP can be created in any catalog. However, it is recommended that you use a separate one without any tiles or target mappings for apps. The semantic object for the FLP is Shell, followed by an action depending on the FLP part. The action bootConfig is meant for general settings of the FLP. The application type is SAPUI5 Fiori App, followed by a freely selectable component ID. The settings themselves are created using parameters of the target mapping and depend on the system release. A full list of available settings per system release can be found in the SAP Fiori launchpad documentation on https://help.sap.com/docs/SAP_FIORI_LAUNCHPAD.

Screenshot of target mapping in SAP Fiori launchpad designer showing settings and parameters for disabling personalization in SAPUI5 Fiori App with predefined intent 'Shell, bootConfig' and various configuration options.

For some configuration areas, SAP delivers predefined catalogs that already consist of target mappings with parameters. These catalogs can be assigned directly to roles to enable a certain feature set, or they can be copied in the customer namespace to change the default values to meet someone's needs. Depending on the release, these catalogs are delivered as business or technical catalogs and must be handled accordingly.

For example, assigning the /UI2/CONFIG_PERS_OFF business catalog to a role deactivates the personalization options of the FLP for all users assigned to the role. Only accessibility features are still possible and the My Home page in spaces can still be changed. But there is no access anymore to the app finder.

Hint

The My Home page in spaces can be deactivated by setting SPACES_MYHOME to false in the /UI2/FLP_CUS_CONF transaction.

Note

For more information about this topic, see:

Configuring the SAP Fiori Launchpad for SAP S/4HANA (Learning Video)

https://learning.sap.com/videos/configuring-the-sap-fiori-launchpad-for-sap-s-4hana

How to Configure SAP Fiori Launchpad

Business Example

You want to move buttons from the user actions menu to the page header of the SAP Fiori launchpad.

Watch the video to see how to configure the SAP Fiori Launchpad.

Deactivate Personalization

Business Example

You want to manage the personalization options of the SAP Fiori launchpad for a certain group of users.

Solution:
SAP_BR_UX100_S_RESTRICTED (Role)
SAP_UX100_BC_S_PERS_OFF (Catalog)

Note

This exercise requires an SAP Learning system. Login information is provided by your system setup guide.

Note

Whenever the values or object names include ##, replace ## with the number of your user.

Task 1: Copy and Edit the Catalog for Disabling Personalization

Steps

  1. In the SAP Fiori launchpad content manager for customizing of your SAP S/4HANA (S4H) system, copy the /UI2/CONFIG_PERS_OFF catalog using ID Z_##_BC_PERS_OFF and title Z## - Disable Personalization.

    1. In the SAP Easy Access menu of your S4H, search for FLP Content Manager: Client-Specific or start transaction /UI2/FLPCM_CUST.

    2. In the Search Catalogs field, enter pers and choose Go.

    3. Select the /UI2/CONFIG_PERS_OFF catalog.

    4. Choose Copy.

    5. In the New ID field, enter Z_##_BC_PERS_OFF.

    6. In the New Title field, enter Z## - Disable Personalization.

    7. Choose Continue.

    8. Choose the transport request provided to you.

  2. In the SAP Fiori launchpad content manager for customizing of your S4H, open the Z_##_BC_PERS_OFF in the SAP Fiori launchpad designer for customizing and assign a transport request in the settings.

    Note

    Close the SAP Fiori launchpad content manager to release the lock.
    1. In the SAP Fiori launchpad content manager for customizing, select the Z_##_BC_PERS_OFF catalog.

    2. Choose Open in Designer.

    3. Close the SAP Fiori launchpad content manager.

    4. In the SAP Fiori launchpad designer for customizing, choose Settings (gearwheel) in the upper right corner.

    5. In the Assign Transport Request popup, deselect the None (Local Object) checkbox.

    6. In the Customizing Request dropdown, select the transport request provided to you.

    7. Choose OK.

Task 2: Edit Parameters of a Target Mapping in the SAP Fiori Launchpad Designer

Steps

  1. In the SAP Fiori launchpad designer for customizing of your S4H, in the target mapping for the Shell semantic object of the Z_##_PERS_OFF catalog, change the default value of the renderers/fiori2/componentData/config/enableSetTheme parameter to true.

    Caution

    If you get an error when saving the catalog, close the SAP Fiori launchpad content manager to release the lock.
    1. In the SAP Fiori launchpad designer for customizing of your S4H, in the Z_##_BC_PERS_OFF catalog, choose Target Mappings at the top of the page.

    2. Select the Semantic ObjectShell with ActionbootConfig .

    3. Choose Configure.

    4. Enlarge the width of the Name column of the Parameters table until you can fully read the names.

    5. In the Default Value cell of the renderers/fiori2/componentData/config/enableSetTheme parameter, enter true.

    6. Choose Save.

    7. In the Confirmation popup about breaking the reference, choose OK.

      Caution

      If you get an error when saving the catalog, close the SAP Fiori launchpad content manager to release the lock.

Task 3: Create a Business Role, Add the Catalog, and Test it in the SAP Fiori Launchpad

Steps

  1. Create the role Z_##_BR_RESTRICTED in the Role Maintenance (PFCG) of your S4H. Assign the role to your user.

    1. In the SAP Easy Access menu of your S4H, search for Role Maintenance or start transaction PFCG.

    2. In the Role field, enter Z_##_BR_RESTRICTED.

    3. Choose Create Single Role.

    4. In the Description field, enter Restricted ##.

    5. Choose Save.

    6. Choose the User tab.

    7. In the User ID field, enter your user.

    8. Choose Save.

  2. Add the Z_##_BC_PERS_OFF catalog to the menu of the Z_##_BR_RESTRICTED role in the Role Maintenance (PFCG) of your S4H.

    1. Choose the Menu tab.

    2. Expand the Insert Node button.

      Hint

      The initial value written on the Insert Node button is Transaction.
    3. Choose SAP Fiori LaunchpadLaunchpad Catalog.

    4. In the Catalog ID field, enter z_##* and use the value help.

    5. In the popup, double-click Z_##_BC_PERS_OFF.

    6. Choose Continue.

      Note

      If Warnings and/or errors happened during evaluation of the catalog details appears in a pop-up, choose No to continue.
    7. Choose Save.

  3. Test if the personalization in the SAP Fiori launchpad spaces of your S4H is disabled and changing the theme is still possible.

    Note

    To enable personalization again for later exercises, go back to transaction PFCG and remove your user from the role Z_##_BR_RESTRICTED.
    1. Start or reload the SAP Fiori launchpad of your S4H in the client of your choice.

    2. Choose the Cross Topic space.

    3. Choose your user in the upper right corner.

      Result

      The App Finder button disappeared and the Edit Current Page button is renamed to Add Tiles to My Home.
    4. In the User Actions Menu, choose Settings.

    5. Choose Appearance.

    6. Select a Theme of your choice.

    7. Choose Save.

      Note

      To enable personalization again for later exercises, go back to transaction PFCG and remove your user from the role Z_##_BR_RESTRICTED.