Show TOC

 SAP Smart Business Modeler Apps


The SAP Smart Business modeler apps are a set of SAP Fiori apps that you use to create and manage SAP Smart Business entities.


You must be assigned the following roles to use SAP Smart Business applications:






The Java Runtime Environment (JRE) used by the browser on the client must be greater than or equal to version 1.8.

Note Note

SAP Smart Business modeler apps require that the underlying OData services implement the following annotations:

  • The entity type should have the annotation sap:semantics=”aggregate”

  • The properties within the entity type should have the following annotations:

    • measure

      The property represents a measure whose values will be aggregated according to the aggregating behavior of the containing entity type. This is only valid for properties of an entity type that is annotated with sap:semantics=“aggregate“.

    • dimension

      The property represents the key of a dimension. This is only valid for properties of an entity type that is annotated with sap:semantics=“aggregate“.

  • For each property, use the annotation sap:label set the short, human-readable text suitable for labels and captions on the UI.

  • For each dimension, use the annotation sap:filterable=”true” | ”false” to specify if the dimension can be filtered. Further, the property can be annotated with the sap:filter-restriction attribute, if filter restrictions exist. The attribute can take the following values:

    • single-value

      Only a single eq clause is possible.

    • multi-value

      Multiple eq clauses separated by OR, are possible

    • interval

      At most one ge and one le clause, separated by AND. Alternatively, a single eq clause.

  • For each dimension, if the query requires a filter to be set on the dimension, use the annotation sap:requires-filter=”true” | “false”.

  • For a measure, Measure M, if the measure value is comprised of a unit, then execute the following steps:

    1. Add another property, Measure M Unit

    2. Describe the semantics of this property by using the annotation sap:semantics=”unit-of-measure”

    3. Describe the relationship between value and unit by annotating property Measure M with sap:unit=Measure M Unit

  • For a measure, Measure M, if the measure value is comprised of a currency, then execute the following steps:

    1. Add another property, Measure M Currency

    2. Describe the semantics of this property by using the annotation sap:semantics=”currency-code”

    3. Describe the relationship between value and currency by annotating property Measure M with sap:unit=Measure M Currency

End of the note.


The following SAP Smart Business modeler apps are available:

  • Create KPI

    You use this app to create key performance indicators (KPIs) or operational performance indicators (OPIs). KPIs identify and measure the key metrics of a business. OPIs are similar to KPIs in that both measure the metrics of an aspect of a business. But while a KPI looks at broad categories (for example, car sales in a particular country or region), an OPI measures a specific process or operation - typically one at a bottleneck for a business. For example, an OPI for a shipping company would look at orders shipped on time. You can save KPIs or OPIs in an intermediate state if the complete information is not yet available (for more information, see Create KPI under Related Links in this document). For more information about statuses, see section SAP Smart Business Entity Statuses in this document.

  • Create Evaluation

    You create an evaluation to define a specific representation of a KPI or OPI, which means that you define a certain selection of the KPI data, the targets and thresholds that are relevant, together with some additional information. For example, you have defined a KPI to monitor car sales in a particular country. You can then create an evaluation that restricts the results to a certain area of that country for which one sales representative is responsible.

    You must specify an active KPI or OPI when you are creating an evaluation. The KPI data is copied to the evaluation as a proposal but you can overwrite it later.

  • Manage KPI Authorizations

    You use this app to authorize users or user roles for evaluations. An SAP Smart Business user can only see an evaluation, its tiles, and its drill-down views at runtime when you assign the user or role to the evaluation using this app and when you have activated all entities.

    Note Note

    An entity that you create using the SAP Smart Business modeler apps is not automatically visible to you when you logon to the runtime environment unless you have been authorized for the related evaluation.

    End of the note.
  • Configure KPI Tiles

    With this app, you configure tiles for active evaluations as the starting point for further analysis of a KPI or and OPI. At runtime, you click the KPI or OPI tile to open either an SAP Smart Business generic drill-down application or another type of specified analysis screen (for example, SAP Lumira). You can choose how to visualize the tile by selecting one of the available tile types (numeric, comparison, trend, or actual vs. target).

  • Configure KPI Drill-Down

    You use this app to configure different views, charts, filters, and associated KPIs for an active evaluation. You configure the drill-down so that you can analyze the KPI or OPI in further detail at runtime.

  • Manage KPI Associations

    This app allows you to define a relationship between active KPIs. You can choose to define either a supporting or a conflicting association depending on the relationship between the two KPIs. Supporting associations apply when the two KPIs influence each other in a positive way, for example, the net advertisement cost and the cost of manufacturing for goods contribute to the cost of goods sold KPI.

    Conflicting associations apply when two KPIs influence each other in a negative way, for example, the net sales and net cost KPIs are associated in a conflicting way to provide a value for the net revenue KPI.

  • Delete Personalized KPI Tiles

    You use this app to delete KPI tiles created using the Saves as Tile feature in the generic drill-down app.

  • KPI Workspace

    The KPI Workspace app allows you to access all of your KPIs or OPIs in one place. You can activate, edit, delete, or duplicate a KPI or OPI as well as add them to your favorites.

  • Migration Tool

    Former versions of SAP Smart Business used a different architecture. You can use the migration tool app to migrate old KPIs and related entities to the latest version of SAP Smart Business, which offers improved usability and a newly designed user interface.

