Survey Setup

Import Control File

There are 2 main ways of installing a control file on a device: file sharing or email.

In general, most researchers will choose to use the email option. It is simple and intuitive to participants. File sharing is more likely to be useful if the researcher provides the participants with devices, with the survey pre-loaded.


  • Email the Control File to a device with a valid email account.
  • On the device, press-and-hold (also called long-press) the attachment of the email until a menu shows or the icon becomes highlighted (depending on which iOS).
  • Then tap the PIEL Survey icon in the list.
  • If the icon is not visible in the list, tap "More" and scroll to it. You can even drag the icon to a more convenient location in the menu.
  • The PIEL Survey will be opened with the file imported.
  • If you only tapped the attachment with a short tap, iOS will open the file as a text file. Don't worry!. You can then tap the "Share" button (it has a vertical arrow) which will bring up a similar menu.

File Sharing

  • Plug the device into the computer and open iTunes.
  • Click on the icon indicating your device at the top of the window.
  • Click on file sharing.
  • Scroll down to the PIEL Survey app and click.
  • In the window on the right you will see a list of all the files currently loaded on the PIEL Survey app.
  • Either drag and drop the Control File into this window or click the button "add".
  • The next time you bring the app to the foreground, it will import the file.

Control File Errors

If you make an error when creating the Control File, it is usually easy to fix. You will get an error message during the import. We have gone to great lengths to make the messages clear so that error can be fixed quickly.

If you are not able to resolve a problem importing a Survey File, do not hesitate to contact us through our web contact form.

The Home Screen

After importing the survey Control File, it will be displayed on the PIEL Survey home screen. Tapping on the survey will make it the currently active survey. Multiple surveys can be loaded into the App but only one of these can be chosen at any time. A survey is made active by tapping it. It will then show as selected (see screenshot below). The changes you will see are as follows.

  • The survey will be shown as selected. In the screenshot below, the third survey is selected.
  • If "can-run-once" is enabled, the start button will show "Start Run-once Survey". If not, it will show "Start Scheduled Survey".
  • If "can-test" is enabled, the "Test" button will be highlighted.
  • If there is data, a blue "action arrow" will be seen. In the screenshot below, there is data for the first survey.

A survey can be deleted by swiping the file name to the left, the word "Delete" will appear (see screenshot below). After tapping this, a warning will appear that all data will be deleted, giving the user the option to cancel .

The user can also email or delete the data by tapping the blue "action arrow. This will provide the choice (see screenshot below).