Участници в анкетата

Въведение

Функционалността Участници в проучването ви позволява да поканите група хора да участват във вашето проучване, да следите кой е попълнил проучването и да гарантирате, че всеки човек може да участва само веднъж. Функцията за таблица с участници в проучването ви позволява да направите следното:

• Импортиране на списък с имена и имейл адреси за участници от CSV файл или LDAP заявка;
• Генерирайте уникален токен код за всеки участник (код за покана);
• Изпратете имейл покана до всеки човек от вашия списък (по група или индивидуално);! N!*Изпратете имейл за напомняне на всеки човек от вашия списък, който все още не е отговорил (по група или индивидуално);
• Проследете кой е отговорил от вашия списък с участници в проучването;
• Ограничете достъпа за хора, които не са получили токен и тези с токен, които вече са отговорили;
• Редактирайте/променете всички подробности във вашия списък;
• Създайте имейл шаблони за покани и напомняния.

След като анкетата бъде превключена в режим на „затворен достъп“, „само хората, които предоставят уникален код на токен (който вече не е бил използван), имат достъп до анкетата“. (Първо трябва да създадете таблица с участниците в проучването за съответното проучване).

Ако активирате опцията Разрешаване на публична регистрация от панела Таблица с участници в анкетата, участниците в анкетата ще могат да се регистрират за вашата анкета, като получат автоматично генериран токен код.

Как да създадете таблица с участници в проучването

за да инициализирате таблица с участници в проучването: Настройки > Меню за проучване > Участници в проучването:

Ще се покаже следното съобщение:

Ако „инициализирате таблица с участници“, анкетата ще бъде достъпна само за онези участници, които предоставят код на токен в процеса на регистрация (ръчно или чрез URL). По този начин проучването ще премине в режим на затворен достъп.

След инициализиране ще се покаже прозорец, потвърждаващ създаването на таблицата с участниците в проучването.

Активирайте повторно таблица с участници в проучването

Когато изтриете таблица с участници в проучването, се създава резервно копие. По-късно може да се активира отново, ако искате да използвате тази конкретна таблица с участници в проучването в друго проучване.

Инструменти за управление на масата на участниците в проучването

„Резюме на участниците в проучването“ ще се покаже, ако таблицата с участниците в проучването е била създадена преди това. Това е екранът по подразбиране:

• 'Общи записи:' Броят на участниците в проучването от таблицата с участниците в проучването;
• Общо без уникален токен:' Показва броя на потребителите без присвоен код на токена;!N !*Общ брой изпратени покани: Показва броя на поканите, които са били изпратени до вашите участници в проучването от таблицата Участници в проучването чрез използване на опцията Покани от Покани и напомняния меню;
• Общо отказали се: Показва общия брой участници в проучването, които са решили да се откажат от проучването;
• 'Общо screened out:' Използва се за отсяване и изключване на потенциални участници, които не отговарят на определени критерии.
• Общ брой завършени анкети: Показва броя на анкетите, които са били попълнени от онези потребители, които са били разпределен код на токен.

Над таблицата Резюме на участниците в проучването ще намерите инструментите за управление на таблицата с участниците в проучването':

• Показване на участниците: Показва таблица с участници в проучването с всички текущи участници. От екрана за разглеждане можете да редактирате или изтривате отделни записи от таблицата, както и да изпълнявате редица други полезни функции (вижте раздела Покажи уикито на участниците по-долу за повече подробности);

*Създаване...: Позволява на администратора на проучването да добавя респонденти в таблицата с участници в проучването или чрез опцията Добавяне на участник, или чрез Импортиране на участници  функция;

