This field is optional but is highly desirable to use. The project name field is the name that will be displayed on the PIEL Survey App home screen. It will also be displayed prominently on the Placeholder Screen (the screen that appears in between scheduled surveys).
We suggest that you do not give the project a name that might be regarded as sensitive or private by participants.
project-name|PIEL Sample Survey
This field is optional but is highly desirable to use. The author field is displayed below the survey name on the home screen.
The author-email field is the address to which a project's surveys will be emailed at its completion. If you do not specify an email address, the participant will need to add it manually before sending the data file. Please take care to ensure that the email address is correct to avoid errors in sending the data file. As mentioned previously, we highly recommend that you test the survey, including sending data files before using the survey with participants.
This line allows the allocation of a unique identifier to each participant’s surveys and is recorded as a field in the output files. If you don't include a Subject ID, the PIEL Survey will ask for an ID when it runs the first survey. You should enter a subject-id if you don't want the participant to be asked to enter an ID.
Note that the subject-id can be 200 characters long and can include numbers and letters and other characters. The subject-id is used as part of the data file name so if necessary will be truncated to 20 characters and some characters replaced by a hyphen to make an acceptable file name. The subject-id in the data file will be the original unaltered subject-id.
random subject id
Rather than manually inserting a Subject Id in each control file, you can choose to insert a random number as the Subject Id by inserting the keyword "%RANDOM" (see the example below). This will ensure that all surveys sent from a particular device will have the same random number as the Subject Id in the data file and in the data file name itself. This number will remain the same unless the app is deleted and reinstalled.
Note that the participant cannot be identified using this random number. The only way to link the data to a particular participant is through direct contact with the participant, such as by the email used to send the data.