Show TOC

Dynamic App Launcher TilesLocate this document in the navigation structure

In contrast to regular (static) app launcher tiles, the information that is displayed on a dynamic app launcher tile can be pulled from a back-end system using an OData service. This topic describes the parameters for configuring dynamic app launcher tiles.

The dynamic information pulled from the back end overwrites the configuration values given in the tile configuration. Some tile functionality (for example, the state arrow) can only be configured by dynamic information (and not in the tile configuration).

Note You can modify only the content of translatable parameters using the same logon language that was active when the catalog was created. For more information about translating customer-created tiles, refer to the related links below.
Table 1: General
Parameter Description Translatable
Title

Title to be displayed on the tile.

Yes

Subtitle

Subtitle to be displayed below the tile title.

Yes

Keywords

You can tag a tile with keywords so users can find it more easily using the search function in the tile catalog.

If you want to specify several keywords, use either space or comma as separator.

Yes

Icon

Use the value help to select an icon.

After you have selected an icon, the system inserts a URL starting with the sap-icon:// protocol.

These icons are based on SAPUI5 icon fonts. For more information, see Icon and Icon Pool.

No

Information

Text to be displayed at the bottom of the tile.

Yes

Number Unit

Enter the unit to be displayed below the number, for example, USD.

No

Table 2: Dynamic Data
Parameter Description
Service URL

URL of an OData service from which data should be read.

The response is expected in JSON format.

When the service is called, the values that are provided by the service override the values that have been configured manually in the tile details.

Note that the service is executed on the home page only. On the admin page, sample data is displayed instead.

Tip To read the number of entities from an OData service, use the $count parameter in the Service URL. If you are using a filter to limit the number of entries, use the $inlinecout=allpages parameter in the Service URL to display both the number after the filter and the number from the m:count property.

For more information about the service API, see OData Structure for Dynamic App Launchers.

Note

If the response is a numerical value over 1,000, the front end scales the number accordingly and adds a unit indicator (K, M, or B).

Refresh Interval Number of seconds after which dynamic content is read from the data source again and the display is refreshed.

The launchpad uses a default of 0 seconds unless you enter a higher value in this field.

The launchpad will fall back to 10 seconds, if the value entered is > 0 and < 10. If the value entered is 0, the dynamic tile is updated only once on load. If the value is >= 10, the value is taken as refresh interval.

Table 3: Navigation
Parameter Description
Use Semantic Object Navigation

Deactivate this checkbox if you want to define the navigation target using a simple URL rather than a semantic object.

Semantic Object

Semantic object to be referred when clicking the tile, for example Order.

This semantic object must be defined in Customizing. For more information, see Creating Custom Semantic Objects.

Action

Operation that is intended to be performed on the semantic object when the user clicks on the tile, for example display.

Parameters

Key-value pairs defining parameters for the semantic object, for example orderID=10000.

If you enter multiple parameters, separate them with an ampersand (&), for example orderID=10000&custID=c82200.

Target URL

You can enter any URL, for example http://help.sap.com.

Note that you have to provide a complete URL including the protocol (typically http:// or https://)

Note

If you choose to use semantic object navigation, the target URL will be automatically computed and inserted into this field.

Table 4: Tile Actions
Parameter Description Translatable
Menu Item

The name of the menu item that represents the action.

Yes

Target Type, Navigation Target, Action
The Target Type is one of the following:
  • URL - In the Navigation Target column, enter the target URL for the action. In this case, the Action column is disabled.
  • Intent - In the Navigation Target column, select the semantic object from the list. In this case, use the Action column to enter the action.

No

Icon

The icon to display next to the menu item.

No

Note To see tile actions in the launchpad, you must enable them in the launchpad configuration.
Tip Use the Add and Remove buttons at the bottom of the table to add and to remove actions.