SurveyCTO Collect for Android release notes

Bug fixes

• Fixed a bug that was causing the demo settings to not be properly imported when users choose to use them at the first use of the app.
• Fixed a regression from 2.81 that was causing the app to crash when selecting the current enumerator for Android 6 and older devices.
• Fixed a bug where the "Add" publishing action was sometimes not working as expected for offline publishing for devices on Android 6 and earlier versions.

Improvements

• Updated SurveyCTO Collect to use the most recent version of Google's Maps SDK. (should be invisible).

Bug fixes

• Fixed a bug that was causing the app to crash when filling out forms with non-english languages and when the device language is set to a language other than English.
• Fixed a bug that was causing the app to crash at startup when the device contains files with invalid UTF-8 characters.

Improvements

• Added support for repeated fields as parameters in the plug-in-metadata() function.

Bug fixes

• Fixed a bug that was causing the app to crash at startup due to a missing permission.
• Fixed a bug where syncing a dataset doesn't delete the locally published submissions that have been deleted by the user.
• Fixed a bug that was sometimes preventing enumerators to see the designated cases when switching users in the General Settings.

Bug fixes

• Fixed a bug that prevented the app from publishing datasets offline when changes involved more than 1,000 fields at once.

Bug fixes

• Fixed the support for offline case transfers for Android 13 users.
• Fixed a bug that was preventing the app from processing server datasets when the name of the unique ID field included a dash.
• Improved the way pre-loaded choices with blank values are handled, so that the valid ones will be rendered and a more helpful error message will be displayed for the others.
• Fixed a bug that didn't allow case lists to update in some scenarios.

New features

• Added support for offline dataset publishing so that data finalized in one form can be immediately pre-loaded into forms without an Internet connection.
• Added the ability for users to transfer cases from one device to another using Android’s Nearby Share feature while offline.
• Added the ability to publish form data into local datasets in long format (in addition to the pre-existing wide format publishing option). Requires offline dataset publishing to work on Collect.
• Added new local dataset publishing options for updating values in datasets by using addition (for numeric values) and concatenation (for string values) as alternatives to the pre-existing value replacement behavior. Requires offline dataset publishing to work on Collect.

Improvements

• Start targeting Android 13 which requires users to grant an extra permission for app notifications.
• Replaced some code libraries that were using non-SDK interfaces.
• Updated third-party libraries to address the latest security vulnerabilities.

Bug fixes

• Fixed a bug with Google’s Fused location provider that was sometimes providing the same location for subsequent submissions.
• Fixed a bug that was causing server datasets that were synced over Desktop’s local wi-fi sync to not be stored in the right folder in Collect’s internal storage.
• Fixed a bug that was causing the app to crash on geopoint fields when the "Location" permission had been revoked in the background.
• Fixed a UI-only bug that was causing some server datasets to continue to look like they are attached to forms even if they were not.
• Fixed a bug that was causing the app to crash when the Save and Finalize button was clicked multiple times at the end of the form.
• Fixed an issue where Android Collect crashes when a user clicks on the deleted image area.

New features

• Added support for enumerators, including the new enumerator field type, the enumerator-id() and enumerator-name() functions, and the ability to link cases to enumerators in the Manage Cases interface.

Improvements

• Improved performance for users who attach the same dataset to multiple forms, by ensuring that all forms share a single copy of the dataset.
• Started automatically installing downloaded dataset updates regardless of the Auto install downloaded updates setting. (The auto-install setting now applies more clearly to form updates specifically.)
• Modernized the app to target Android 11, as per Google's requirement. (Important note: Due to changes Google made in Android 11, Android 11 users who upgrade from version 2.70.1 or earlier will not be able to migrate their data to app-specific storage.)
• Improved the reporting of errors when downloading blank forms.
• Improved the setAnswer() function for field plug-ins, to accept empty strings as parameters to clear the field's value.
• Changed in-app "toast" notifications to "snackbar" notifications for Android 11 and above.
• Strengthened security for the intent API available to other apps, to close a potential vulnerability.
• Updated third-party libraries to resolve potential security vulnerabilities from outdated libraries.

Bug fixes

• Fixed a bug that was preventing field plug-ins from loading externalJs and externalCss properties when running on Android 11+ devices.
• Fixed a bug that was causing video recordings to fail on some devices (like the Samsung Galaxy Tab A7).
• Fixed a bug that affected devices running Android 7.x in which Collect would crash if a "toast" notification was triggered while the app was in the background.
• Fixed a bug that was causing the app to crash in the background if the app was deactivated while the quick-setup process was still in-progress.

• Fixed a bug that would prevent the case ID from being loaded properly immediately after a form was automatically updated.
• Fixed a bug that could cause the wrong case list to be shown when two users from the same server were signed in to different workspaces.
• Fixed a bug to ensure that, when accessing the same server from different workspaces using different login credentials, only the credentials from the current workspace are used.
• Fixed a bug that would leave the old workspace selected after creating a new workspace via attempting to change the server name in General Settings.
• Improved the popup message that appears when Collect needs to be updated in order to interact with a server.
• Removed the About Collect option from the global three-dot menu.

• Fixed a bug that was preventing some encrypted devices from connecting to servers that required device encryption.

• Fixed a bug in the migration process when updating directly from v2.70.1 or earlier to 2.71.

• Added support for workspaces.
• Added support for new server options to enforce mobile device security.
• Added support for the new server option to restrict API access.
• Fixed a bug with how speed violations count and speed violations audit fields function within repeat groups.
• Fixed a bug that would not allow images downloaded from the Internet to be selected in image fields.
• Fixed some error messages that still referred to the old "SurveyCTO Sync" app.

