Skip to Content
Technical Articles
Author's profile photo Vincent Zhu

Adding Custom Program to Fiori Launchpad

1. Background

As SAP ECC customers decide to move to an S/4HANA Cloud system, they might have a requirement to keep some of their custom programs (Z-programs) for business continuity purposes. Consequently, these custom programs might need to be enabled to be accessible from the Fiori launchpad in order to provide the business end users with a consistent and harmonious user experience. The purpose of this blog is to provide a step-by-step guide on how to add ABAP custom programs to the Fiori Launchpad.


2. Prerequisite

The target system is either an SAP S/4HANA Cloud, extended edition or SAP S/4HANA Cloud, private edition and the customer has the requirement to keep some of their existing ABAP programs.


3. Demo Custom Program

For demo purposes, we have a custom program which allows users to search for flight details based on airline codes:

As an example, enter the airline code: AA (abbreviation for American Airlines)

Click on the ‘Execute’ button to get presented with the search results:


4. Steps

4.1 Maintain custom transaction code

First, we need to maintain a custom transaction code for the custom program.

Enter ‘SE93’ and create the custom transaction code ‘ZCARR’ as a next step:

In the pop-up window, enter the short text and choose ’Program and selection screen (report transaction)’ under the available options for the Start object:

On the next screen, enter the custom program name in the Program field, and choose the checkbox ‘SAP GUI for HTML’ under the GUI Support section and, click the ‘Save’ button.

A confirmation message will pop up on the screen to inform the user that the custom transaction code was created successfully:


4.2 Create Semantic Object

Enter Transaction ‘SPRO’, choose ‘Define Semantic Objects for Navigation’ which can be found following this navigation path: SAP NetWeaver -> UI Technologies -> SAP Fiori -> Configuring Launchpad Content -> Adding Apps to SAP Fiori Launchpad:

Click on the ‘New Entries’ button to create a new semantic object ‘ZSO_CARR’ as shown in the example below:


4.3 Create Catalog

Choose ‘SAP Fiori Launchpad Designer (Current Client)’ which can be found under ‘Configure Target Mappings and Tiles’ by following the navigation path: SAP NetWeaver -> UI Technologies -> SAP Fiori -> Configuring Launchpad Content -> Adding Apps to SAP Fiori Launchpad

Click the ’Plus’ icon at the left bottom of the screen to create a new catalog:

Enter the catalog title and ID as shown below, and click ‘Save’:


4.4 Create Target Mappings

Click on the ‘Target Mappings’ icon at the top of the screen, and then click on the ’Create Target Mapping’ button at the bottom of the screen:

On the Target Mapping configuration screen, choose the semantic object ‘ZSO_CARR’ that was just created, choose ‘display’” under the available options in the ‘Action’ field, ’Transaction’ under the available options in the ‘Application Type’ field, enter the Title and Transaction Code ‘ZCARR’ and finally click on the ‘Save’ button at the bottom of the screen:


4.5 Add Tile

Choose the ’Tiles’ icon, then click on the ‘Plus’ icon to add a tile:

On the next screen, choose the ’App Launcher – Static’ template from the available options of tile templates:

Enter the following details: Title, Subtitle, Keywords, Icon, Information, Semantic Object and Action before saving your newly created tile:

As you will see in the screenshot below, the new Fiori Tile ‘Flight Details’ was created successfully:


4.6 Create Group and assign Tile to Group

Choose ‘Groups’ from the top toolbar, and then click on the ‘Plus’ icon on the left bottom of the screen to create a new group:

In the pop-up window, enter the Group Title and Group ID, and click on the ‘Save’ button:

On the next screen, click on the ’Add Tile’ icon to assign the Tile to the Group:

Click the ‘Plus’ icon in order to add the newly created tile to the group ‘Legacy Reports’:

On the screenshot below we can see the new tile has been added to the Group ’Legacy Reports’ successfully:


4.7 Create Role and Add Authorizations

Under transaction code ‘PFCG’, enter the role ID ‘ZR_REPORTS’, and click on the ’Single Role’ button:

Enter the Description for the role, click on ‘Menu’ button in the menu bar:

Select ‘Yes’ on the pop-up window that appears next:

Under Transaction, choose ’SAP Fiori Tile Catalog’:

