Show TOC

Configuring the Smart Business KPI TileLocate this document in the navigation structure

The following tasks are performed using the Smart Business modeler apps.

Prerequisites:

  • You have used the SAP Smart Business modeler apps to create the following:
    • A KPI
    • An evaluation
    • A KPI tile
  • You have deployed a shipped APF-based application or created a configuration for an application that you want to launch using a Smart Business KPI tile.

You can now configure the KPI tile using the Configure KPI Tiles app. The data you must enter depends on, among other things, whether you use shipped content or content you created yourself.

You can create a KPI tile for the following types of applications:

  1. Shipped APF-based application – unchanged

    A configured BSP application that you use as it was shipped, without making any changes.

  2. Shipped APF-based application – enhanced

    A configured BSP application that you have imported and changed using the APF Configuration Modeler.

  3. Generic runtime application

    The generic APF runtime application is used to execute an APF configuration that you created using the APF Configuration Modeler.

  4. New application

    An application you have created using the APF Configuration Modeler without using the generic application.

    Note

    This requires defining your own BSP application and target mapping.

To configure a KPI tile for an APF-based application, open the Configure KPI Tiles app, go to the Navigation area and select the Other Drill-Down radio button. Select Analysis Path Framework as drill-down.

Depending on the type of application you’re using, enter the following data:

  Shipped BSP Application - Unchanged Shipped BSP Application – Enhanced Generic Runtime Application New Application
Semantic Object As defined in target mapping As defined in target mapping Prefilled: FioriApplication As defined in your own target mapping
Action As defined in target mapping As defined in target mapping Prefilled: executeAPFConfiguration As defined in your own target mapping
Configuration Not applicable Configuration title Configuration title Configuration title

If you use a shipped BSP application, a KPI tile may have been shipped along with it. In this case, semantic object and action are already filled.

Note

We recommend copying the shipped KPI, evaluation, and tile. You can then adapt them to your needs.

The semantic object and the action are used to determine the KPIs navigation target. If you have used the APF Configuration Modeler to create or enhance your application, ensure that the semantic object entered in the Modeler app is the same as the one you enter here.

To enter the configuration title, use the value help. The semantic object filters the list of configurations so that only those are listed that have been created for the specified semantic object. A configuration title also has a corresponding configuration ID, which is unique.

If you want to launch a shipped APF-based application without making any changes to it, entering a configuration title is not required. The configuration can be read directly from the analytical content configuration file. The location of this file is specified in the application configuration file, which is part of the BSP application.

If you have imported the JSON file of a shipped application into the APF Configuration Modeler, you must enter a configuration title to be able to launch the application. The corresponding configuration ID takes precedence over the location of the analytical content configuration.

A configuration title is also mandatory if you use the generic runtime application. The generic runtime application does not contain a reference to the location of the analytical content configuration file and therefore must be parameterized using a configuration ID.

By clicking Save and Configure Drill-Down, you can navigate to the APF Configuration Modeler to view or edit the configuration. This is useful because from here you can navigate directly to the relevant configuration. You cannot search for a configuration in the APF Configuration Modeler itself.

Application Parameters

You can configure your KPI tile in a way that it launches an APF-based application and immediately opens a specific analysis step and representation. You can do so by entering the following application parameters:

  • Analysis step:
    • Name: sap-apf-step-id
    • Value: step ID, for example, “Step-23”
  • Representation:
    • Name: sap-apf-representation-id
    • Value: representation ID, for example, “ Step-23-Representation-1”

You can look up the step ID and representation ID in the JSON file of the configuration. You may have to export your configuration first to get an up-to-date JSON file.

Entering a step ID is sufficient; you don’t have to enter a representation ID. If you only enter a step ID, the default representation is used.