Tracking app usage with Mobile Dataviews

The database entity MobileApp can be used to generate Dataviews.

The entity allows for the creation of mobile app-usage reports for a defined time period and user list. A system setting allows for limiting the collected data to certain general items (App ID, Device type, and last login time) if you do not want to track more detailed information (such as access settings and specific device specifications).

Note: If, when viewing a Mobile Dataview, the logged-in user does not have symbolic timeframes defined (e.g., Current Pay Period), the user needs to select a timeframe date range.

Refer to the Dataviews & reports section of this help system for more information about generating and using Dataviews.

The following columns are available to include in a Mobile Dataview, within the MobileApp entity:

  • Application - How you accessed the system: Mobile App, Mobile Browser, or WebBrowser.
  • App ID - A unique identifier for the mobile device from which the system was accessed. The AppID is generated when you first install the Mobile App on a device. If you uninstall/reinstall the App, a new, unique AppID is generated.
Note: The AppID only contains data (in the Timecard Audit, the Audit Report for System Configuration, as well as Dataviews) when the login/punch occurred from the Mobile App. If a login/punch occurred from a browser, the AppID field is blank.
  • Device - The device type (Android, iPad, iPhone)
  • Timestamp - Time on the server when the last login occurred by this user on this device

    Allow camera access - The state of the camera access setting for the app on the device

  • Allow location information - The state of the Location Information setting for the app on the device
  • Allow push notifications - The state of the Allow Notifications setting for the app on the device
  • App Ver. - The version of the mobile app that is currently installed on the device
  • App Type - Dimensions or UKG Pro app
  • Locale - The device's locale setting
  • OS Version - The operating system and specific version running the device.
  • Model - Device model
  • Manufacturer - Device Manufacturer

Limiting the captured data

There is a system setting that, when enabled (set to True), will restrict the data collected to only the following:

  • App ID
  • Device
  • Timestamp

The setting is accessible from the Mobile App tab in Administration > Application Setup > System Configuration > System Settings

The setting is site.mobileapp.limitDeviceDetailsRecorded

Set to True to limit the collected data to the three items above.