• Управление на атрибути: Позволява на администратора на проучването да добавя допълнителни полета към таблицата с участници в проучването, за да съхранява персонализирани данни за участниците;
• Експортиране: За да експортирате таблиците с токени и да ги използвате в други проучвания, използвайте тази функция. Файлът ще бъде записан във формат .CSV;
• Участници в проучването: Позволява ви да поканите или напомните на вашите участници от таблицата с участници в проучването да попълнят вашето онлайн проучване;! N!*Генериране на токени: Позволява на администратора на проучването бързо да разпредели случаен уникален код на токен на всеки потребител от таблицата с участници в проучването, който няма такъв;
• Преглед в CPDB: Предоставя бърз достъп до вашата инсталация на LimeSurvey централна база данни на участници (CPDB). Оттам можете да разпределите потребители на CPDB като участници в проучването към всяко проучване.

Показване на участниците

Показва списъка с записи от таблицата с участници в проучването и позволява на потребителя да:

• сортиране на участниците в проучването;
• филтрирайте участниците в проучването;
• изпълнете определени действия към отделен запис;
• извършва определени действия към повече от един запис.

Сортиране на участниците в проучването

Вторият ред на таблицата включва различни критерии, които могат да помогнат на администратора на проучването да сортира записите. Ако щракнете върху някоя от колоните/критериите от таблицата, екранът ще се обнови, показвайки участниците в проучването, подредени в съответствие с критерия, върху който току-що сте кликнали. Кликнете два пъти върху него, за да получите резултатите, показани в низходящ ред.

Филтриране на участниците в проучването

За да филтрирате участниците в проучването, изберете колоната, която искате да филтрирате. След това въведете стойностите/низовете, по които искате да филтрирате, в празното поле под желаната колона.

Например, въведете „OK“ в полето за статус на имейл, за да върнете само онези участници, които имат валиден имейл адрес.

Подсказка: Можете също да използвате оператори, когато филтрирате участниците в проучването (напр.: >, <, >=, <=, =).

  За да филтрирате колоните „изпратена покана“, „изпратено напомняне“ и „завършена анкета“, използвайте „=N“ или „<>N“, което означава „равно на Не“ и „не е равно Не“, съответно.

Извършване на конкретно действие към отделен запис

Колоната Действие е мястото, където можете да намерите всички действия, които са налични за всеки отделен запис от таблицата с участниците в проучването. Възможните действия, които могат да бъдат извършени са:

• 'Преглед на подробностите за отговора:' Ако анкетата е "проследена" (т.е. не анонимна), ще се появи друг бутон, който ви позволява да видите отговора от този отделен запис;
• Стартирайте проучването с този токен: Използва се за изпълнение на проучване чрез използване на генерирания код на токена;
• Изпращане на покана по имейл: Използвайте тази опция, за да изпратите покана по имейл до съответния участник за попълване на анкетата;
• 'Редактиране на участника в анкетата:' Кликнете, за да промените анкетата данни на участника;
• 'Изтриване на участник в проучването: Щракнете, за да изтриете този конкретен запис;
• 'Преглед на този човек в централната база данни на участниците': Ще се покаже икона, ако съответният запис може да бъде намерен и в централната база данни на участниците.

Извършване на конкретно действие към повече от един запис

В долната лява част на таблицата ще намерите бутона Избран(и) участник(и)..., който ви позволява да извършвате определени действия на макро ниво:

• 'Изпращане на покани по имейл:' Изпращане на покани по имейл до избраните участници в проучването;
• Изпращане на напомняне по имейл:' Изпращане на напомняния по имейл до избраните участници в проучването;
• Добавяне на участници към централната база данни:' За да използвате някои от записите с токени в друго проучване, добавете избраните участници към централна база данни за участници. Оттам имате възможност да добавите участниците към всяка анкета, която желаете. За повече подробности продължете да четете wiki страницата Споделете този участник.

Преди да изпълните която и да е от функциите, споменати по-горе, не забравяйте да изберете участниците в проучването, върху които ще се извърши действието.

Създай...

За да имате повече участници, изброени в таблицата с участниците в проучването, можете да добавите нови или да ги импортирате от CSV файл или LDAP заявка.

Add participant

A typical token entry contains the following fields:

