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

Semantic Object

If existing Semantic object will be used, note the semantic object name and proceed to Configure Gateway Launchpad. Else, follow these steps:

Creation of 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.


Configure Gateway Launchpad

If existing launchpad will be used, proceed to Configure Tile Catalog in gateway via Fiori Designer. Else, follow these steps:

Creation of 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:

Role

e.g. IQXDGW

Your own launchpad role name

Instance

TRANSACTIONAL

 

Description

e.g. IQX Launchpad

Your 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"


Configure Tile Catalog in gateway via Fiori Designer

Login to the Fiori Launchpad Designer via /UI2/FLPD_CUST or use these links:

 

URL for FLP Designer: -applied for SAP NW7.52 on-ward

QAS: https://<server host>:<port>/sap_flp_admin/main.html (access via QGW)

PRD: https://<server host>:<port>/sap_flp_admin/main.html (access via CGW)

 

URL for SAP FLP:

QAS: https://<server host>:<port>/sap_flp (access via QGW)

PRD: https://<server host>:<port>/sap_flp (access via CGW)

 

Old Link Pattern: <server host>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-client=<client>&sap-language=EN

 

If existing catalog will be used, click on the specific catalog and proceed to Configure Tiles in the Tile Catalog. Else, follow these steps:

Creation of new Tile Catalog
  • 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


Configure Tiles in the Tile Catalog

Dynamic Application

  • Configure target mapping via FLP Designer:

1. Pick a catalog

2. Click on “Target Mapping” tab

3. Click on “Create Target Mapping” button

4. Fill in target mapping form:

a. Intent section:

Semantic Object: <FAB FORM NAME> e.g.: XELLA_PROJECT_COMPLETION

Action: <Same as "Application Alias" from Launchpad> action

NOTE: The entry value in intent section will be used in Configure Tile

b. Target section:

Application Type: SAPUI5 Fiori App using LPD_CUST

URL: /sap/bc/ui5_ui5/iqx/fab2

ID: fab

Title: <free text > e.g.: Project Completion

c. Parameters section:

Name: FormName

Default Value: <FAB FORM NAME> e.g: XELLA_PROJECT_COMPLETION

<FAB FORM NAME> should be the technical name of the FAB Application. (NOTE: Leaving this value blank will redirect the tile to the FAB Launchpad)

 

5. Click on “Save” Button

6. Newly created target mapping:

 

  • Configure Tile via FLP Designer:

1. Pick a catalog

2. Click on “Tile” tab

3. Click on “Create Tile” button

4. Select “App Launcher – Static” tile. You should then see the configuration screen for a tile

5. Fill “Tile” configuration form:

a. General – related information of FAB Form/app, could be found in FAB Form properties

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>

b. Navigation:

Check on – Use semantic object navigation

Semantic Object: <FAB FORM ID> e.g.: XELLA_PROJECT_COMPLETION

Action: <Enter the "Application Alias" from launchpad> action

6. Click “Save” button

7. Newly created tile:

8. Tile is now available for user to added into group via FLP App Finder

Stand-A-Lone Application

  • Configure target mapping via FLP Designer – access to Target Mapping form is similar to Dynamic app.

1. Pick a catalog

2. Click on "Target Mapping" tab

3. Click on "Create Target Mapping" button

4. Fill in target mapping form:

a. Intent section: 

Semantic Object: <FAB Form Name > e.g.: IQX_PORTFOLIO_MANAGEMENT

Action: <Same as "Application ALias" from launchpad> action

NOTE: The entry value in intent section will be used in Configure Tile

b. Target section:

Application Type: SAPUI5 Fiori App using LPD_CUST

URL: <url path to the stand-a-lone ui5 app on QGW/VGW> e.g.: /sap/bc/ui5_ui5/sap/ZIQX_PORTFOLIO

ID: <name the id of the target> e.g.: iqx_portfolio_management

Title: <tile name> e.g.: Portfolio Management

Application URL can be found in the Properties dialog of a FAB Form:

c. Parameters section: – not required.

5. Click on “Save” Button

 

  • Configure Tile via FLP Designer: - access to Target Mapping form is similar to Dynamic app.

1. Pick a catalog

2. Click on “Tile” tab

3. Click on “Create Tile” button

4. Select “App Launcher – Static” tile. You should then see the configuration screen for a tile

5. Fill “Tile” configuration form:

a. General – related information of FAB Form/app, could be found in FAB Form properties

Title:<Your app title>

Subtitle:<Your app subtitle>

Keywords:<some keywords for your app>

Icon:<Select from drop down or refer toIcon Explorer site>

Information:<Additional information for your app>

b. Navigation:

Check on – Use semantic object navigation

Semantic Object: <filled value in step 4.2. Stand-A-Lone Application > Configure target mapping > Intent Section > Semantic Object> e.g.: PORTFOLIO_MANAGEMENT

Action: <filled value in step 4.2. Stand-A-Lone Application > Configure target mapping > Intent Section > Action> e.g: display

6. Click “Save” button

7. Newly created tile:

8. Tile is now available for user to added into group via FLP App Finder

 

SAP Role in Gateway and User Assignment

  • 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.


Adding new tile into own user 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.