Releases: dhis2/dhis2-android-capture-app
Android Capture App for DHIS 2 (v3.1.0)
The new DHIS2 Android App allows offline data capture across all DHIS2 data models. Data and metadata are automatically synchronized whenever there is internet access, always keeping the most relevant data for the logged user in the device.
The app is compatible and we support 41, 40, 2.39.
NEW FUNCTIONALITY AND WEB PARITY
New Capture Coordinates process: The 3.1 version introduces a list of new features designed to enhance the capture coordinates process. These improvements aim to provide greater accuracy, flexibility, and control over location data capture.
- Accuracy: The capture coordinates process now includes a feature that displays the precision of the captured location. This allows users to see how accurate their location data is in real-time. This parameter can also be restricted using the Android Settings WebApp.
- Search Functionality: A new search functionality has been added, allowing users to look up specific locations by name or address. Users are also able to navigate through the map and perform area searches to discover other locations within a specified region.
- Block Manual Capture: Using the Android Settings Web App, administrators now have the option to block manual location capture. When this setting is enabled, users can only capture the current location and cannot manually select or search a different one. This ensures that location data remains consistent and accurate.
Jira | Card1 | Card2 | Card3 | Documentation
Improve transfers flow: Significant enhancements to the transfer flow, aimed at making the process more user-friendly and transparent. The transfer button has been moved to a more accessible location within the three dot menu in the TEI Dashboard, ensuring that users can easily find and initiate transfers without unnecessary navigation. It also has introduced new dialogs throughout the transfer process. These dialogs provide clear, step-by-step guidance, ensuring that users understand each part of the process.
New relationship section: Major updates have been made in the relationship tabs, enhancing both functionality and user experience. Relationship cards have been updated with the new design to offer a more intuitive and visually appealing experience. The new design emphasizes clarity and usability, making it easier to view and manage relationships at a glance.
To prevent accidental deletions and enhance user control, a new confirmation dialog also has been added when deleting a relationship. This dialog will prompt users to confirm their action, ensuring that relationships are only deleted intentionally.
Jira | Card1 | Card2 | Card3 | Documentation
Sort of unique attributes in the search screen: Aimed at aligning it with the web instance for a more consistent user experience, this version of the Android app, by default, sorts the unique attributes (QR, barcode) at the top of the list of searchable attributes. Users can quickly and easily find the attributes for a more exact search.
Support of biometric dialog: An enhancement to the biometric authentication feature has been made in 3.1.0. When there is only one account configured, the user can configure biometric authentication (fingerprint or face ID).
Line Listing improvements: This version of the Android App introduces support for the Category Option Dimension in line listings. This enhancement enables users to apply category options directly within line listings to filter data according to precise criteria, improving data exploration and decision-making processes. This feature greatly enhances the versatility and utility of line listings, empowering users to perform more sophisticated reporting.
Additionally, it has been improved the text alignment within the Line Listing tables to support left alignment. This enhancement ensures better readability and a cleaner presentation of data, making it easier for users to review and analyze their information quickly.
Jira1 | Jira2 | Documentation
USER EXPERIENCE
Responsive Home Screen: In this Android App version a new dynamic home screen that adapts to the number of programs available has been implemented. This update replaces the old static list that didn’t adjust to the screen, providing a more responsive and user-friendly interface.The responsive design makes better use of screen real estate, providing a more engaging and functional home screen layout.
Jira | Card | Documentation
Scheduled events dialog: As a continuation of the new schedule dialog introduced in the version 3.0, a new intuitive and user-friendly schedule dialog has been implemented to enhance the overall user experience, making it easier to book, reschedule, or cancel events.
Jira | Card1 | Card2 | Documentation
Improve menus and navigation bar: A revamped of the menus and navigation bar has been made to be more user-friendly and accessible. It includes a cleaner, more modern look that improves readability and usability. These updates are designed to provide a more efficient and enjoyable user experience.
Jira1 | Jira2 | Card1 | Card2 | Documentation
CROSS PRODUCT
Support for customized Tracker terminology: Some DHIS2 terminology is not familiar for the end users. For this reason, we are gradually enabling the possibility to customize it to each particular use case. In this version, the term "event" (program label context) is customizable. The admin user will be able to configure it for each program using the Maintenance App, and the Android Capture App will display the customized term instead of the generic one.
DETAILS
You can find the list of all new features and all bugs fixed in 3.1.0 here.
Remember to check the documentation for detailed information of the features included in the App and how to configure DHIS2 to use it.
Please create a Jira Issue if you find a bug. [Project: Android App for DHIS2 | Component: AndroidApp].
Android Capture App for DHIS 2 (v3.0.1)
Release notes - Android App for DHIS2 - 3.0.1
Bug
ANDROAPP-5753 Formatting Issues with Attribute Values on TEI Card Dashboard
ANDROAPP-5808 GS1 QR code input does not display popup if Scanned QR code is not GS1 type
ANDROAPP-5873 Thread lock when app is unable to download reserved values
ANDROAPP-5953 Option set not working well in data set if the code of option constains character "_"
ANDROAPP-6051 No feedback is received after the database import is complete
ANDROAPP-6057 Form scrolling improvement to prevent overlap with save button
ANDROAPP-6088 Turning off a working list does not scroll user back to top of screen
ANDROAPP-6094 Data set duplicates records in unavailable capture OUs
ANDROAPP-6101 User is allowed to save errors when the event is with status "complete"
ANDROAPP-6116 App doesn't respect program specification constraints when displaying the list of available relationship types
ANDROAPP-6131 Event program displays no events created message on intial load
ANDROAPP-6132 Double tap on event/enrollment creation could generate duplicates
ANDROAPP-6137 Category Combo section shows incorrect number of fields
ANDROAPP-6146 Incomplete "Download" label when exporting a DB
ANDROAPP-6158 Data set - Sections without DE's never stops displaying the loading icon
ANDROAPP-6174 When same day (eg. 20 June) is chosen for a future month, the scheduled date always shows "Today"
ANDROAPP-6181 ConcurrentModificationException
ANDROAPP-6182 (RuntimeException) Crash when rotating device in schedule screen
ANDROAPP-6183 (UnsupportedOperationException) crash when opening a map
ANDROAPP-6184 (RuntimeException) crash when rotating device in settings activity
ANDROAPP-6185 Event report date is not updated when changing the due date (keeping the overdue status)
ANDROAPP-6187 Form is not refreshed when changing from closed org unit to open one
ANDROAPP-6193 App asks device location permission after granting location permission
ANDROAPP-6197 Incorrect header in TEI Dashboard card
ANDROAPP-6198 Android adding '.0' to Data Element causing sync error
ANDROAPP-6209 NaN displayed in program indicators
ANDROAPP-6212 Cannot share database due to device permissions
ANDROAPP-6225 RuntimeException: Unable to start activity ComponentInfo{com.dhis2/org.dhis2.usescases.searchTrackEntity.SearchTEAc...
ANDROAPP-6272 ApplicationNotResponding: ANR for at least 5000 ms.
ANDROAPP-6273 ApplicationNotResponding: ANR for at least 5000 ms.
ANDROAPP-6277 Working lists aren't applied even when active
ANDROAPP-6315 Fix Mobile ui breaking changes in capture app
ANDROAPP-6318 Order of TEIs change when moving between landscape and portrait
ANDROAPP-6332 [DEFECT] Incorrect workflow of Org unit when creating event
ANDROAPP-6345 Keyboard malfunction after stock distribution
ANDROAPP-6346 [ANR] jdk.internal.misc.Unsafe in park
ANDROAPP-6379 Time recorded when creating notes
ANDROAPP-6380 Keyboard navigation
ANDROAPP-6407 [Defect] Data entry not saving more than one value
ANDROAPP-6414 Clicking save, not now or sync several times
ANDROAPP-6415 Login error in landscape
ANDROAPP-6416 Percentage input is showing % twice
ANDROAPP-6417 Cannot navigate to event details or sync event after navigating back from details
Android Capture App for DHIS 2 (v3.0.0.2) - Patch version
What's Changed
- fix: [ANDROAPP-6277] Working lists not filtering search results in #3708
- fix: [ANDROAPP-6104] do not allow future dates in date fields in #3710
- fix: [ANDROAPP-5869] duplicated indicators table in #3713
- fix: [ANDROAPP-6093] crash when overriding cat combo in data sets in #3712
- fix: [ANDROAPP-6225] Org. Unit dialog crashes on device rotation in #3715
- fix: [ANDROAPP-6285] Crash when selecting map in landscape search screen in #3714
- fix: [ANDROAPP-6305] show error if date has incorrect date Format in #3717
Full Changelog: 3.0.0.1...3.0.0.2
Android Capture App for DHIS 2 (v3.0.0.1) - Patch version
What's Changed
- fix: ANDROAPP-6195 Add missing text resource keys in #3667
- fix: ANDROAPP-6194 Search outside the program in #3664
- fix: ANDROAPP-6210 UninitializedPropertyAccessException on BreakingTheGlassDialog in #3671
Release notes: 3.0.0.1
Full Changelog: 3.0...3.0.0.1
Android Capture App for DHIS 2 (v3.0)
The new DHIS2 Android App allows offline data capture across all DHIS2 data models. Data and metadata are automatically synchronized whenever there is internet access, always keeping the most relevant data for the logged user in the device. The app is compatible and we support 41, 40, 2.39. | |
Cross product Support for customized Tracker terminology: Some DHIS2 terminology is not familiar for the end users. For this reason, we are gradually enabling the possibility to customize it to each particular use case. In this version, the term "event" and "enrollment" are customizable. The admin user will be able to configure it for each program using the Maintenance App, and the Android Capture App will display the customized term instead of the generic one. Documentation link: https://docs.dhis2.org/en/use/android-app/program-features.html#capture_app_programs_common_features_customized_terminology Multiselect value type: DHIS2 already supports the introduction of multiple options for data elements for data aggregation. In this version it will also support it for individual data. The Android App will support both aggregated and individual multi select data elements from this version. Documentation link: https://docs.dhis2.org/en/use/android-app/value-types-supported.html#capture_app_value_types Custom Icons: DHIS2 now supports uploading custom Icons to be used in addition to the built in Icon library. This is useful for use cases not related to health or that require very specific iconography. The Android App will render the custom icons that need to be uploaded and configured using the Maintenance DHIS2 Web App. Documentation link: https://docs.dhis2.org/en/use/android-app/visual-configurations.html#capture_app_visual_icon_lib User Experience Improvements in forms layout: When creating an event or an enrollment, there are a number of fields that are not data elements or attributes, for example, event date, org unit, coordinates, enrollment date, category combinations. Those elements are referred to as event/enrollment details and in previous versions they were displayed in different screens separated from the data elements or attributes. They were difficult to find when users wanted to edit or consult them. In this version the details are displayed inside the form, as the first opened section for completion. Once they are filled in, for example when the user reopens the event or enrollment form, the details section will be visible and easily available, but collapsed to leave more space for the data collection. Documentation link: https://docs.dhis2.org/en/use/android-app/program-features.html#capture_app_common_features_newEdit_event Improve TEI search user experience: The search form has been improved to provide a cleaner look and a more intuitive user experience. The buttons have been made more explicit for differencing search from creation. In addition the flow for searching TEIs using attributes rendered as bar / QR codes has been made more agile. If there is only one result and the attribute is unique, the app will open the TEI Dashboard directly. If there are multiple results, the app will display all the cards on the TEI list (this is equal to the current workflow), and if there are no results, the app will display the create button and allow the user to “search outside the program” if the configuration allows it. Documentation link: Improve TEI dashboard user experience: In the previous version of the application, the TEI header part of the dashboard was improved. In continuation to that effort, the bottom part, where all program stages are displayed, has been redesigned in this version. The changes include a fresh and more clean look of the list of events, with more space and less -not critical- information displayed. In addition, the button for creating new events has been moved to the top (in timeline view). Documentation link: https://docs.dhis2.org/en/use/android-app/program-features.htm#capture_app_programs_TEI_Dashboard_program_stages New inputs for value types: ****The inputs for all value types have been gradually redesigned from the 2.9 version of the app. The signature input field as well as the complete legend description are included now to improve user experience at data entry. The new input fields are now displayed by default and admin users are able to opt-out to use the old forms through the Android Settings web app. Documentation link: https://docs.dhis2.org/en/use/android-app/visual-configurations.html#capture_app_visual_signature https://docs.dhis2.org/en/use/android-app/visual-configurations.html#capture_app_visual_input_fields Improvements in tracker programs data entry flow: ****Several improvements have been made in the tracker programs user flow. An informative dialog has been added for confirmation when the user deletes a TEIs. The dialog for scheduling events after compilation has also been redesigned and improved. The selection of org. Units when the user only has access to one org. Unit for data collection has been removed and pre-filled, and lastly, the program rule “Hide program stage” behavior has been aligned with Capture web. Documentation link: https://docs.dhis2.org/en/use/android-app/program-features.html#capture_app_programs_common_features_schedule_after_completion https://docs.dhis2.org/en/use/android-app/program-features.html#capture_app_programs_delete_tei Improve App behavior when working in offline mode: ****Some parts of the Android App are not responsive when there is no connection available (i.e. sync buttons…). The behavior is now improved and the App will inform the user that actions are not started because there is no internet connection available when buttons that require connection are tapped. Documentation link: NA New functionality and Web Parity Line listing analytics: This version of the Android App includes the possibility to render and display line listing as part of the offline analytics functionalities. The line list has to be created using the Line Listing DHIS2 web App, and then configured to be displayed in Android using the Android Settings Web App (ASWA), as any other offline analytics in Android. In this case Line lists can be displayed in the home screen, and event or tracker programs (as they do not really apply to aggregated data, they are not displayed in Datasets). Users will be able to search by period, Org. unit, or any of the columns added in the Line List. There are some limitations to the line lists to be displayed in the Android App. The Org. units and Periods must be relative, not fixed. And there is a maximum number of columns of 15. Android Local Analytics are built using local data, and wil, update instantly as more data gets collected (or downloaded) in the device. The App will display a maximum of 500 rows and will inform the user when the limit is reached. Documentation link: https://docs.dhis2.org/en/use/android-app/visual-configurations.html#capture_app_visual_event_visualizations \ Configurable basemap layer: DHIS2 supports the configuration of custom map layers for the Maps Web App. From this version of the DHIS2 Android App, those custom layers will be downloaded and rendered in the Maps. The custom layers will be presented as additional layers to the default ones. Documentation link: https://docs.dhis2.org/en/use/android-app/program-features.html#map-layers Implementation Support Import/Export App database: ****As part of troubleshooting, some errors can be hard to replicate and can lead to data loss because of being unable to sync. With this functionality the end user will be able to export the local database and share it with an admin who will be able to import it for troubleshooting, being able to replicate the exact environment (database, device, configuration). The exported database is encrypted and the administrator will require the user credentials to be able to access the database. Documentation link: https://docs.dhis2.org/en/use/android-app/settings.html [**Improve end-user config erro... |
Android Capture App for DHIS 2 (v2.9.1.1) - Patch version
This is a patch version of the DHIS2 Android App It builds upon the last version including bug fixes that couldn't wait to the next version. It includes no functional improvements neither changes in the User Interface. It means that yours users can update without experiencing any change in the UI. | |
Bugs fixed
You can find in Jira details on the bugs fixed in this version. Remember to check the documentation for detailed Please create a Jira Issue if you find a bug or |
Android Capture App for DHIS 2 (v2.9.1) - Patch version
This is a patch version of the DHIS2 Android App It builds upon the last version including bug fixes that couldn't wait for the next version. It includes no functional improvements or changes in the User Interface. It means that users can update it without experiencing any changes in the UI. | |
Bugs fixed
You can find in Jira details on the bugs fixed in this version. Remember to check the documentation for detailed Please create a Jira Issue if you find a bug or |
DHIS2 Android App version (2.9)
The new DHIS2 Android App allows offline data capture across all DHIS2 data models. Data and metadata are automatically synchronized whenever there is internet access, always keeping the most relevant data for the logged user in the device. The app is compatible and we support 2.38, 2.39, 40. And has no breaking changes with 2.37, 2.36, 2.35 and 2.34. | |
USER EXPERIENCEDisable referral in tracker programs: When users add events in a tracker program, the DHIS2 Android Capture app offers three options: Add (for new events), Schedule (for planning future evetns) and Refer (for referrals or transfers). As this third option is not used in many implementations, this new feature enables the admin user to remove that option from the menu to simplify the user experience. The referral option can be hidden using the Android Settings Web App for all programs or for each specific program. Jira | Documentation App | Documentation Webapp | Screenshot Skip home screen if users only have access to one program: The home screen of the DHIS2 Android App shows the list of programs and datasets available for the user. The first thing a user must do when using the app is to select the program or dataset to work with. In some implementations, users have access to only one program or dataset. To reduce the number of clicks and streamline the process of data entry, the App will now skip the home screen in the cases where the user has access to only one program or dataset, and will instead open directly to the program or dataset screen with the event, TEI or dataset list. Jira | Documentation | Screenshot Display program stage description: The description for program stage sections was not available to the end user in previous versions of the App. To provide more context and information at the moment of data collection, the description has now been brought to the user interface and will be displayed below the section name. Jira | Documentation | Screenshot Disable collapsible sections in forms: Stage sections in the Android App are displayed with collapsible menus that enable the user to open one section at a time. The purpose of this accordion-like implementation is to help the user navigate very long forms. However, some implementations would prefer to list the sections one after the other. This new version of the application enables the admin user to decide if the sections should appear in extended mode. This configuration is made through the Android Settings Web App and will display the sections one after the other with the section name acting as a separator. Jira | Documentation App | Documentation Webapp | Screenshot Move working lists under the search bar: The working lists have been moved from the filters section to the main program screen. In earlier versions, the user had to open the filters to be able to see and select a working list. From this version, the working lists are always visible under the search bar, facilitating their use for filtering out Tracked Entity Instances. Jira | Documentation | Screenshot New design for Dataset, Event and TEI cards: Cards are used for listing datasets, events and TEIs. The new design offers a cleaner and more intuitive layout, replacing the use of colored icons by descriptive text when relevant. Jira | Documentation datasets | Documentation events | Documentation TEI | Screenshot Implement changes in TEI Dashboard details: The TEI Dashboard has been redesigned for both portrait and landscape view. The new design offers a cleaner and more intuitive layout, replacing the use of colored icons by text when relevant and moving some secondary actions to the hidden menus. Jira | Screenshot | Documentation Data entry forms - New inputs per value type: The inputs for all value types have been redesigned. Tappable areas and texts have been increased and selection modes are improved to offer a cleaner and more intuitive user experience. By default, the Android App will display the previous forms. Admin users are able to opt-in to use the new forms through the Android Settings Web App. Jira | Documentation App | Documentation Webapp | Screenshot [EXPERIMENTAL] TEI Header: The TEI Header is a title that can be added to the TEI cards and dashboards in the app. The title helps identify a TEI by displaying a summary of key information. It is formed by a concatenation of Tracked Entity Attributes and fixed text. The title is configured through a Program Indicator in the Maintenance app and is assigned to the tracker program in the Android Settings web app. This feature is experimental, and depending on feedback and adoption it will be refined and incorporated in the web Capture app. Jira | Documentation App | Documentation Webapp | Screenshot Other improvements for User Experience
MAINTENANCEBug fixing: You can find the list of bugs fixed here. You can find in Jira details on the new features in this version. Remember to check the documentation for detailed Please create a Jira Issue if you find a bug or |
Android Capture App for DHIS 2 (v2.8.2) - Patch version
This is a patch version of the DHIS2 Android App It builds upon the last version including bug fixes that couldn't wait to the next version. It includes no functional improvements neither changes in the User Interface. It means that yours users can update without experiencing any change in the UI. | |
Bugs fixed
You can find in Jira details on the bugs fixed in this version. Remember to check the documentation for detailed Please create a Jira Issue if you find a bug or |
Android Capture App for DHIS 2 (v2.8.1.1) - Hotfix
This is a patch version of the DHIS2 Android App It builds upon the last version including bug fixes that couldn't wait to the next version. It includes no functional improvements neither changes in the User Interface. It means that yours users can update without experiencing any change in the UI. | |
Bugs fixed
Bug fixing: You can find the list of bugs fixed here. |