Deployment to Fiori Launchpad

The recommended way to add apps into the Fiori Launchpad is by creating a Semantic Object.  The alternate method via a target URL is described in this document (Target URL Method). 

Configuration Steps

Create a new Semantic Object (Tcode /UI2/SEMOBJ)

  • Login to SAP Gateway then go to transaction /UI2/SEMOBJ
  • Click "New Entries" button to create a new Semantic Object
  • Enter the following information
    • Semantic Object
    • Semantic Object Name
    • Semantic Object Description



    • Click "Save" – Create transport when asked.

Gateway - Create a new application in Customer Launchpad (Tcode LPD_CUST)

  • Login to SAP Gateway, then go to transaction LPD_CUST
  • If you haven't created a new Launchpad, create one by clicking "New Launchpad" and provide the details.
  • Double click the new Launchpad entry and populate the following fields:
Rolee.g. IQXDGWYour own launchpad role name
InstanceTRANSACTIONAL
Descriptione.g. IQX LaunchpadYour own Launchpad role description
Namespace
No namespace, leave blank
Type of Launchpad
Leave blank


  • Right-click on the Launchpad name folder and select "New application"

  • Populate the following fields:
    • Link Text – e.g. CAPEXDEMO2
    • Application Type: URL
    • URL:
      • Click the "URL Editor" button



      • Then enter the FAB URL excluding the hostname and port e.g (/sap/bc/ui5_ui5/iqx/fab2)
      • Click the "URL Editor button" again to accept the changes

You may need to click the "Show Advanced (Optional) Parameters" button to view all the fields that need to be configured.


  • Application Alias
    • Click the "Editor Application Alias" button



    • Enter an action string for the app e.g. SubmitCapex and click on "Editor Application Alias" to accept the changes



    • Additional Information: Enter "SAPUI5.Component=fab"

    • Click "Save"

Create a Tile Catalog in gateway via Fiori Designer

  • Login to the Fiori Launchpad Designer via /UI2/FLPD_CUST or use this link:

    <server host>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-client=<client>&sap-language=EN
  • Login using your SAP Gateway account 
    On successful login, you should be able to see the list of catalogs in the gateway

  • Ensure that you are in the Catalog section by pressing "Catalogs" tab on the upper left-hand side:

  • Create a new Tile Catalog by pressing the + button on the lower left-hand part of the screen:



  • On the pop-up screen, select "Standard" and provide a Title and ID. The ID needs to start with Z* and press Save



  • A new catalog will be created



  • You have now created a Tile Catalog

Create a Tile in the Tile Catalog

  • While the new catalog is selected on the right-hand side, click on the + sign to add a tile. A list of tile template will show:



  • Click on the "App Launcher – Static" tile. You should then see the configuration screen for a tile



  • Configure the following parameters:
    • Title: <Your app title>
    • Subtitle: <Your app subtitle>
    • Keywords: <some keywords for your app>
    • Icon: <Select from drop down or refer to Icon Explorer site>
    • Information: <Additional information for your app>
    • Use semantic object navigation: Ticked. By default, this field is ticked.
      • Semantic Object – search the created Semantic Object from the dropdown



      • Action: Enter the "Application Alias" from launchpad e.g. SubmitCapex



      • Parameters: Enter "FormName" as the parameter
      • Click the "Save" button at the bottom of the page:



    • Back to the tile catalog, click on the Target Mapping button at the top of the screen



    • If the "Target Mapping" tile is not clickable, this is a known issue with SAP UI5 Library. Refer to SAP Note 2409207 - Unable to open the Target Mappings icon in Fiori Launchpad Designer when using Google Chrome. 

      In summary, you may either upgrade to the UI5 library mentioned, or a quick workaround is to disable the "Touch Event API" in Chrome settings:

      In Chrome tab, go to chrome://flags/
      Search "Touch Events API", select Disable then click "Relaunch".
      Revisit the Fiori Launchpad Designer and see that the Target Mapping Tile is now clickable.

    • In the Target Mapping page, click on "Create Target Mapping" button at the bottom of the page



    • Populate the following fields in the Target Mapping Configuration:

      • Intent:
        • Semantic Object: Search and select the created Semantic Object
        • Action: Same as "Application Alias" from Launchpad
      • Target:
        • Application Type: SAP Fiori App using LPD_CUST
        • Launchpad Role: Search and select the Launchpad
        • Launchpad Instance: (automatically defaulted from Launchpad)
        • Application Alias: Select the Application Alias from launchpad


      • General:
        • In the Parameters section, you also need to add the following parameter:
          • Name: FormName
          • Default Value: This should be the technical name of the FAB Application. (NOTE: Leaving this value blank will redirect the tile to the FAB Launchpad)
    • Click  "Save"
    • You have now created a tile in Fiori Launchpad

Create a SAP Role in Gateway and assign users

  • Login to SAP Gateway system
  • Go to transaction PFCG
  • Create a new SAP Role for your Fiori Catalog e.g. ZIQX_FABFLP_ROLE, then click the Single Role button. The screen to maintain the new role will be displayed.



  • Enter a description and click on the Menu tab. Save the role when asked. You should now see the Menu tab:

  • Beside the button "Transaction", click the small button beside it to switch to "SAP Fiori Tile Catalog".



  • A new pop up will show to identify which catalog to assign.



  • In the Catalog Provider, select Fiori Launchpad Catalogs.
  • From the dropdown, select the new Catalog created from Fiori Launchpad.



  • Click check to continue. The catalog will now be assigned to the role.

  • Go to "Users" tab and enter the users who will be assigned with this new role.

  • Click Save.

As a user, add the new tile into own Fiori Launchpad

  • Login to Fiori Launchpad as one of the users assigned with the new role
  • When in the Fiori Launchpad, click on the username on the upper right-hand side of the screen and select "Tile Catalog"



  • Locate the new tile from the list of assigned tiles.



  • Click the + button to add the tile into your Fiori Launchpad and select which group it will initially belong to.



  • Click Ok and click the Home button to go back to Fiori Launchpad.
  • The tile should now be available and can open the new FAB App.