• ID: An integer that is automatically assigned to each survey participant;
• Completed?: Disabled by default. If enabled, it would contain the date when the survey was completed. No invitations or reminders are sent to the respective users if this is enabled. It is automatically enabled if the respective survey participant completed the survey using his or her assigned token code;
• First name: The first name of the survey participant;
• Last name: The last name of the survey participant;
• Token: This is the invitation code. It can be manually or automatically generated (via the Generate tokens button);
• Language: Here you can select the default language of the survey for the respective participant;
• Email: The email address of the participant;
• Email status: This field helps you track invalid email addresses. For instance, if the survey administrator received email error notifications from this email, then they can set this field to anything other than "OK" (for instance "user unknown" or "mailbox quota exceeded"). Marking this field 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 updates this field automatically;
• Invitation sent?: If enabled, contains the date when the invitation email was sent;
• Reminder sent?: If enabled, contains the date when the reminder email was sent;
• Uses left: Counts the 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 also have to switch the Completed field from "Yes" to "No";
• Valid from: & Until:You can set a date/time range for when this token can be used. You can leave these empty if you don't want to limit the participation time frame for certain users. 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.

Note that the Add survey participant panel has 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.

Create dummy participants

A dummy participant can be used when you do not want to send tokens by email to survey participants, but give them token codes by other means. For example, students doing class evaluations could be given a paper with an invitation code to be entered at the beginning of the online survey. This way, the likelihood of receiving more responses and feedback increases.

Click Create dummy participants and the following page will be displayed:

The Number of participants field allows you to enter the number of dummy participants you want to add to your survey participants table. The explanation of the other fields can be found in the Add participant wiki subsection.

After completing the fields, press Save located in the upper-right part of the screen.

To check whether they were added or not, check the Survey participants table:

Import participants from a CSV file

The import function allows you to import information from a CSV file or LDAP query.

• Choose the CSV file to upload: Pick the CSV file you wish to import. To eliminate any possible errors, we recommend that you import a standard CSV (comma delimited) file with optional double quotes around values (default for OpenOffice and Excel).

The first line must contain the field names. It must also contain the following fields: firstname, lastname, email.

They have to contain at least one character. Simply adding double quotes and no characters between them will not work!

The other fields are optional: emailstatus, token, language, validfrom, validuntil, attribute_1, attribute_2, attribute_3, usesleft, ... .

 Hint: To obtain a full list of token field names, export an existing survey participants table.

 Hint: The date format for the "validfrom" and "validuntil" fields in the CSV token inport file is "YYYY-MM-DD HH:MM".

• Character set of the file: Select the option that fits the characters used in the CSV file;
• Separator used: You can let LimeSurvey automatically discover the used separator in your CSV or select either the comma separator or the semicolon one;
• Filter blank email addresses: If enabled, the survey participants without an email address will not be imported into your survey participants table;
• Allow invalid email addresses: If disabled, this function will look into the email addresses fields and check whether the addresses have the structure of an email or not (e.g.: a@a.net);
• Display attribute warnings: If enabled, after the importing process warnings will be displayed in case there is something wrong with the fields. For example. you might get an attribute warning if nothing is provided in any of the mandatory fields or if an email is incorrectly introduced in the CSV file.

• Filter duplicate records: If enabled, you can set which fields are used to identify duplicates. By default First name, Last name & Email-address are preselected. If a duplicate is found while importing, the related line is omitted.

• Duplicates are determined by: Select the fields that you want to filter on for duplicates.

You can also import customized attributes when importing a CSV file. You will have to define what attributes will be added. You can do it like this:

   email,attribute_1 <Casenr>, token, attribute_2 <Title>, attribute_3 <destination>, lastname,firstname,attribute_4 <Sender>

Once you are done choosing the desired importing settings, do not forget to click on the Upload button.

Troubleshooting the import of survey participants

