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: https://docs.dhis2.org/en/use/android-app/program-features.html#capture_app_programs_unique_qrBar_search 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_legends_descri2ptions 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 ANDROAPP-6160 Attribute option combo is not saved in events This patch release updates the Android SDK to version 1.9.1. You can find in Jira details on the bugs fixed in this version. 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 or you want to propose a new functionality. [Project: Android App for DHIS2 | Component: AndroidApp].

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 ANDROAPP-5895 Correct misalignment when entering text for inputShell ANDROAPP-5885 [Data set] indicators don't update until the user moves to a different cell ANDROAPP-5881 Input with virtual keyboard not working correctly ANDROAPP-5872 Search in stock management is not updating the list ANDROAPP-5871 App Not Responding when local db is encrypted ANDROAPP-5856 ANR ReadableStoreImpl.addObjectsToCollection in DataSetDetailRepositoryImpl ANDROAPP-5825 Input date value changes on click in schedule new event screen ANDROAPP-5821 NoSuchElementException: List is empty. ANDROAPP-5807 Crash when parsing value to input in InputDateTime ANDROAPP-5804 Incorrect label on bar codes, QR codes and GS1 ANDROAPP-5803 On schedule event due date incorrect when last previous event does not have a report date ANDROAPP-5788 Keyboard hides helper text if the selected field is near the bottom of the screen ANDROAPP-5773 Analytics are not being displayed as tables. ANDROAPP-5770 IllegalStateException: Expected BringIntoViewRequester to not be used before parents are placed. ANDROAPP-5769 ApplicationNotResponding: ANR for at least 5000 ms. ANDROAPP-5767 RuntimeException in teidashboardActivity Sentry issue ANDROAPP-5764 BottomSheetDialog shows barcode expanded with old form ANDROAPP-5749 Incorrect behavior when tapping on Next on sections that are too long ANDROAPP-5746 Exception when trying to add a file from downloads directory ANDROAPP-5743 Calculated variables save integer values with ".0" ANDROAPP-5742 [Local Analytics] App isn't plotting all the points (per event), only the first one. ANDROAPP-5741 [Local Analytics] App crashes if charts are empty ANDROAPP-5740 Display error correctly when date or time is incomplete ANDROAPP-5726 RTS workflow needs to allow for translating the 3 transaction types ANDROAPP-5716 Filters not responsive to rapid changes when there are many programs ANDROAPP-5710 Keyboard not showing for certain fields ANDROAPP-5704 Overdue date in patient line list follows inconsistent format ANDROAPP-5700 User can select out-of-scope OUs on the enrollment form ANDROAPP-5698 Incorrect list of points in a polygon ANDROAPP-5663 Tei dashboard event list scrolling ANDROAPP-5662 Search button is behind the nav bar ANDROAPP-5630 Due date in Tracker program does not follow standard interval days ANDROAPP-5606 Active filter counter mismatched with workinglist's filters ANDROAPP-5604 App crashes when one attempts to synchronise TEI and events imported via QR code ANDROAPP-5570 Changes to enrollment date not respected by program rules ANDROAPP-5567 DHIS2-RTS Capture app limited to 60 TEIs ANDROAPP-5484 Images block creating relationships (Capture Android) ANDROAPP-5294 Filter by ACCESSIBLE org units ANDROAPP-5261 The animation of the input bottom bar is not smooth. ANDROAPP-5249 Resizing for all columns difficult use ANDROAPP-5130 Follow-up clicks can be skipped by the app when entering data into tables. This patch release updates the Android SDK to version 1.9.1. You can find in Jira details on the bugs fixed in this version. 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 or you want to propose a new functionality. [Project: Android App for DHIS2 | Component: AndroidApp].

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 EXPERIENCE Disable 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 Smaller improvements focussing on user experience like a new org unit selector Jira | | Screenshot, or adding a loading spinner during the deletion of big databases. Jira | Screenshot MAINTENANCE Bug 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 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 or you want to propose a new functionality. [Project: Android App for DHIS2 | Component: AndroidApp].

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 ANDROAPP-5463 Wrong password in already authenticated account throws invalid url ANDROAPP-5452 Notifications not displaying on devices with android 13 ANDROAPP-5426 DataSet tables not saving text values ANDROAPP-5425 App crashing when opening orgUnit field in event creation on android 5 and 6 devices ANDROAPP-5424 App not functional in Android 5.0 and 6.0 devices due to expression-parser library ANDROAPP-5403 The app displays the keyboard over the selecting menu when the user has multiple apps to use the email or phone number ANDROAPP-5401 Infinite loading when applying date filters in tracker program ANDROAPP-5399 Improve recomposition on input field in tables ANDROAPP-5396 SDK BC: handle d2ErrorCode SERVER_CONNECTION_ERROR ANDROAPP-5389 Validation Strategy - Errors ANDROAPP-5385 Program dashboard: filter by EventDate includes all EventStatus as side effect ANDROAPP-5384 Persist dataset column size when adjusted by the user and revert to default ANDROAPP-5380 Sync button crashes app after rotating device in search screen ANDROAPP-5377 A TEI enrolled in many programs display to many icons blocking the TEI info card ANDROAPP-5376 Login button doesn't work and doesn't present any error ANDROAPP-5375 App crashes with some icons ANDROAPP-5370 Navigation button does not open in some programs. ANDROAPP-5369 NullPointerException: Attempt to invoke virtual method 'java.lang.String java.lang.String.replaceAll(java.lang.String, ... ANDROAPP-5368 Org Unit value type opens the hierarchy incorrectly ANDROAPP-5363 Wrong label displayed while navigating an error or warning ANDROAPP-5348 Errors in program rules are not shown after they have been displayed once despite the program rule being reexecuted ANDROAPP-5343 Sync flow backwards ANDROAPP-5342 Form actionable icons launch action from stored value ANDROAPP-5340 Store image and files before value type validation ANDROAPP-5335 In TEI dashboard filters appears items related to TEI ANDROAPP-5334 "All enrollments" cards show incident date even when not configured ANDROAPP-5330 App crash when deleting quantities in "Review" stage ANDROAPP-5329 The selected cell is hidden in RTStock program (and datasets) table if the first cell is selected after scroll ANDROAPP-5328 Default language not respected (or inconsistent) when changing between servers. ANDROAPP-5323 IllegalStateException: Attempting to launch an unregistered ActivityResultLauncher with contract androidx.activity.resul... ANDROAPP-5255 [LANDSCAPE] Loading bar never hides in overview screen ANDROAPP-5253 Event status filter doesn't remove checkmarks after the reset ANDROAPP-4710 Validation Strategy - Mandatory Fields ANDROAPP-4322 Analytics legends don't show event's exact date ANDROAPP-3106 [Bug]Error when searching with comma char in the values This patch release updates the Android SDK to version 1.8.2. You can find in Jira details on the bugs fixed in this version. 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 or you want to propose a new functionality. [Project: Android App for DHIS2 | Component: AndroidApp].

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 ANDROAPP-5371 Update SDK to 1.8.1.1 This patch release updates the Android SDK to version 1.8.1.1 Bug fixing: You can find the list of bugs fixed here.

Android Capture App for DHIS 2 (v2.8.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 ANDROAPP-5367 Analytics: verify support for Calculations ANDROAPP-5365 Update rule engine to 2.1.8 ANDROAPP-5364 Handle map API calls when device doesn't have internet access but can access the dhis server ANDROAPP-5361 Tracker infinite loading for program stage ANDROAPP-5360 ForegroundServiceStartNotAllowedException ANDROAPP-5359 RuntimeException: Unable to resume activity ANDROAPP-5358 NumberFormatException: For input string: "No" ANDROAPP-5356 LMIS back miss behavior This patch release updates the Android SDK to version 1.8.1. Bug fixing: You can find the list of bugs fixed here.