Survey participants/es

Introducción

En muchas ocasiones quieres invitar a un grupo de gente a participar en una encuesta, llevar un seguimiento de quien la ha completado y asegurarte de que cada persona sólo pueda participar una vez. La función tabla de participantes te permiten hacer lo siguiente:

• Importar una lista de nombres y direcciones de correo para los participantes (desde un archivo CSV o una consulta a una base de datos LDAP);
• Generar un código de seguridad único para cada participante (código de invitación);
• Enviar una invitación por correo electrónico a cada persona de tu lista (por grupo o individualmente);
• Enviar un recordatorio por correo electrónico a las personas de tu lista que aún no han respondido (por grupo o individualmente);
• Rastrear quien de tu lista ha respondido;
• Restringir el acceso a la gente que no tiene un código de seguridad y a aquellos que ya ha respondido;
• Editar/cambiar cualquier detalle de tu lista;
• Crear plantillas de correo para invitaciones y recordatorios.

Una vez que el acceso a la encuesta sea cambiado a modo " acceso cerrado" (primero debes crear una tabla de participantes para la encuesta respectiva) sólo las personas con un código de seguridad válido (que no haya sido usado) podrán acceder a la encuesta.

Si has activado la opción Permitir registro público en el panel "Tabla de participantes de la encuesta", los participantes podrán registrarse en tu encuesta para obtener un código de seguridad generado automáticamente.

¿Cómo crear una tabla de participantes?

Para activar la tabla de participantes, acceda a la encuesta y seleccione el botón "Participantes de la encuesta" en el menú "Configuración"

The following message will be displayed:

If you initialize a participant table, the survey will be accessible only to those participants who provide a token code in the registration process (either manually or by URL). This way, the survey will be switched to closed-access mode.

Once initialized, a window will be displayed confirming the creation of the survey participants table.

Once initialized, a window will be displayed confirming the creation of the survey participants table.

Reactivate a Survey Participants Table

When you delete a survey participants table, a backup is created. It can later be reactivated if you wish to use that specific survey participants table in another survey.

Herramientas para la gestión de las fichas

A survey participant summary will be displayed if the survey participants table was previously created. This is the default screen:

• Total records: The number of survey participants from the survey participants table;
• Total with no unique token: Displays the number of users without an assigned token code;
• Total invitations sent: Shows the number of invitations that have been sent to your survey participants from the Survey participants table by using the Invitations option from the Invitations & reminders menu;
• Total opted out: Displays the total number of survey participants that have decided to opt out from the survey;
• Total screened out: Used to screen and exclude potential participants who do not match certain criteria.
• Total surveys completed: Shows the number of the surveys that have been completed by those users who have been allocated a token code.

Above the Survey participant summary table, you will find the survey participants table management tools:

• Display participants: Displays a survey participants table with all the current participants. From the browse screen you can edit or delete individual entries from the table as well as perform a number of other useful functions (see the Display participants wiki section below for more details);
• Create...: Allows the survey administrator to add respondents into the survey participants table either via the Add participant option or via the Import participants function;
• Manage attributes: Allows the survey administrator to add additional fields to the survey participants table to store custom participant data;
• Export: To export the token tables and use them in other surveys, use this function. The file will be saved in the .CSV format;
• Survey participants: Allows you to invite or remind your participants from the survey participants table to fill out your online survey;
• Generate tokens: Allows the survey administrator to quickly allocate a random unique token code to each user from the survey participants table that does not have one;
• View in CPDB: Provides quick access to your LimeSurvey installation central participant database (CPDB). From there you can allocate CPDB users as survey participants to any survey.

Display Participants

la pantalla de buscar te mostrará una lista de todas las entradas en la tabla de fichas, Así como proporcionarle botones de "acción" que pueden llevar a cabo funciones específicas de cada entrada.

Sort Survey Participants

La segunda fila de la tabla incluye el nombre del campo y una flecha verde que - Si la pulsas - se refrescará la pantalla mostrando las fichas ordenadas por el campo. La última fila de la tabla le permite ir hacia atrás o hacia delante a través de la lista (basado en la configuración en la parte superior).

Filter Survey Participants