A common error when users try to import tokens is an invalid CSV file. This is often caused by Microsoft Excel. Many users have a list of email addresses saved as an XLS document. A file can be saved as CSV in Excel. However, depending on the locale of the OS, Microsoft Excel may use semi-colons (;) as comma separator, while a standard CSV file uses commas (,) as separators. If you do not know which one you use, open the file with a standard text editor and verify which separator was used.

Recommended free raw text editors are: PSPad, NotePad2 or Notepad++ for Windows, and TextWrangler for Macintosh.

LimeSurvey should also detect semicolons as separators. However, in case the import process is not properly working, replace the semicolons with commas. Double quotes should also be added around values.

Import participants from a LDAP query

  This option is recommended only to those users with advanced knowledge in LDAP queries.

This import function allows you to import information from a LDAP query (tested on openLdap, but should work in any LDAP compliant directory including ActiveDirectory). The following options are available on the Import survey participants from LDAP page:

• Queries are manually defined by the system administrator in the config-ldap.php file.
• Duplicates are identified by First Name, Last Name & Email-Address. If a duplicate is found while importing, the related line is omitted (unless you have unchecked the Filter Duplicates checkbox).

For more details about the LDAP settings in LimeSurvey, read the following wiki page.

Manage attributes

This option allows you to add/edit the additional fields of your survey participants table. The extra fields are used to store custom survey participants data.

Type in the number of new attribute fields you want to add to your survey participants table. Click the Add fields button. The following page will be displayed:

The attribute fields table contains the following fields:

• Attribute field: The value typed here can be used when you want to perform different operations with the respective custom attribute field such as applying conditions based on attribute fields or when exporting results for non-anonymous surveys.
• Field description: Used to replace the attribute field name. By giving a custom name to each attribute field, they will look nicer in the administration panel, when you browse tokens, when creating conditions based on attribute fields or when you export results for non-anonymous surveys.
• Mandatory?: If enabled, the respective attribute field must be filled in by the survey administrator. Otherwise, the respondent cannot be registered into the survey participants table.
• Show during registration?: If the survey participants have to register before completing a survey, certain details will be requested from them. If disabled, the respective attribute field won't appear on the survey registration page.
• Field caption: Use this fields to add more details about the role/usage of the respective attribute field.
• CPDB mapping: Maps the attribute in order to connect it to its corresponding attribute from the central participant database.
• Example data: Contains string examples from different fields. For example, if you want to ask for the gender of the survey participant, then you will see in the Example data field examples such as male, female, no answer etc.

Once you have finished filling in the boxes, do not forget to click the Save button located in the bottom-left part of the screen.

Detailed instructions on how to add additional attribute fields and use conditions based on these values can be found on this blog post: "Conditions based on token attributes".

To add more fields, go to the bottom of the page, and type in the Number of attribute fields to add box the desired number and click the Add fields button.

If you want to delete a custom attribute, go to the bottom of the page and select from the drop-down list situated under the Delete this attribute field the attribute you want to delete. Once selected, click Delete attribute and confirm the deletion.

Export

To export a survey participants table, click the "Export" button located on the token management tools toolbar. Before exporting the survey participants list, select the desired export options.

• Survey status:
  • All tokens: Exports all survey participants from the survey participants table;
  • Completed: Exports only those survey participants that have completed the survey;
  • Not completed: Exports survey participants that have not yet completed the survey;
  • Not started: Exports the survey participants that have not yet started the survey;
  • Started but not yet completed: Exports survey participants that have already started the survey, but have not completed it.
• Invitation status: Exports participants according to the invitation status: all, invited, and not invited;
• Reminder status: Exports participants according to the reminder status: all, Reminder(s) sent, No reminder(s) sent;
• Filter by language: When you create a survey, you can add additional languages besides the base language. Those additional languages can be used to export survey participants according to the language they are assigned to;
• Filter by email address: Exports entries which contain the string in the respective email address. For example, you can use it if some of your survey participants use the work email addresses from "Company A". Type @companya.com and export only the users that have received a work email address from the respective company;
• Delete exported participants: If enabled, the exported users will be deleted from your survey participants table.

