Add a Neptune app to SAP Fiori launchpad

Applications developed on Neptune DXP can be easily added to the SAP Fiori Launchpad. We recommend the following procedure since it enables smart variant management in your applications.

Neptune applications do not require individual SICF services. Neptune DXP uses a centralized ICF architecture where all applications are served through the /neptune/ HTTP handler. Only the /neptune/flp node must be activated in SICF (one-time setup). This differs from standard SAP Fiori applications, which typically require individual BSP deployments and corresponding SICF services.

Procedure

Create a semantic object

Open SAP transaction /UI2/SEMOBJ, create a new semantic object, and save.

resources help fiori launchpad 1

Open the SAP Fiori Launchpad Designer

You can find the SAP Fiori Launchpad Designer adjusting the following URL:

http://<yourServer>:<yourPort>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html

In newer S/4HANA versions, you may see multiple Fiori Launchpad administration tiles. We recommend using one of the following:

  • Launchpad Designer (client-specific or cross-client)

  • Launchpad Content Manager (client-specific)
Do not use the Launchpad App Manager for Neptune app configuration. If using the Launchpad Content Manager, select your catalog ID and select Open in Designer to proceed wit the steps below.

Create a target mapping

Select one of your catalogs and create a target mapping.

resources help fiori launchpad 3

  • Application Type: SAPUI5 Fiori App

  • Title: <yourTitle>

  • URL: /neptune/<NAME_OF_YOUR_APP> (trailing slash recommended)

  • ID: <NAME_OF_YOUR_APP>

    The ID must be in uppercase.

    resources help fiori launchpad 3 2
    In newer Fiori admin tools, you may also see an ICF Path field. Set this to /neptune/<YOUR_APP_NAME>/ (with the app name in uppercase).

Create a new tile

In the example below, a static tile is created:

resources help fiori launchpad 4
resources help fiori launchpad 4 2
resources help fiori launchpad 4 3

  • Use semantic object navigation: (selected)

  • Semantic Object: (Use the semantic object created, as described before.)

  • Action: (Choose a semantic action.)

resources help fiori launchpad 4 4

Add the tile to a group

resources help fiori launchpad 5 1
resources help fiori launchpad 5 2

Run

Run the SAP Fiori Launchpad. The new tile will now show.

resources help fiori launchpad 6

In case you get the error on the front end "Could not open App. Try again later" and the browser console shows an error similar to "Error - found in negative cache: com/titlemaster/Component.js from /sap/neptune/<APP_ID>/Component.js:

In the SAP Fiori Launchpad Designer, ensure the target mapping URL is set to /neptune/<application_id>/, including one more '/' after the Neptune application ID.

Reference: SAP Note 2428812