• Added support for the new eventlog appearance for text audit fields.
• Allow field plug-ins to use placeholder text from the interface translation tables for supported field types. See QUESTION_PLACEHOLDER_LABEL in the field plug-in API doc for more details.
• Added better support for identifying and reporting on field plug-in errors.
• Fixed a bug with the phone-call-duration() function that caused it to incorrectly return 0 when used in encrypted forms.
• Fixed a bug that was preventing form updates from being downloaded via the SEND/RECEIVE NOW feature if the auto download setting was turned off.
• Fixed a bug that would cause a crash when attempting to open the Manage Cases screen if the table contained only an ID column.
• Fixed a bug with the index() function that was preventing some forms to load fast.
• Fixed a bug that could make the app crash if the quick setup process was deactivated while running.

• Fixed a bug that could cause the Manage Cases screen to be blank even when there were cases to show.
• Fixed a bug with the Manage Cases screen that could cause an error message (“Can’t load installed cases”) when the “Auto-download on demand” setting was enabled.

• Fixed it so that references to form attachments are no longer case-sensitive.
• Made some improvements to the way Collect handles server authentication when invalid credentials are stored in General Settings to help prevent users from being temporarily locked out due to too many failed login attempts.
• Switched to using the Android App Bundle to automatically optimize updates to SurveyCTO Collect from the Google Play Store.
• Improved the new auto-download schedule for form and dataset updates (introduced in 2.70.1) to cover more use cases.
• Fixed a bug with the makePhoneCall() field plug-in API so that Collect will now accurately report to the plug-in when a call could not be made due to the Set as default phone app setting.
• Fixed a bug that could cause Collect to crash if "submission_url" in the form definition was not a valid URL.
• Fixed a bug that could cause Collect to crash if a task completed while the app was in the background.
• Fixed a bug that could cause Collect to crash while in the background if there was an error recording with the mic.
• Fixed a bug that could prevent the "Form updates check completed with errors" toast notification from being shown under certain conditions.
• Improved the warning message for the username field when the current username stored in General Settings hasn't yet been authenticated.
• Added Hindi, French, and Spanish translations for the error message that appears when you try to launch a masked phone call on Android 4 or 5.
• Updated the target API to 29 to comply with Google's target API level requirement.

• Fixed a bug that was preventing older versions of Android from being able to launch a phone call using an intent. This bug affected Android versions below 6.0.

• Added support for field plug-ins to allow form designers more flexibility to extend and customize the appearance and functionality of their forms.
• Adjusted the vertical spacing between select_one and select_multiple options to make it more comfortable on higher-resolution devices, and added a new Display density setting to allow user control over the spacing.
• Added support for a variety of new functions for form designers, like empty(), sum-if(), and count-items().
• Re-engineered the "Go To Prompt" interface, in order to render much faster when HTML mode is enabled for question labels.
• Improved the robustness of the finalization process for encrypted forms, to better handle cases where attachments are missing.
• Fixed the jr:choice-name() function (and the newer choice-label() function) to be able to retrieve choice labels even when they are dynamically filtered and have not yet been shown to the user.
• Fixed geopoint fields with the "background" appearance to preserve their original values when the form is saved and re-opened later.
• Removed the Form processing logic setting (since it was no longer necessary or useful).

• Fixed a bug that prevented image files from being displayed in pre-loaded choice lists using the search() function.
• The GPS pre-warming feature now works for geotrace and geoshape fields (instead of just geopoint fields).
• The caseid field is now updated and verified when you finalize a form, to prevent issues after restoring crashed forms using a different caseid.
• Improved Collect so that it will no longer offer to resume from a saved position in the form when there is no available resume point (usually after a crash).
• Fixed a bug that could display errors if a geopoint field with the background appearance was removed from the form (for example, by removing a repeat group instance).
• Fixed a bug that could allow problems with a form definition to cause the welcome screen to be blank.
• Fixed a bug that could allow problems with a form definition to cause the app to crash.
• Added protections against dangerous regular expressions that could cause the app/device to freeze.

• Fixed a bug that affects forms where the index() function is used on a field or a group that has no repeated parent.

• Gave SurveyCTO Collect a new look and feel, including a new icon, title bar, color scheme, and more.
• Added support for transparent backgrounds in .png images.
• Fixed the OSM map engine to start downloading maps again (they had stopped downloading when OSM’s map server stopped serving them to unverified clients), and also fixed selection of the default map style when selecting OSM as the map engine.
• Added a warning in the main menu when notifications are disabled via the Android settings, in order to let people know that constraint and other messages will also be suppressed.
• When automatically recovering from a save-point, improved SurveyCTO Collect to recover any audio audits that had been completed, even if the app or device had crashed before the user had explicitly saved progress.
• Removed some unnecessary resources in order to slim the download size.
• Improved SurveyCTO Collect to no longer crash in the background when long lists of forms have been previously loaded in the Get Blank Form screen.
• Fixed SurveyCTO Collect to no longer crash when trying to attach, to a submission, an item from the device’s Downloads folder.
• Fixed SurveyCTO Collect to give a sensible error message (rather than crashing) when somebody tries to attach, to a submission, an item located in an unsupported location (like Dropbox, OneDrive, or Box).
• Fixed SurveyCTO Collect to no longer shift time and date fields by 30 minutes after having changed the device’s time zone to certain time zones in East Asia.
• Improved the filter box in the case management interface of SurveyCTO Collect to better handle changes in device orientation.
• Updated SurveyCTO Collect to meet Google’s evolving requirements for Android apps (should be invisible).