How To Transport KPI Tile Application Step-By-Step Guide in S4HANA
How To Transport KPI Tile Application Step-By-Step Guide in S4HANA
Application Step-by-Step
Guide in S/4HANA
16101809 On-Premise
S4H – Gateway
How to Setup a Fiori Tile Step-by-Step Using Web IDE www.sap.com
TABLE OF CONTENTS
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|2
CHAPTER 3 CONFIGURING FIORI LAUNCHPAD .............................................................................................. 26
Configuring Fiori Launchpad Designer with Transport Requests ............................................................................ 26
Creating Catalog and Group in Fiori Launchpad Designer ....................................................................................... 31
Configuring and Assigning Catalog and Group to Role ............................................................................................ 37
CHAPTER 5 CONFIGURING A KPI TILE ............................................................................................................ 44
Creating a KPI Tile .................................................................................................................................................... 44
Assigning the KPI Tile to a Group ............................................................................................................................. 60
Verify the KPI Tile is working in Fiori Launchpad ..................................................................................................... 64
Verify the App Variant and Catalog are locked in the Transport Request............................................................... 65
Transporting to Production ..................................................................................................................................... 71
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|3
Abstract
Chapter 1 – Requirement
1.1. Introduction
1.2. Overview of the Architecture
1.3. Overview of what type of transports are needed
1.4. Overview of what type of packages are needed
1.5. Overview of what type of role is needed for the KPI Design
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|4
Chapter 5 – Troubleshooting
5.1. Tile failed to display
5.2. How to Access App Variant from the SAP Gateway frontend system?
5.3. Unspecified error when activating Evaluation
Chapter 1 Introduction
Welcome to How to Transport KPI Tile Application Step-by-Step Guide in S/4HANA. In this white paper we will introduce you to all the
requirement needed in order to transport a KPI tile from one system to another system.
In this whitepaper we will discuss and show the user how to create and configure:
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|5
• What type of transports are needed
• How to configure KPI Design and Fiori Launchpad to capture the data in order to transport them to another system
• What needs to be transported
Before we can start our configuration, we need to look at the Architecture that this whitepaper will address. This whitepaper will cover the
following scenario:
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|6
Development/Quality:
Frontend S/4HANA
(Backend)
GWD RFC
S4D
Production
TRANSPORT
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|7
Frontend S/4HANA
RFC
GWP (Backend)
S4P
Gateway Frontend Dev/Quality CUSTOMIZING REQUEST Is needed to store the tile and
(GWD) target mapping configuration
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|8
Gateway Frontend Dev/Quality WORKBENCH REQUEST To store the App Variant.
(GWD) What is an App Variant?
• App Variant will have
what component to
load which represents
the App configuration
of the BSP UI5
application
• Without the App
Variant, the
application will hang
because it will not
know what todo
RIG Step-by-step guide to modify currencies in standard delivered KPI tiles Page|9
• Is needed to store the
S4H Backend Dev/Quality WORKBENCH REQUEST Annotation model
(S4D) while
activating Evaluation
• This is needed in
order to store details
about the evaluation
such as data source
and service
• Without the
Annotation will the
KPI will not know
what to load and
hence the tile will fail
to load.
• A package for the Gateway frontend system. This is required for the Workbench request
• A package for the S/4HANA backend system. This is required for the Workbench request
In order to have access to the KPI Design in Fiori Launchpad, the user must have the following role, SAP_BR_ANALYTICS_SPECIALIST, assigned
to them.
Chapter 2
The Administrator must create the transports in the frontend and backend systems before creating the
• KPI tile
• Evaluation
• Fiori Catalog
• Fiori Group
Frist we need to login to the SAP Gateway frontend system to create three things:
• Customization Request
• Workbench Request
• And a package
3. Click on the New button to create a new Customizing Request as shown below in the yellow highlighted icon
4. Select Customizing Request and click on the confirm button as shown below
6. After filling the required information, click on Save Note: Short Description it can be
anything the user likes
As we mentioned before, this is needed to store the App Variant. Without it, when the user tries to access the application after transport, the
application will not load. It will spin forever.
Chapter 3
Configuring Fiori Launchpad
1. Configure Fiori Launchpad Designer at the CONF layer in order to store the App Variant information
2. Second configure Fiori Launchpad Designer at the CUST layer in order to store catalog, tile and group information
1. Login to Fiori Launchpad Designer using Chrome or IE and type the following URL:
HTTP(S)://<HOST>:<PORT>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?scope=CONF&saplanguage=EN
Note: Make sure in the URL you have scope=CONF CONF is a case sensitive, so it has
to be upper case.
2. To confirm the user is logged in to CONF layer, the following indication should be displayed on the on the top right of the browser:
4. Select the Workbench of the SAP Gateway frontend system as shown below:
Note: Your screen may be different than ours if you have more than one Workbench request
Now that we have configured Fiori Launchpad Designer under the CONF layer with a Workbench request, next we need to configure Fiori
Launchpad Designer with the Customization Request. To do that, do the following:
2. Once logged in, the client number will be displayed on the top right of the Fiori Launchpad Designer as shown below:
Note: If the user still see Client:All still showing, that means you are still logged in to the CONF layer.
5. We need to uncheck it and select our SAP Gateway Frontend Customization Request as shown below:
Now that we Fiori Launchpad Designer is configured with our transports on both layers, we need to create few things:
1. First the Catalog where we are going to store our Fiori KPI Tile
2. Second the Group that is going to display our KPI Tile
1. Login to Fiori Launchpad Designer under the CUST layer 2. Click on the Catalogs tab as
shown below:
4. Click on Save
5. Now we have a Group created as shown below:
Now that we have a Catalog and Group created, next we need to create a Role or use an existing Role and assign the Catalog and Group to this
Role and finally assign it to the user who wants to access this Catalog and Group.
7. Under Menu now click on the dropdown list and select SAP Fiori Tile Catalog as shown below:
8. Enter the Catalog ID not the Catalog name from the previous step and click the green check button:
12. Enter the Group ID as shown below and click on the green check icon
16. Note: For Smart Business you do not need S_SCOPE Authorization Object. This can be deactivated.
a. Go to Authorizations tab in edit mode
b. Click on Expert Mode for Profile Generation
Chapter 4
Configuring a KPI Tile
Now that we prepared our system and created all the transports that are required as well as the Catalog, Group and Role, we are now ready
to create our KPI tile
4. KPI creation dialog is displayed, enter the following information or if you have your own specific information:
2 Copy Standard KPI evaluation
Step/Description Screenshot
**NOTE– Workbench request and Package are required when creating a KPI from scratch, in this
scenario we will only
create a new evaluation which requires a Customizing request.
**NOTE – We are selecting the option “Copy evaluation and all its entities” as we want
drilldowns and will only modify the currency parameter.
7.
Select the KPI where
you wish to place the
copy (in this case we
are using the same KPI
Purchase Order Value).
8. Once the copy is finished you will
notice that there is a new
evaluation for the KPI. Navigate to
the evaluation to modify its
parameters.
1. Review the
evaluation
parameters and
click on “edit”
52
Navigate to the input
2. parameter configuration and
modify the currency value.
Click on “Activate” once you
have finished your changes.
As there is no tile
4. defined for the
evaluation click on the
“Add Tile” button.
53
We will use a numeric
5. tile and assign the tile
to a catalog. Click on
the Catalog search
help.
**NOTE – Always check documentation available at Fiori Apps Library to identify the catalogs
Click on Save and go
7. back to the KPI main
screen. Make sure your
evaluation copy
displays active status
54
1. Add the custom
KPI by
personalizing
your
Launchpad.
Click on the
edit icon and
add a new tile.
55
Figure 87 Accessing Fiori Group
8. Click on the + sign on the right under Show as Tiles:
9. Select your SS KPI Catalog as shown below and click on the + sign to add it to the group
56
Figure 89 Accessing the Catalog in order to access the Tile
10. Tile has been added to the Group:
57
Figure 90 Tile has been added to the Group
58
Figure 92 Fiori KPI Tile
Verify the App Variant and Catalog are locked in the Transport Request
Now that the tiles and catalogs all configured, let confirm this by login into the SAP Gateway System frontend
system.
3. Click on Display. As we can see below, our configuration is locked in the transport
59
Figure 94 List of Transports
4. Next we need to verify if everything is logged in the App. Variant. Open your Web Browser
5. Enter the following URL
HTTP(S)://<HOST>:<PORT>/sap/public/bc/ui5_ui5/resources/sap/ui/fl/support/apps/contentbrowser/in
dex.html?#
6. The following LREP will be displayed. Click on the CUSTOMER layer
60
Figure 95 LREP Layers
7. Click on app
10. Search for the App Variant that we copied from before under the section “Assigning the KPI Tile to a Group”
as shown below:
62
Figure 99 Customer appVariants
11. Click on the AppVariant, customer.kxxxx
12. Click on manifest. We will see all the configuration about the KPI tile
Note: In the manifest we can see all the details about what Annotation and what is the AppVariant that
is needed in order to load the tile
13. If we click on the Metadata icon as shown below, we can see all the details about if the AppVariant is
recorded in the transport and which layer it is. As we can see below it is CUSTOMER layer which is what
we are looking for in regard to custom KPI Tile:
63
Figure 102 Checking the Metadata
Transporting to Production
Now that everything is confirmed and configured. We are ready to Transport to production from Dev or Quality.
Your BASIS Administrator needs to transport the following:
After the transport is successfully done to production, the user should be able to access the Tile through the
same Group and Catalog. If the user experienced hanging problem or the Title is not displayed, or the Tile failed
to load, check the Troubleshooting Chapter for the resolution.
64
Chapter 5
Troubleshooting
How to Access App Variant from the SAP Gateway frontend system?
If the user is not able to access the LREPk through the browser in order to access the App. Variant, then follow
the resolution section below:
Resolution:
65
Figure 103 AppVarient through report
6. Click on Execute
7. We should see the following two records with Layer Type says CUSTOMER
8. If we need to display the content, we will highlight the record with CUSTOMER layer type and click on
display content as shown below:
66
Figure 106 Displaying the content of manifest
After creating a KPI successfully, an error is generated when activating the Evaluation:
ERROR_INFO Unspecified error occurred. See Error Context and Call Stack for details
Resolution:
Please refer to the following KBA: 2537540 - Unspecified error when activating Evaluation
67