Printed from: SurveyCTO Product Documentation
Source URL: https://docs.surveycto.com/03-collecting-data/01-mobile-data-collection/08.local-device-data.html
Last updated: 2024-11-30
  1. Home
  2. Collecting data - Mobile data collection

Finding and safeguarding local device data

Previous Next

Private workspace 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 workspace storage

Warning
With each new version of Android, Google makes it harder for apps to access certain areas of device storage. If you can't locate the public folder location discussed here, try installing this file manager app and using it to find and access the folder.
Platform limitation
Only SurveyCTO Collect for Android supports the public workspace storage discussed here. iOS devices always store data in private internal storage. More about platform limitations...
Workspace restrictions
If your workspace is connected to a server that has the don't allow any outside access setting enabled, public storage will be disallowed. If you need to use public storage, please make sure your server has that setting disabled. See the topic on managing device security for more information.

There are a few reasons why you might want to switch to using public workspace 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 workspace 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 storage instead of private, you can choose that option from the Workspace storage location setting in Admin Settings. If you have a lot of form data stored in that workspace, switching storage locations may take a long time. Once you switch to public storage, SurveyCTO Collect will store all data and settings for your workspace in a workspace-specific folder in the following location:

/Android/data/com.surveycto.collect.android/files

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 storage, you can use a file browser on your device to locate the exact location of your com.surveycto.collect.android/files directory.

SurveyCTO directory in Android storage

Using SD cards with Collect

If you would like SurveyCTO Collect to use SD card storage instead of built-in storage to store local copies of collected data, you will need to follow these steps when setting up your devices:

  1. Collect must be installed. See the topic on Using the SurveyCTO Collect app.
  2. On your Android device, open Settings, then Apps & notifications, and locate SurveyCTO Collect in the list of apps. Use the Storage option to select your SD card.
  3. Open SurveyCTO Collect.
  4. Tap on the three-dot icon in the upper-right and open Admin Settings, scroll down to the bottom, and swap the Workspace storage location option to Public storage.

You can then configure Collect (see the linked topic above) and start collecting data that will be saved to the SD card.

Automatic backups

Securing your data
Automated backups are intended to protect against user error or external media failure, but the safest way to protect your data is always to make sure it gets submitted to your server.

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.

Collect's auto-backup settings

Restoring from backup

Restoring data from the internal backup is easy. (If you store data in public workspace 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.)

Menu-button options
Restore-data confirmation

If you would like to simulate an SD card failure before deploying your survey, follow these steps:

  1. First, ensure your workspace is set to use the Public storage option from the Workspace storage location setting in Admin Settings.
  2. Stop Collect from running (using your device's Task Manager app).
  3. Use your computer or an on-device file manager to delete the entire contents of the workspace directory located in /Android/data/com.surveycto.collect.android/files.
  4. Run SurveyCTO Collect again.

If your actual device fails and your data is stored on a removable SD card, you can follow these steps:

  1. 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 workspace storage.
  2. Stop SurveyCTO Collect from running (using your device's Task Manager app).
  3. Remove the SD card from the failed device.
  4. Insert it into the working device.
  5. Start SurveyCTO Collect.
Previous Next
Support Center