To filter survey participants, choose the column that you want to filter. Then type in the values/strings that you want to filter on in the empty box below the desired column.

For example, type "OK" in the email status field to return only those participants that have a valid email address.

Hint: You can also use operators when filtering the survey participants (e.g.,: >, <, >=, <=, = ).

  To filter "invitation sent", "reminder sent", and "survey completed" columns, use "=N" or "<>N", meaning "equal No" and "not equal No", respectively.

Perform a Specific Action to an Individual Entry

The Action column is where you can find all the actions that are available for each individual entry from the survey participants table. The possible actions that can be performed are:

• Editar esta entrada
• Eliminar esta entrada
• Hacer la encuesta utilizando la única ficha de esta entrada.
• Enviar una invitación/recordatorio a esta entrada individual.
• Si la encuesta no es anónima,aparecerá un botón extra, que te permitira ver la respuesta de esa entrada.

Perform a Specific Action to More Than One Entry

On the bottom-left part of the table, you will find the Selected participant(s)... button that allows you to perform certain actions at a macro level:

• Send email invitations: Send email invitations to the selected survey participants;
• Send email reminder: Send email reminders to the selected survey participants;
• Add participants to central database: To use some of the token entries in another survey, add the selected participants to the central participant database. From there, you have the option to add the participants to any survey you wish. For more details, continue reading the Share this participant wiki page.

Before executing any of the functions mentioned above, do not forget to select the survey participants upon which the action will be performed.

Create...

To have more participants listed in the survey participants table, you can add new ones or import them from a CSV file or LDAP query.

Add Participant

Una entrada típica de una ficha contiene los siguientes campos:

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

