DHIS2 Android Capture App version 2.5 is released

Announcements - Annonces
,
1

Dear all,

DHIS2 Android Capture App 2.5 is out with many improvements, bug fixes and offline analytics!

This release includes many improvements which provide a better user experience. However we have focussed mainly on adding Analytics to our App. We are very proud to announce that users will be able to see now tables and charts in the application while being offline.

This version is fully compatible with the DHIS2 version 2.37 and you can find the detailed new features and fixes below.

LOCAL ANALYTICS

Offline In-App Program/Dataset Analytics: The Android app can now render analytics that have been created in the Data Visualizer app in DHIS2. Analytics to be displayed require configuration using the Android Settings Web App, where administrators will be able to select the charts and tables to be displayed for end users.
These visualizations can be rendered on the home screen of the App, on the dataset screen and at the programs level. All analytics are aggregated in the device using local data. The Analyticis feature is 100% functional offline.

The analytics supported in the Android App are:

  • Pivot Tables
  • Column Chart
  • Line Chart
  • Pie Chart
  • Radar chart
  • Single Value

All these visualizations can be organized and displayed in groups. Groups are also configured using the Android Settings Web App. For each visualization object, the user will be able to filter in the app by:

  • Period: Daily, Weekly, Monthly, Yearly, This Quarter, Last Quarter, Last 4 Quarters and Quarter this year.
  • OrgUnit: Select “All” to display all the org units available to the user or “Selection” to specify one or multiple org units.

Jira | Screenshot | Screenshot 2 | Screenshot 3 | Screenshot 4 | Documentation

DATA ENTRY USER EXPERIENCE

Dataset redesign The layout for datasets data entry has been redesigned for a more integrated user experience and clean user interface. Jira | Screenshot

Export/Share QR and Bar codes: Data elements or attributes type text can be configured as QR or barcodes. With the new export/share option, users will be able to display a bar or QR code in an image so that it can be shared it for printing, take a screenshot or show it on the screen for scanning.
Jira | Screenshot | Documentation

Improved render for icon-based data entry: When program sections rendering type is used in combination with icons, a section with a single data element and associated Option Set renders the assigned icons next the options to simplify data entry. The layout and design of this screen has been redesigned and improved for a better user experience.
Jira | Screenshot | Documentation

Personalized Calendar View: In the DHIS2 Android Capture App users can switch date selection from spinner to calendar view. In this version, the app will remember the last visualization selected by the user and use it the next time the user needs to select a date.
Jira | Screenshot | Documentation

Display reason for data non-editable: Data can be blocked for many reasons in DHIS2, because of access restrictions or expiration among others. When an Event, TEI or Data Set are not editable the user will be able to find the reason in the “Details” section. The possible reasons are:

  • Event completion
  • Enrollment completion
  • Expired event
  • Closed organisation unit
  • Organisation unit out of capture scope
  • No access to capture data in the program or data set
  • No access to a category option in the program or data set
    Jira | Screenshot | Documentation

Adjust TEI Dashboard options to program configuration: The options offered at the TEI dashboard will be tailored to the specific configuration of the program.

  • Relationships tab will not be visible if the program relationships are not configured.
  • Create event button will be hidden when the user cannot create more events based on tracker configuration.
  • Indicators tab will be not be visible if the program has no program indicators configured.
  • Organisation Unit filter will not be visible if the user has only one Organisation Unit configured.
    Jira | Jira 2 | Jira 3 | Documentation

MAPS

General Maps User experience: After three versions since maps were included in the DHIS2 Android App, we have reviewed and improved the user experience based on community feedback.
Jira | Documentation

Center to user postion: If the user grants location permissions to the App, the map will show the current location represented as a blue color dot. The maps in the DHIS2 Android Capture App now include the possibility to center the map on the user location.
Jira | Screenshot

TRACKER FEATURES

Add support for Event - TEI relationships: The app now allows users to add relationships from single events (Event programs) to TEIs. There is a new tab in the event dashboard, named relationships, that is active when it is configured in the server. This version does not allow relationships from TEIs to events or using events that belong to an enrollment. Jira | Screenshot | Documentation

NEW filter for TEIs marked as follow-up: In Tracker pograms, the ‘Follow Up’ filter allows the user to filter out the TEIs that have been marked as ‘Follow-up’. TEIs can be marked to be followed up in the TEI Dashbaord.
Jira | Screenshot | Documentation

OTHER FEATURES

Interface language based on DHIS2 user language: The language of the interface will correspond to the language set in the DHIS2 user configuration. If the language is not available in the app, it will pick the language of the device. If none of the language configurations are available, the app will default to English.
Translations set up in DHIS2 for metadata will also be shown according to the language in the user configuration.
Jira | Documentation

MAINTENANCE

Quality / Security / Performance: You can find a list of issues related to quality, security and performance opening this jira filter.

Bug-fixing: You can find a list of of the bugs fixed in this version opening this jira filter.

RELEASE INFO

Release Information Link
Download app from Google Play or Github Google Play - Github
Documentation https://www.dhis2.org/android-documentation
Details about each feature on JIRA (requires login) 2.5 Features
Overview of bugs fixed on JIRA (requires login) 2.5 Bugs
Demo instance (user/password) https://play.dhis2.org/demo/ Credentials: android / Android123
DHIS 2 community https://community.dhis2.org Mobile Community
Source code on Github https://github.com/dhis2/dhis2-android-capture-app
Source code of SDK on Github https://github.com/dhis2/dhis2-android-sdk
8 Likes
2

Hi @marta , I am currently setting up a capture App for my instance but failing to understand why the App is not downloading a local database to enable offline search and capturing. The Data Sync and Configuration run successfully but yet I still have 0 person downloaded for each program. Any pointer? or is this a bug? my version is 2.5.1

Best regards,

3

Hi @Yashiindi .

We just released the version 2.5.2 and we always advice using the latest version as it fixes bugs that might be present in previous versions. Having said that the App should be downloading some TEIs according to the settings. You need to make sure that:

  1. The user in the App has the proper permissions in terms of OU in the capture and search. The capture ones will be downloaded
  2. The user has the proper permissions in terms of program (and all its metadata) I guess this is right as you can see it in the App but please recheck every metadata item

On top of this, the App will download a set of numbers by default (don’t know them by heart) however, you can tweak (to increase or decrease) by using the Android Settings Webapp.

Let us know if this helps. Cheers.

1 Like
4

Hi @jaime.bosque , Thanks a-lot for your prompt reply. I will upgrade to the latest version and confirm my permissions. However being a superuser in this instance I should definitely be having authority to see metadata and download TEIs.

5

Is version 2.5.2 available on Google store? I seems not to locate it.