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.
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:
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:
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:
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’:
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:
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:
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:
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:
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:
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.