Show TOC

OData Structure for Dynamic App LaunchersLocate this document in the navigation structure

To feed an app launcher with dynamic content, you have to create an OData service that returns the configuration properties as in the following example structure:

{
                "d": {
                               "icon": "sap-icon://travel-expense",
                               "info": "Quarter Ends!",
                               "infoState": "Critical",
                               "number": 43.333,
                               "numberDigits": 1
                               "numberFactor": "k",
                               "numberState": "Positive",
                               "numberUnit": "EUR",
                               "stateArrow": "Up",
                               "subtitle": "Quarterly overview",
                               "title": "Travel Expenses"
                     }
}
Table 1: Properties
Property Description
icon

Enter an sap-icon:// URL, for example sap-icon://cart.

You can look up the names of the available icons in tile configuration.

For more information, see Static App Launcher Tiles.

info

Text to be displayed at the bottom of the tile.

infoState

The color of the tile is adapted according to the value of this property. The precise color depends on the theme that you have selected in UI theme designer.

Allowed values: Negative, Neutral, Positive, Critical

number

Number to be displayed in the top right corner of the tile.

numberDigits Number of digits to be displayed following the decimal separator (decimal point or decimal comma, depending on the language settings).
numberFactor A factor for scaling numbers, for example, for displaying large numbers like 1.000.000 (-> number = 1 and numberFactor=“M”) or for percentages (number = 22.2 and numberFactor = “%”).
numberState

The color of the number is adapted according to the value of this property. The precise color depends on the theme that you have selected in UI theme designer.

Allowed values: Negative, Neutral, Positive, Critical

numberUnit

Unit to be displayed below the number, for example, USD.

stateArrow

Displays an arrow indicating a trend.

Allowed values: None, Up, Down

subtitle

Subtitle to be displayed below the tile title.

targetParams

List of key-value-pairs separated by ampersands.

When the application is launched (by clicking on it), these parameters are passed to the application as business parameters (if semantic object-based navigation is used) or as URL parameters (if URL-based navigation is used).

If any parameters have been entered in the Parameters field in the tile configuration, the parameters passed by the OData service are appended to the list of parameters to be passed to the application.

title

Title to be displayed in the tile.

If the service returns an entity collection (rather than a single entity), all values from the number elements are accumulated.