Note Note

The IDs of the Smart Business entities are no longer displayed by default. Also, users have to no longer enter the entity IDs. They are now automatically generated by the framework. However, users can change these auto generated IDs. To do this, users have to first choose Make ID Visible in the Fiori Launchpad user settings. Any change to this ID visibility setting is persisted for the user in all sessions and across all the modeler apps.

The ID of an entity can be edited only until the first instance of save operation.

The search operation now works on entity title and tags instead of the entity ID field.

End of the note.

In addition to the modeler apps, a download tool is also available. You can use the SAP Smart Business Download Tool to copy SAP Smart Business content, such as KPIs, evaluations, and drill-downs, from one SAP system to another. This tool allows you to download SAP Smart Business contents to the file system of the device on which the tool is run. The content is downloaded as a set of csv files and one hdbti file. You can then upload these downloaded files to the HANA repository of the target SAP system.

Note Note

You can this tool only to download content from a SAP system. You cannot use this tool to upload content to a SAP system.

End of the note.

You can also use this tool to download analytical privileges and roles. To do this, you create an empty role and assign all the required evaluations to it. This empty role is then provided to the download tool, which in turn generates a set of analyticalprivilege files and one hdbrole file. These files can then be uploaded to the HANA repository of the target SAP system.

Based on the release, you can use one of the following URLs to launch the download tool:

  • For Q2/2015 and later releases, use <HANA_Server>:<HANA_PORT>/sap/hba/r/sb/transp/WebContent/index.html

  • For all releases between Q3/2014 and Q1/2015, use <HANA_Server>:<HANA_PORT>/sap/hba/r/sb/transp/WebContent/index1.html

  • For Q2/2014 and earlier releases, use <HANA_Server>:<HANA_PORT>/sap/hba/apps/kpi/transp/WebContent/index.html

Note Note

You cannot download Smart Business associations using this tool. The associations have to be manually created again in the target SAP system.

For Q2/2014 and earlier releases, the text that you enter while downloading the Smart Business content will be used to fetch all the entities whose IDs start with the entered text.

For Q3/2014 and later releases, when selecting the KPIs, the search text that you enter will be used to fetch all the KPIs whose titles match the entered text.

End of the note.

Interaction Between SAP Smart Business Modeler Apps

KPIs and OPIs are the central entities of SAP Smart Business. You can create KPIs and OPIs using the Create KPI app. Based on this KPI or OPI, you can then create an evaluation using the Create Evaluation app.

When you have created an evaluation, you must choose a tile to visualize the KPI or OPI using the Configure KPI Tiles app. This lets you define how the tile appears in the runtime environment (for example, the SAP Fiori Launchpad). You must then define what happens when the SAP Smart Business user clicks the KPI or OPI tile at runtime. You define this using the Configure KPI Drill-Down app.

If required, you can define associations between KPIs using the Manage KPI Associations app. You can add associated KPIs to a KPI’s drill-down where they are displayed in the header area in the form of KPI mini charts. Finally, you must define which user or user role can access the evaluation and related entities at runtime. You do this using the Manage KPI Authorizations app.

