Android Settings Web App

This guide is designed to be a catch-all about the Android Settings Web App. Since the documentation is a bit scattered around this often overlooked app, I’m posting what I find on a rolling basis.

  • The Android Settings Web App overwrites ALL settings that are the android app for any device connected to the instance.
    • If you have multiple projects using the android app to report to your instance, then this is a dangerous option to enable if they have different settings, for example, synchronization periods, sync parameters, reserved values for different projects.

If you plan to use this web app, the following considerations should be taken:

  • Only users with ‘ALL’ authority are able to use this app to configure the parameters for synchronization, encryption, etc. Other users having access to this app will be able to see the configuration but will not be able to edit any values.
  • If you select the encryption checkbox, it will affect the local database of all Android devices synchronizing with the server for a given DHIS2 instance.
  • This version is compatible with the previous version (2.0.0), which means that the settings stored using 2.0.0 will apply.

Overview

  • The web app features are intended to support admins in various functions of a DHIS2 Android Capture app implementation.
    • Synchronization parameters for the DHIS2 Android Capture app
    • Encrypting the local database of the Android devices
    • Customizing the appearance of programs data sets, and home screen,
    • Adding TEI, program, and dataset analytics items
    • Choose analytic objects to be calculated offline on local devices
    • Allow screenshots to be taken

Highlights From CoP release of 2.1.0 app

Offline Calculated Analytics on Android Device

This version of the Settings App contains new features for configuring offline analytics (calculated locally with the data available in the device) in the Android Capture App.

In the latest version of the DHIS2 Android Capture App (v 2.5), users can render DHIS2 visualizations configured in the web-based Data Visualizer App based on the data stored locally in their mobile device. The new Android Settings Web app allows admins to select visualizations that should be rendered for Android Capture App users, define groups of data visualizations, and test if an Android user has proper access to the visualization in their device. A DHIS2 visualization created in the Data Visualizer Web App and saved as a ‘Favorite’ can be selected to render in any of the following sections of the Android App:

  • Home: DHIS2 visualizations are displayed in the home screen (analytics tab) of the Android App.
  • Program: DHIS2 visualizations are displayed in the search screen (analytics tab) in tracker programs, or in the list screen (analytics tab) in event programs of the Android App.
  • DataSet: DHIS2 visualizations are displayed in the list screen (analytics tab) in a DataSet of the Android App.

However, since the aggregations and calculations displayed are calculated in the device (using data stored locally in the device), not all DHIS2 visualizations are eligible to be selected in the Android Settings webapp. Some of the limitations are:

  • Visualization type: Column, Line, Pie, Pivot Table, Single Value, Radar
  • Periods: Only relative periods → today, yesterday, this week, this month, this year, last 3, 7, 14, 30 days, last 4, 12 weeks, last 3, 6, 12 months
  • Max row dimensions (only for pivot tables): 1
  • Max column dimensions (only for pivot tables): 2
  • Organization units: Only user relative org. units → userOrgUnitChildren, userOrgUnitGrandChildren, userOrgUnit

There are more restrictions which apply to Android analytics regarding the many configuration options available in the Web Visualizer as well as the supported functions and calculations related to indicators and program indicators. This table summarises all supported features.

Screenshot Support Config Option

This functionality is configurable (by using a checkbox) in the Android Settings web app. Please note that the default behavior is deactivated screenshots.