In the pop-up window, choose the Catalog ID ‘ZBC_CARR’, and continue by clicking the green check mark symbol at the bottom of the screen:

Under Transaction, then choose ‘SAP Fiori Tile Group’:

In the pop-up window, choose the Group ID ‘ZG_REPORTS’, and continue by clicking the green check mark symbol at the bottom:

As a last step, click on the ’User’ button on the menu bar, enter the user ID, and save your changes:


4.8 Access the Custom Program from Fiori

When logging onto the Fiori launchpad next, we can now see the tile ’Flight Details’ under Group ’Legacy Reports’:

Choose AA as  the airline code, and execute:

As you can see, we can now retrieve the report details directly from the Fiori UI:


4.9 Summary Diagram

To summarize the relationships of the objects that were created, please refer to the diagram below. Please note that the section numbers of the guide have been referenced in the diagram.


5. Conclusion

Following these steps, customers can keep their legacy business reports and access both the standard and custom apps directly from the Fiori launchpad.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Sandeep Kumar
      Sandeep Kumar

      Great illustration, thanks for sharing.

      Author's profile photo Kai Sicker
      Kai Sicker

      Great, thanks!

      Author's profile photo Prasanth Padmanabhan Menon
      Prasanth Padmanabhan Menon

      Great blog Vincent.

      Author's profile photo Jaspreet Singh
      Jaspreet Singh

      Thanks for sharing Vincent, will the public cloud customer have SAP GUI access to do the above shown configuration?


      Author's profile photo Vincent Zhu
      Vincent Zhu
      Blog Post Author

      Hi Jaspreet,

      The SAP GUI access is not available for S/4HANA cloud, Essential Edition.

      This feature is applicable to S/4HANA Cloud, Extended Edition and S/4HANA Private Cloud Edition.

      Author's profile photo Jaspreet Singh
      Jaspreet Singh

      Thanks for clarifying Vincent

      Author's profile photo Vipin Nagpal
      Vipin Nagpal

      Thanks for sharing. Is approach remain same for embedded and hub deployment mode?

      Author's profile photo Sridhar Kanchanapalli
      Sridhar Kanchanapalli

      I have created Tile for a custom Program (T-Code) which opens in the separate Tab, everything is fine, but i see Save / Cancel buttons on the bottom screen. How can i hide them? Only difference i see - you only selected "SAP GUI for HTML", but i have 3-selected in my T-Code.



      Save Cancel at the bottom

      Author's profile photo Szymon Glapiak
      Szymon Glapiak

      With cloud version can we build/use our custom z- programs? I think that custom development should be moved to sap btp?

      Author's profile photo Johann Fößleitner
      Johann Fößleitner


      do you talk about "public cloud"? - I'm afraid you can't develop Z-Reports in the public cloud. In the public cloud (S/4), everything runs a little differently.

      Also in Steampunk (ABAP Cloud) there is no GUI interface and therefore no classic Z-Reports.

      Regards, Johann

      Author's profile photo Mohit Sharma
      Mohit Sharma

      The navigation to define Semantic Object in step 4.2 is replaced as follows:

      Author's profile photo Chris Geladaris
      Chris Geladaris

      I believe the tcode is


      (Another way to navigate directly there)

      Author's profile photo Tatiana Sarmento Sears
      Tatiana Sarmento Sears

      Thanks for sharing!

      Author's profile photo Tomohisa Nakagawa
      Tomohisa Nakagawa

      Thanks for sharing this content!

      This blog is very helpful not only to add custom programs into the Fiori launch pads but also to add standard SAP T-Codes in the SAP WebGUI into it.

      Author's profile photo Bharath Padmanabhan
      Bharath Padmanabhan

      This blog is a lifesaver. Excellent presentation.


      Thank you so much for creating this blog.

      Author's profile photo Guru Balan
      Guru Balan

      Hi Vincent Zhu,


      I this possible in SAP S/4 Hana public cloud environment !

      Because there in no fiori launchpad designer in that.

      Thanks in Advance



      Author's profile photo Asim ahmed
      Asim ahmed

      Hi Vincent Zhu,


      Its a perfect blog. Thanks for sharing.


      Author's profile photo deepika khetade
      deepika khetade

      hi through SPRO and using /N/UI2/FLP from both my fiori launchpad not open what to do plz help.....