Once you have selected the exporting options, click the Download CSV file button located in the upper right part of the screen.

When you export your survey participants, the fields are exported in the following order:

tid,firstname,lastname,email,emailstatus,token,language code,attribute_1,attribute_2,...

Invitations & reminders

Invitations & Reminders allows you to manage the LimeSurvey invitations system. You can send invitations or reminders to participants displayed in your survey participants table. An email bounce tracking system can be used to help you track and mark the emails that were not delivered to the recipients (survey participants).

Send email invitation

From the survey participants table you can send email invitations in bulk to all participants who have not been sent one.

You can skip survey participants who have an email status that is not "OK" by enabling the Bypass token with failing email addresses option.

To overcome the validity settings of all of your entries, enable the Bypass date control before sending email function. This way, the LimeSurvey email function will not take into account the date/time range when a token would be allowed to be used.

Resending invitations

Use this functionality to send invitations again to certain survey participants. When you use the send invitations function, only an email address that has not previously received an invitation will get one. This means that if you add new email addresses to the survey participants list after the first invitations are sent, only these new addresses will receive an invitation the second time you send invitations.

This means that you can also edit an email address in a particular table entry that you received a bounced email from and then send it only to this edited address. Do this by turning off the Invitation sent field and then click send invitations again.

Send email reminder

Sends bulk email reminders to all participants from the survey participants table who have not yet responded, but have been sent their first invitation.

When sending reminders you can:

• Bypass tokens with failing email addresses: those entries with a failing email address will be skipped - they will not receive an email;
• Min days between reminders: skip tokens if a reminder has been "recently" sent;
• Max reminders: skip tokens if a given number of reminders have already been sent;
• Bypass date control before sending email: skip those entries that are not within the time-frame that they can be used.

Note: A reminder will be sent only to those participants where the "Completed" field is turned off (this means the respondent has either not taken or completed the survey).

Sending emails by batch

When sending a large number of emails at the same time, LimeSurvey will only send the first batch of N emails (this threshold is set by the administrator from the email settings, located in the global settings of your LimeSurvey installation).

Confirmation email

If you are using tokens and a participant fills out the survey, a confirmation email is sent to their email address.

If you do not want this message sent, deactivate this functionality from the general settings of your survey.

Start bounce processing

When sending an email, the LimeSurvey email bounce tracking system automatically adds a survey-id and token-id to the mail header. These "custom headers" are added to each invitation email that is sent through your LimeSurvey installation to survey participants. When the email is bounced back, the original header along with the "Delivery notification" header is received. The system then checks for new emails and parses the emails that have these custom headers and marks the wrong email address in the survey participants table.

Bounce settings

Bounce settings options:

For a short description of each field, check the following wiki section. To use the LimeSurvey installation Global settings, go to Used bounce settings and select the Use global settings option.

For more in-depth explanations, check our wiki on email bounce tracking system.

Click the following link for more information on how to correctly configure this feature.

Edit email templates

To find out more about what placeholders you can use or how you can edit the LimeSurvey email templates, read our wiki section on email templates.

Generate tokens

With the help of this function, unique tokens can be created for all the individual entries from the survey participants table that have not yet received a token code.

View in CPDB

The last option on the tokens management toolbar is the View in CPDB option. This allows the survey administrator to see the participants that exist in both the central participant database and the survey participants list.

In the following example, we have the following survey participants list:

The users with ID 1 and 2 have been shared from the central participant database. To check this, go to the survey participants table management toolbar and click View in CPDB

As you can see, the View in CPDB function basically applies a filter to determine which users from the CPDB are present in the respective survey.

Delete table

To delete your survey participants table, click the Display participants button and look for the Delete participants table button located in the upper-right part of the screen.

A window will pop up, asking for the final confirmation.

