DHIS2 Android Settings Web App version 2.1.0 is released

Dear DHIS2 community,

We are pleased to inform you that the version (2.1.0) of the Android Settings web application has been released.

The web app features are intended to support admins in various functions of a DHIS2 Android Capture app implementation. These include configuring 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, and adding TEI, program, and dataset analytics items, among other features.

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 visualtizations 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.

Apart from support for configuration of local analytics, this version also allows to configure the possibility to take screenshoots using the production APK of the Android Capture App (e.g. the one that is made available on GooglePlay). Screenshoots (or screen sharing) were previously deactivated for security reasons in the production APK. However, we have received many requests from the community to allow users to take sceenshoots for debugging reasons. Now this functionality is configurable (by using a checkbox) in the Android Settings web app. Please note that the default behavior is deactivated screenshots.

This web app is compatible with 2.37, 2.36, 2.35, and 2.34. We recommend to always use the latest patch versions.

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

  • The use of this app will overwrite the local settings of all Android devices using the DHIS2 Android Capture app for a given DHIS2 instance.
  • 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.

RELEASE INFO

Release Information Link
Download app from the App Hub https://apps.dhis2.org/
Documentation Android Settings Web App doc

Please report any issues you find in jira (Component: [App] Android Settings app)

8 Likes

Congratulations to the Team on this progress with the latest version of the Android Settings webapp. Is there a plan towards increasing the number of reserved values for Offline Data capture from the Current Limit of 500 on the android settings webapp ?. The current limit is giving us a challenge here in Ghana for offline data capture in mass vaccination campaign mode. Refill function doesn’t always work due to connectivity issues. The DHIS2 Team in Ghana will engage the android Team further on this, Ghana will soon Hit a major milestone in Tracker implementation for Maternal & Child Health Services and the functionality and robustness of the android capture up is key to implementation success.

2 Likes

Hi @dachagaoswald . I think this is a very interesting and valid request. Would you mind creating a JIRA issue?

2 Likes

Very excited to try this!

Is it possible that we can add the android settings application to the play versions? I am trying to troubleshoot something (we can’t seem to get any visualizations to appear in lists for program visualizations in the android settings app v. 2.1.x) but unable to replicate the issue on play because I don’t have admin access to configure such settings.

Update: Was able to change “SuperUser” User Role and added the “All Authority” box, and that allowed me to configure the Android Settings. This is now functional, will test out here!

3 Likes

You can install it via App Management > App Hub

1 Like

@chase.freeman I can install it but can’t access it; as noted above:

  • 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.