You can manage all KPIs, OPIs, and evaluations that are available in the system through the KPI Workspace app. If you have used previous versions of SAP Smart Business, you can migrate your existing KPIs and related entities to the new SAP Smart Business version using the Migration Tool app.

SAP Smart Business Modeler App Users

The SAP Fiori Launchpad enables you to find and retain the modeler apps required to carry out your work (for example, by using role-based allocation of default apps and app groups and personalization to add or remove additional apps from a global catalog).

To create new KPIs, you must understand related KPIs from the same and from different business areas. You must also be aware of the implications from a business perspective of introducing the new KPI. Therefore, the Create KPI and the Manage KPI Associations apps are used principally by data analysts or operations office employees. In addition, technical knowledge and alignment with development teams that build SAP HANA views is required to link a KPI to a data source and provide the required input parameters.

IT administrative knowledge is required to authorize users and roles for evaluations and to define navigation targets for KPI tiles. Therefore, the Manage KPI Authorizations, Create Evaluation, and Configure KPI Tiles apps are used principally by IT personnel.

Business knowledge is required to configure the drill-down views correctly and as a result the Configure KPI Drill-Down app is used mainly by data analysts and power users that are close to business users who benefit from and use the drill-down views at runtime.

All user groups benefit from the versatility that the KPI Workspace app provides to search and browse through the KPI repository.

SAP Smart Business Entity Statuses




Entities are created but not yet active. All new entities that you create using the SAP Smart Business modeler apps have this status by default. New entities do not appear at runtime until you activate them.


Active entities are visible in the runtime environment (for example, in the SAP Fiori Launchpad). When you edit an already active entity, a draft version is created and changes only become visible at runtime when you reactivate the entity.


When you edit an already active entity, a draft copy is created and all further changes are applied to this copy until it is activated. They become visible at runtime when you activate the draft and at that point it replaces the existing active version.

Note Note

Authorizations and drill-down configurations do not have draft versions. They are immediately in an active state when you save them.

End of the note.

Using SAP Smart Business Content in a Customer Environment

The SAP HANA Live content delivered to you is the basis for using the power of SAP HANA for drill-down and filtering based on real-time data from your existing business suite system. The SAP Smart Business framework allows you to build apps and helps you to steer your company with real-time KPIs. The SAP Smart Business content is provided as a template to get you started building and using industry-strength KPIs.

Use Cases

  1. Validation of Technical Installation and Configuration

    To check whether the SAP Smart Business framework and all required components are installed and configured correctly, you can use the content provided with the SAP HANA Live Program. For example, you can use the SAP Smart Business for Sales Order Fulfillment content and combine it with your data from the Sales and Deliveries (SD) module.

    To enable this use case, the content provides SAP HANA Live views, OData service definitions, KPIs, evaluations, tiles, and drill-down configurations. All of them appear in the Active status in the system in which you install the content.

    If a user has the two required roles allocated to them on both the SAP HANA server and the ABAP server (and has the correct analytical privileges) the only additional steps that you must take to allow this user to add the tile to their home page and create a drill-down are as follows:

    1. Make data available in the tables that are the basis for the SAP HANA Live views.

    2. Change the filters and input parameters of the delivered evaluations to match the data that you have in the system and other parameters (such as the client and display currency).

  2. Proof of Concept and Rapid Prototyping

    After you complete the steps described in use case 1 (Validation of Technical Installation and Configuration) using meaningful production data, you can work with business users to demonstrate the possibilities offered by the KPIs and drill-downs. In addition, you can prototype KPIs, tiles, and drill-downs to match their requirements. This lets you engage the business users in quick, iterative cycles to demonstrate what they must do to carry out customizing and set it to go-live.

    Note Note

    When you re-import SAP content or upgrade it to the newest version, your adjustments to evaluations and any other changes to SAP content are lost or the system may override them.

    End of the note.
  3. Productive Use

    Ahead of productive use, we recommend that you either copy the KPIs, evaluations, tiles, and drill-down configurations or re-create them in your own namespace to prevent unexpected outcomes if you install a new version of SAP delivered content.