Note that the '''Add survey participant''' panel is made of two tabs: the '''General tab''' and the '''Additional attributes''' tab. The additional attributes tab offers you access to your custom attributes - read the following [[Survey participants#Manage attributes|wiki section]] for more details.
*'''First and last name''': .. of the participant (can be used in the emails & survey)
*'''Email''': the participant's email address
*'''Email status''': a field to keep track of bad emails. For instance, if the survey administrator received email error notifications from this email, the he can set this field to anything other than 'OK' (for instance 'user unknown', or 'mailbox quota exceeded'). Marking this token with an email status other than 'OK', will help skip this entry when sending invitation or reminder emails. Note that this is completely manual, unless you decide to implement a script which does update this field automatically.
*'''Token''': this is the invitation code. It is usually automatically generated by the 'Generate tokens' button
*'''Language''': if you want to set the default language for this participant
*'''Invite sent''': defaults to 'N', otherwise would contain the date when the invitation email was sent
*'''Reminder sent''': defaults to 'N', otherwise would contain the date when the reminder email was sent
*'''Completed''': defaults to 'N', otherwise would contain the date when the survey was submitted for not anonymous survey, or 'Y' for anonymous survey
*'''Uses left''': A counter of number of times the token can be used. ''Note:'' When increasing this value (default = 1) for a user who has already filled out the survey (which sets uses left to 0), you have to add "N" at the "completed" field.
*'''Valid from''' & '''Valid until''' : You can set a date/time range where this token would be allowed to use. You can leave these empty if you don't want to limit participation time frame for certain users. Note: If the user is answering the survey and the participation time ends then the user is locked out immediately and won't be able to finish the survey.
*'''Attribute1 to Attribute x''': These are user-definable attribute fields - see the next paragraph.
Revision as of 14:10, 1 March 2018
Note that the Add survey participant panel is made of two tabs: the General tab and the Additional attributes tab. The additional attributes tab offers you access to your custom attributes - read the following wiki section for more details.