When launching the eForms Mobile Client app for the first time or using certain functionality within a form, like capturing and accessing media, etc., on the device, the app will ask for permission to function properly.
If you allow it when initially prompted in-app, the permission will automatically be granted, allowing you to utilize that feature.
If the prompt is denied a few times and the app starts warning you “…please try again” after you attempt to use a particular feature, you’ll then need to manually allow permissions by navigating to the Device’s Settings > App > App Permissions. Please note that these steps might differ slightly depending on your device’s operating system and version.
This article covers the permissions the app might need and what it enables, depending on the features required for Android and iOS devices. Ensuring you’re fully aware of any permission issues that prevent the app from functioning as intended.
Android Permissions
Permission | Enables |
|---|---|
| Allow app to send notifications? | Notifications may include alerts, sounds and icon badges. These can be configured in settings. |
| Allow app to access this device’s location? | Enables you to add GPS co-ordinates during data entry in various screens and record locations of submitted form entries. |
| Allow app to take pictures and record video? | Enables you to capture photos/video during data entry in various screens. |
| Allow app to access photos and videos on this device? | Enables you to add photos/video during data entry in various screens. |
| Allow app to access music and audio on this device? | Enables you to add audio during data entry in Forms. |
iOS Permissions
Permission | Enables |
|---|---|
| “App” would like to send you notifications. | Notifications may include alerts, sounds and icon badges. These can be configured in settings. |
| “App” would like to access the camera. | Enables you to add photos/video during data entry in various screens. |
| “App” would like to access the microphone. | Enables you to add audio during data entry in Forms. |
| Allow “App” to use your location. | Enables you to add GPS co-ordinates during data entry in various screens and record locations of submitted form entries. |
Manual Permission Prompts
While our app initially prompts a user to allow permissions, after being denied a few times, it will stop asking and display an error message instead. When this happens, the permission will need to be manually added for the app to function properly.
Error messages that you could encounter requiring permission would look like the list below. Depending on the device’s operating system, please check the permissions tables above to identify the one needed to either access, capture, or use from the device.
- Could not capture video – please try again
- Could not capture image – please try again
- Could not capture audio – please try again
- File could not be retrieved – please try again
- An error occurred while capturing your location
- An error occurred scanning the barcode – please try again
On most devices, you can allow app permissions by navigating to the device’s Settings > Apps > App Permissions.
For example, the UI steps on devices running Android 13: