Understanding Troubleshooting

Objective

After completing this lesson, you will be able to understand Troubleshooting

Troubleshooting Overview

There are multiple ways to troubleshoot SAP Fiori. This section presents some high-level approaches as to how to enter the area of troubleshooting SAP Fiori.

Figure outlines the starting points for SAP Fiori Troubleshooting

Some examples for "Conventional" Logs & Traces, which is mentioned in the figure, SAP Fiori Troubleshooting – Starting Points, are as follows:

System Log (transaction SM21)
System Trace (transaction ST01)
Authorization Trace (transaction STAUTHTRACE)
ICM Log (transaction SMICM)

These are not specific to SAP Fiori and are not covered further in this training.

Figure shows the Troubleshooting Section of the SAP Fiori Launchpad Online

SAP online documentation for SAP Fiori launchpad offers a section Troubleshooting at https://help.sap.com/docs/ABAP_PLATFORM_NEW/a7b390faab1140c087b8926571e942b7/5ea913a6ddb842e9afd6decb84261fcf.html?locale=en-US.

Figures shows Troubleshooting, Deployment Guides and Tools at Support by Product - SAP Fiori for SAP S/4HANA

Another good starting point is the Troubleshooting, Deployment Guides and Tools section of the SAP Fiori for SAP S/4HANA page of the Support by Product site.

Figure shows the Launchpad Support Tools in the within the Display IMG of the system

Within the SAP system, you can launch many support tools from transaction /UI2/CUST at path UI Technologies→SAP Fiori→Launchpad Support Tools.

SAP Fiori Launchpad Content Aggregator

The launchpad content aggregator (transaction /UI2/FLPCA) provides an aggregated list of the content available in the SAP Fiori launchpad content manager (customizing scope). The report can be used for reporting or for offline analysis. It is based on role level and shows assigned catalogs, tiles and target mappings, and optionally, corresponding OData services and ICF services.

The following features are available:

Display an aggregated view of selected roles and their related content
Export a spreadsheet for further analysis
Adjust the list by adding or removing columns

Analyze Role Content and Services

Business Example

In this exercise, you will analyze the SAP Fiori-related content of a role.

Note

In this exercise, when an object name or value contains ##, replace ## with the number your trainer assigned to you.

Task 1: Execute the SAP Fiori Launchpad Content Aggregator

Steps

Analyze your Z_##_BR_UX200 role including SAP Gateway and ICF services using the SAP Fiori launchpad content aggregator (transaction /UI2/FLPCA).
1. Log on to your SAP system using the train-## user.
2. Enter transaction /UI2/FLPCA.
3. At Role Filter, select your Z_##_BR_UX200 role. Select both options Display OData Services and Display ICF Services.
4. Choose Execute (F8).
5. Note the output. You have to scroll to the right to see all columns.
  Hint
  You may choose Export→Spreadsheet to export the table, for example, as an xlsx file.

Result

You can use the SAP Fiori launchpad content aggregator to analyze the SAP Fiori-related content of a role.

App Support

The App Support plugin allows you to troubleshoot configuration and authorization errors of applications in the SAP Fiori launchpad.

The prerequisites are as follows:

SAPUI5 version 1.84 or higher
The authorization logs for the BES require SAP_BASIS release 7.50 or higher. Consider implementing SAP Note 2871194.
To be able to view and download logs, you need an authorization for object S_FLP_AS. In the authorization field SUI_ADEUS, you can control if users are allowed to see the logs from other users. The value CURRENT restricts you to see logs from other users. The value ALL allows you to see logs from other users.
Most of the displayed logs have their own authorization checks. To be able to display the content of these logs, the following authorizations also need to be maintained:
- ADEFRONTENDERRORLOG
- ADEFRONTENDRUNTIMELOGS
- ADELOCALAUTHORIZATIONLOG
- ADEREMOTEAUTHORIZATIONLOG
- ADEREMOTEERRORLOG
- ADEREMOTERUNTIMELOG

Figure shows a labeled screenshot that demonstrates the following task: Activate FLP Plugin for App Support (within the system)

Task Activate FLP Plugin for App Support of task list SAP_FIORI_FOUNDATION_S4 performs the following to enable the App Support feature:

Activate the following ICF services:
- /sap/bc/bsp/sap/sui_flp_app_sup
- /sap/bc/ui5_ui5/sap/sui_flp_app_sup
Register SAP Gateway service SUI_FLP_APP_SUP_SRV
Activate the FLP plugin APP_SUPPORT

As an alternative to the last item, you can also set up your plugin by creating a custom catalog. The plugin is delivered in the technical catalog SAP_TC_FLP_COMMON.

For more details, refer to the SAP online documentation, using the search term "setting up app support".

Use App Support

Business Example

In this exercise, you will use the App Support feature to troubleshoot configuration and authorization errors in the SAP Fiori launchpad.

Note

In this exercise, when an object name or value contains ##, replace ## with the number your trainer assigned to you.

Task 1: Optional: Check System Settings for App Support

Steps

In your SAP S/4HANA system, check the activation status of the following ICF services:
- /sap/bc/bsp/sap/sui_flp_app_sup
- /sap/bc/ui5_ui5/sap/sui_flp_app_sup
1. Log on to your SAP system using the train-## user.
2. Enter transaction SICF.
3. In the Service Name field, enter *app_sup and choose Execute (F8).
  Note
  These two ICF services were activated by the task, Activate HTTP services Foundation, of the task list, SAP_FIORI_FOUNDATION_S4.
Result
Both ICF services should be active.
In your SAP S/4HANA system, check the registration status of the SUI_FLP_APP_SUP_SRV SAP Gateway service.
1. Continue working in your SAP system using the train-## user.
2. Enter transaction /IWFND/MAINT_SERVICE.
3. Choose Filter.
4. In the External Service Name field, enter *app_sup* and choose Continue.
  Note
  The SAP Gateway service SUI_FLP_APP_SUP_SRV was registered by the task, Activate Gateway OData Services Foundation (/IWFND/MAINT_SERVICE), of the task list, SAP_FIORI_FOUNDATION_S4.
Result
The SAP Gateway service SUI_FLP_APP_SUP_SRV should be registered.
In your SAP S/4HANA system, verify that the FLP plugin APP_SUPPORT is active.
1. Continue working in your SAP system using the train-## user.
2. Enter transaction /UI2/FLP_CUS_CONF (FLP Customer Settings).
3. In the Dialog Structure pane (at the left), double-click FLP Plugins.
  Note
  The plugin SUI_FLP_APP_SUP_SRV was activated by task Activate FLP Plugin for App Support of the task list, SAP_FIORI_FOUNDATION_S4.
Result
The plugin SUI_FLP_APP_SUP_SRV should be active.

Task 2: Test the App Support

Steps

Verify that you can access the App Support for any of your SAP Fiori apps.
1. Start or reload the SAP Fiori launchpad of your SAP system in a client of your choice.
2. Start any SAPUI5 app, for example, the View Browser app.
3. Choose the User Actions menu (user icon in the upper-right corner).
4. Choose App Support.
5. Choose Embedded Server (in the left pane) and perform some of the Manual Checks offered.
6. Choose Download Logs, and open the downloaded .xlsx file using Microsoft Excel.
7. Optional: Choose Download SAP Fiori Logs, and open the (zipped) text file with a text editor of your choice.

Result

You used the App Support feature.

Next lesson