Please note that this will not delete the table from your LimeSurvey installation. A backup will be created. In order to access it, you need system administrator rights.

If you do wish to completely remove it, use the check data integrity option that is located in the Configuration dialog.

Additional hints & tips

Feel free to add any hints and tips to the list below. The ones listed were posted by members of our community:

• Allowing public registration
• Captchas in public registration
• Can a survey using tokens ensure anonymous responses?
• A tip for generating a large number of fake e-mail addresses
• Spam problems
• Pseudonymised participation

Allowing public registration

You can also open your survey to the public by utilizing the type of respondent control available when using tokens. To do this, initialize your survey participants table and choose to allow public registration in the main survey setup. People who visit your survey's URL without a token will be given the opportunity to register. (This setting can be later changed from the participant settings section that is located in the settings menu of the survey).

If a participant provides an email address that is not already in the current database, an entry in the survey participants table will be created and they will be emailed an invitation containing their unique token code. All tokens provided to "registering" visitors will begin with the letter "R".

CAPTCHAs in public registration

To protect your survey from robot registrations, a CAPTCHA feature can be activated for all the registration, save, and load forms. For more details, read our wiki on participant settings.

Can a survey using tokens ensure anonymous responses?

Yes, tokens can be used both for anonymous and non-anonymous surveys. This is determined when creating a survey. If a survey is not anonymous (or 'tracked') then the token list can be used to find the responses that an individual has made to the survey. If the survey is anonymous, then no link (technically: foreign key relationship) is available between the respondents from the survey participants table and their corresponding answers.

To enable or disable anonymized responses, check the participant settings wiki section.

A Tip for generating a large number of fake e-mail addresses

Sometimes you may need a large number of fake e-mail addresses and tokens. You can use functions in a spreadsheet (e.g. OpenOffice Calc) to generate them. Let's assume you want thousands of addresses in a form: 1@test.com, 2@test.com, 3@test.com, and so on. Type "1" in A1. Insert function =A1+1 in A2, then copy A2 down as many times as you need so that you obtain a list of consecutive numbers. In B1 use the concatenation function to join A1 and "@test.com", which is =CONCATENATE(A1;"@test.com"). Then copy B1 down so that each A cell has a correspondent (you can also generate similarly fake names). Finally, save the file as CSV in order to import it to LimeSurvey.

With the launch of LimeSurvey 1.91, you can use the "Generate dummy token" functionality. However, the dummy entries do not contain any email address.

Spam problems

Users often complain about not receiving invitations or reminder emails because their email spam filters identified the message from LimeSurvey as spam.

The fact that an email is treated as spam depends mostly on the spam filter being used and its settings. A spam filter usually checks the sender address, and the email subject and content. Changing its settings could solve the way in which the users' email providers treat the messages from LimeSurvey.

Some possible issues and solutions are listed in the following Limesurvey Consulting blog post.

LimeSurvey automatically tries to determine the URL for the invitation link by looking at the URL that you logged into the LimeSurvey administration with. However, with some server (mis)configurations this might not work properly and you will have to set this manually.

You can edit "application/config/config.php" to change the default base URL value. Add a hostInfo property, as shown below, to the existing 'components' array.

    'components' => array(
       ...
       'config' => array(
           .......
           'publicurl' => 'http://www.example.com',
           ........
       ),
   )

For more details on how to edit the configuration file of your LimeSurvey installation, read our wiki on LimeSurvey optional settings.

Regarding the source of the problem, LimeSurvey tried to determine the domain from the server PHP variable: $_SERVER['HTTP_HOST'] or $_SERVER['SERVER_NAME'].

Some web server software do not properly seem to provide this information or are misconfigured.

Pseudonymised participation

With the dummy tokens, you may create a form of pseudonymised participation by exporting the created dummy tokens and then combining them with your participant list externally. That way, LimeSurvey can be used as a survey platform without putting personal information of your participants into the system.

The only downside is that you will have to distribute the participation tokens yourself.