• Nombre y Apellido: ..De cada participante (Puede ser usado en los correos elctrónicos y en la encuesta)
• Correo electrónico: La dirección de correo electrónico del participante
• Estado del correo: Un campo para rastrear correos incorrectos. Por ejemplo, si el administrador de la encuesta recibe una notificación de correo incorrecto para ese correo, que puede fijar ese campo o cualquier otro como "ok" (por ejemplo "usuario desconocido, o bandeja de entrada lleno).Marcando esta muestra con un estado de mail diferente 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.
• ficha: Es el código de invitación. Suele generarse automáticamente con el botón "generar fichas"
• Idioma: Puedes fijar un idioma predeterminado para este participante
• Invitación enviada: Por defecto en "N", contiene la fecha en que el correo electrónico de invitación fue enviado
• Completo_: por defecto en "N", puede contener la fecha de cuando la encuesta ha sido respondida.
• Usos restantes: Un contador del número de veces que puede usarse la ficha.
• Valido desde & Valido hasta  : Permite fijar un tiempo en el que esa ficha pueda usarse, puedes dejar este campo vacío si no quieres la limitación por tiempo Nota: Si el participante esta contestando la encuesta y el tiempo de participación termina el usuario es bloqueado y no se le permite acabar la encuesta.
• Propiedad1 a propiedad x: Son campos de propiedades definibles por el usuario -ver el siguiente párrafo.

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

Para obtener una lista completa de los nombres de los campos de las casillas exporta un tabla  de fichas que ya exista

 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.

Si activas la opción para filtrar duplicados puedes fijar en que campos deben buscarse duplicados. Por defecto Nombre, apellido y dirección de correo están seleccionados.Si es encontrado algo duplicado no se importará esa información.

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

Resolución de Problemas en el importe de fichas

Un error común cuando los usuarios intentan importar fichas es un archivo CSV no válido. Esto suele estar causado por microsoft Excel. Muchos usuarios tienen una lista de correos guardados como un archivo XLS. Un archivo puede gusradarse como CSV en Excel, however, Microsoft usa punto y coma (;) como coma, mientras que los archivos CSV utilizan coma (,) como separador, si estás intentando importar un Excel guardado en CSV te aparecerá un mensaje de error.Una solución simple es guardar tus documentos XLS como un archivo CSV en excel y abrir el archivo en un procesador RAW de texto y cambiar los punto y coma por comas.

Editores RAW de texto son: PSPad, NotePad2 or Notepad++.

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:

• Las preguntas son definidas manualmente por el administrador del sistema en el archivo config-ldap.php
• Los duplicados son identificados por nombre, apellido y dirección de correo. Si se encuentra un duplicado la información duplicada no se importará excepto que no hayas pulsado la opción de duplicados.

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.

Cuando estas exportando tus fichas la siguiente lista te aparecerá:

Invitations & Reminders

Invitations & Reiminders 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.

Puede omitir las fichas para que el campo e-mail sea diferente de "Aceptar", seleccionando "Desviar ficha" con direcciones de correo electrónico por defecto.

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.

Reenviando invitaciones

A veces quieres enviar invitaciones de nuevo a ciertas fichas de entrada/personas. Cuando usas enviar invitaciones sólo los correos que no han recibido una invitación previamente reciben una. Esto significa que si añades nuevas direcciones a la lista de fichas despues de mandar las invitaciones sólo esas nuevas direcciones recibiran invitaciones la segunda vez que envíes invitaciones

Esto significa que tambien puedes editar/cambiar un correo en una ficha particular donde recibiste un correo de rebote para mandar el correo sólo a esa dirección pulsa Enviar invitaciones? para la mayúscula N (no) y pulsar Enviar invitaciones de nuevo.

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.

Cuando mandas recordatorios puedes:

• Desviar fichas fallando la dirección de correo
• Limpiar fichas para un correo "recientemente" mandado
• Limpiar fichas para un número de correos ya enviados

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

enviando correos en masa

cuando has mandado montones de correos al mismo tiempo LimeSurvey sólo enviará un primer lote de N correos electrónicos (este númer("N") se establece por el administrador del sistema en el archivo config.php)

Correo de confirmación

Si estas usando las fichas y un participante completa la encuesta una confirmación se le enviará a su correo electrónico.

Si no quieres que ese correo se mande elimina todo el contenido de los campos de "Asunto del correo de confirmación" -  Vea estas instrucciones.

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.

El rebote de correos electrónicos fue añadido en la versión 1.91.

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

Permitir registros públicos

Quizás quieras abrir tu encuesta a todo el mundo, pero utilizando el modo de control disponible con las fichas.Esto es posible: Si inicias tu tabla de fichas y eliges permitir Registros públicos en la configuración general de la encuesta. Las personas que visiten el link de tu encuesta sin una ficha, tendrán la oportunidad de registrarse. Si facilitan un correo qu no esté en la tabla de fichas se creará una nueva entrada para esa dirección y recibirán un correode invitación que contenga su ficha única, todas las fichas dadas a registros de visitantes comenzarán con la letra "R"

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 en el registro público

Para proteger tu encuesta de el registro de un robot hay una función de captchas para los registros, (a partir de la versión 1.48)esta caracteristica esta sólo disponible si tienes el soporte GD activado en tu configuración PHP.(Verinstalación/requisitos de instalación)

Una encuesta que utiliza contraseñas puede asegurar el anonimato de las respuestas?

La respuesta a esto es Si. Las contraseñas pueden usarse tanto para encuestas anónimas como para encuestas no anónimas. Esto se determina al crear una encuesta. Si la encuesta no es anónima (o "rastreable") entonces la lista de contraseñas podrá usarse para encontrar las respuestas que una persona ha hecho en la encuesta. Si la encuesta es anónima, entonces no habrá un nexo disponible (técnicamente: una relación clave) entre la tabla de contraseñas las respuestas y las respuestas de los encuestados.

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

Un consejo para generar un numero largo o una dirección de mail

A veces necesitas un largo número de e-mails y fichas falsos. puedes utilizar funciones en una hoja de calculo para generarl. Vamos a asumir que quieres cientos de direcciones con la forma: 1@tes.com 2@test.com 3@test.com ... Pon números consecutivos en la columna  A: 1 en el A1, e inserta la  funcion =A1+1 en A2: entonces copia A2 debajo tantas veces como necesites. En B1 use la función concatenación  para acceder A1 y "@test.com", como =CONCATENATE(A1;"@test.com"). Entonces copia B1 debajo por cada copia de  A. Puedes generar nombres falsos de una manera similar. Finalmente guarda el archivo como CSV para importarlo en LS.

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