Finding and safeguarding local device data
Private app storage
By default, SurveyCTO Collect stores all of its data and settings in a private, hidden location within the app itself (in internal storage). This is the safest and most secure way to store data on your device. Data stored within SurveyCTO Collect remains inaccessible, even if someone gains access to your device and uses a file explorer app. If you want to purge all SurveyCTO data from your device, you can simply uninstall the app.
Public app storage
There are a few reasons why you might want to switch to using public app storage.
- You need to interact directly with app data.
Some workflows involve interacting directly with the data stored in Collect. For example, you may have a separate app on your device that monitors the .xml data as it is being collected. Or, you may be troubleshooting an error in one of your forms and be asked to submit the raw app data for debugging purposes. Please note: you do not need to use public app storage to submit form data.
- You do not have enough storage available in internal storage.
If your device has limited internal storage, but you have an external storage device like an SD card, switching to public storage can use the external media instead of internal storage.
If you would like to use public app storage instead of private, you can choose that option from the App storage location setting in Admin Settings. If you have a lot of form data stored on the device, switching storage locations may take a long time. Once you switch to public app storage, SurveyCTO Collect will store all data and settings in the following location:
Since many newer devices support multiple external SD cards – one or all of which tends to be non-removable – the actual location of public form and data storage can differ depending on the device (and this location may even be controlled by a device setting). Once you have switched to using public app storage, you can use a file browser on your device to locate the exact location of your SurveyCTO directory.
Users sometimes accidentally delete submissions, and removable SD cards occasionally fail. In order to safeguard against data loss, SurveyCTO can automatically maintain a backup copy of all finalized form data on your device's internal storage.
In Collect's settings (from the main menu, open the three-dot menu in the upper-right and choose General Settings), you can configure the number of days worth of data you wish to maintain in the internal storage backup. The default setting is to keep copies of finalized form data for 30 days in the device's internal storage. You can change this default to whatever number of days you prefer, with 0 indicating that you want to disable these internal backups altogether.
Restoring from backup
Restoring data from the internal backup is easy. (If you store data in public app storage and suffered an SD card failure, first be sure to insert a working SD card.) Simply run Collect, open the three-dot menu, and choose Restore Data; if you don't see the Restore Data option, click Admin Settings instead, scroll down, and enable the Restore Data option first. After restoring, you can upload the restored data to the server. (However, in order to edit or fill out any new forms you will need to select Get Blank Form to re-download the form definitions from the server. Blank forms are not backed up locally.)
If you would like to simulate an SD card failure before deploying your survey, follow these steps:
- First, ensure your device is set to use the Public storage option from the App storage location setting in Admin Settings.
- Stop Collect from running (using your device's Task Manager app).
- Use your computer or an on-device file manager to delete the entire contents of the
- Run SurveyCTO Collect again.
If your actual device fails and your data is stored on a removable SD card, you can follow these steps:
- Switch to a working device that satisfies the following conditions:
- There must be no existing form data stored on the new device (the following steps will overwrite any existing data).
- The new device must use the same type of SD card as the old device.
- SurveyCTO Collect on the new device must be set to use public app storage.
- Stop SurveyCTO Collect from running (using your device's Task Manager app).
- Remove the SD card from the failed device.
- Insert it into the working device.
- Start SurveyCTO Collect.