SAP Fiori Client Guide

Automatically Collected Data

When enabled by the server and initialized, the Usage plugin automatically collects some standard usage information and uploads it to the SAP HCP, mobile service for development and operations database.

By initializing the usage library, even if log() or timer() APIs are not explicitly invoked, the Usage plugin automatically gathers data about:
Table 6: Standard Usage Frequency Information

Usage Type


User sessions

A record of events and timer duration of the application in the foreground. A user session begins when the application comes to the foregroud (starts), and ends when the application goes to the background (stops).

Device OS, Device OS version, Device Model ID

Device information is obtained directly from the OS. See the Cordova Device plugin for implementation details.

Application ID, Application Version

Application information is obtained from the bundle.


Each time a user launches the toolbar, a record is logged of the button that was chosen (or "None" is logged if no buttons are selected). The record is tagged with UserSessionID, OS, Version, Model, APP, AppVersion information, and the item is logged into the Element column in the output data. For example, if a user displays the toolbar and chooses the settings button, the resultant row is:
| Column name |    Value   |
| ----------- | -----------|
| ELEMENT     | “settings” | 

SAP Fiori Launchpad Load Times

Measures the load time for the SAP Fiori launchpad page. The page URL is the one specified for the fioriURL property in the application configuration. Once all of the launchpad tile elements are visible on the SAP Fiori launchpad page, the timer stops.

For each launchpad load event, there are three possible results:
  • Success – the launchpad load is complete.
  • Interrupted – toolbar activity (back, refresh, home, etc.) interrupts the launchpad load, or the application goes to the background (no longer active).
  • Failed – the launchpad load fails, or error.html pages are loaded.
In the output data, the number of tiles is logged in the CASE infoType property, and the result is logged in the RESULT infoType property. For example:
| Column name  |         Value          |
| ------------ | ---------------------- |
| TIMESTART    | “2015-12-28 08:54:53”  |
| TIMEDURATION | 19027.7                |
| CASE         | 93                     |
| RESULT       | “success”