Adding Custom Program to Fiori Launchpad
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.
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.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.
Following these steps, customers can keep their legacy business reports and access both the standard and custom apps directly from the Fiori launchpad.
Great illustration, thanks for sharing.
Great blog Vincent.
Thanks for sharing Vincent, will the public cloud customer have SAP GUI access to do the above shown configuration?
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.
Thanks for clarifying Vincent
Thanks for sharing. Is approach remain same for embedded and hub deployment mode?
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
With cloud version can we build/use our custom z- programs? I think that custom development should be moved to sap btp?
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.
The navigation to define Semantic Object in step 4.2 is replaced as follows:
Thanks for sharing!
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.
This blog is a lifesaver. Excellent presentation.
Thank you so much for creating this blog.
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
Hi Vincent Zhu,
Its a perfect blog. Thanks for sharing.
hi through SPRO and using /N/UI2/FLP from both my fiori launchpad not open what to do plz help.....