Project Setup

Importing the Control File

Once the Control File has been saved as a ".survey" file it can be installed into the PIEL Survey App. There are 3 ways of doing this: email, messaging and file sharing.


In general, most researchers will choose to use the email option. It is simple and intuitive to participants.

  • 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 project 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.


Messaging apps that allow attachments can be used. These include Apple Messages app and WhatsApp Messenger. Please search these apps for instructions on sending attached files.

File Sharing

File sharing is more likely to be useful if the researcher provides the participants with devices, or the participants visit the office of the researcher.

The instructions below are for using a USB connection. For instructions on using Airdrop or Bluetooth, please refer to the documentation for your device.

Computers with MacOS version Catalina or later use Finder for file sharing. Earlier versions of MacOS or computers with Windows 7 or later use iTunes. Instructions for iTunes are below.

  • 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 project Control File, it will be displayed on the PIEL Survey home screen. Multiple projects can be loaded into the App but only one of these can be chosen at any time. A project is made active by tapping it. It will then show as selected (see screenshot below). The changes you will see are as follows.

  • The project will be shown as selected. In the screenshot below, the third project 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 project.

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).