调查参与者

简介

通过“调查参与者”功能，您可以邀请一组人员参与您的调查，跟踪哪些人已完成调查，并确保每个人只能参与一次。调查参与者表功能允许您执行以下操作：

• 从 CSV 文件或 LDAP 查询导入参与者的姓名和电子邮件地址列表；
• 为每位参与者生成唯一的邀请码（邀请码）；
• 向列表中的每个人发送电子邮件邀请（按组或单独发送）；
• 向列表中尚未回复的每个人发送提醒邮件（按组或单独发送）；
• 跟踪调查参与者列表中哪些人已作答；
• 限制未收到邀请码的人员以及已使用邀请码作答的人员访问调查；
• 编辑/更改列表中的任何详细信息；
• 为邀请和提醒创建邮件模版。

一旦调查切换为封闭访问模式，只有提供唯一邀请码（且该邀请码尚未被使用）的人员才能访问调查。（您需要先为相应的调查创建调查参与者表。）

如果您在调查参与者表面板中启用允许公开注册选项，调查参与者将可以通过获得自动生成的邀请码来注册您的调查。

部分与邀请码相关的设置存储在参与者设置面板中。

如何创建调查参与者表

要初始化调查参与者表：设置 > 问卷调查菜单 > 调查参与者：

将显示以下消息：

如果您初始化参与者表，则只有在注册过程中（手动或通过 URL）提供邀请码的参与者才能访问该调查。这样，调查将切换为封闭访问模式。

初始化完成后，将显示一个窗口，确认调查参与者表已创建。

重新激活调查参与者表

删除调查参与者表时，系统会创建备份。如果您希望在另一个调查中使用该调查参与者表，可以稍后重新激活它。

调查参与者表管理工具

如果之前已创建调查参与者表，将显示调查参与者摘要。这是默认屏幕：

• 记录总数： 调查参与者表中的调查参与者数量；
• 无唯一邀请码的总数： 显示未分配邀请码的用户数量；
• 已发送邀请总数： 显示通过邀请与提醒菜单中的邀请选项向调查参与者表中的调查参与者发送的邀请数量；
• 已退出总数： 显示决定退出调查的调查参与者总数；
• 已筛除总数： 用于筛选并排除不符合特定条件的潜在参与者。
• 已完成调查总数： 显示已分配邀请码的用户所完成的调查数量。

在调查参与者摘要表上方，您会看到调查参与者表管理工具:

• 显示参与者：显示包含所有当前参与者的调查参与者表。在浏览屏幕中，您可以编辑或删除表中的单个条目，并执行其他一些有用的功能（更多详细信息请参阅下方的显示参与者部分）；
• 创建...：允许调查管理员通过添加参与者选项或导入参与者功能将受访者添加到调查参与者表中；
• 管理属性：允许调查管理员向调查参与者表添加额外字段，以存储自定义参与者数据；
• 导出：使用此功能可导出邀请码表，以便在其他调查中使用。文件将以 .CSV 格式保存；
• 调查参与者：允许您邀请或提醒调查参与者表中的参与者填写您的在线调查；
• 生成邀请码：允许调查管理员快速为调查参与者表中尚无邀请码的每位用户分配一个随机的唯一邀请码；
• 在CPDB中查看：提供快速访问您的 LimeSurvey 安装的参与者中央数据库（CPDB）的入口。您可以从中将 CPDB 用户分配为任何调查的调查参与者。

显示参与者

显示调查参与者表中的条目列表，并允许用户：

• 对调查参与者排序；
• 筛选调查参与者；
• 对单个条目执行特定操作；
• 对多个条目执行特定操作。

调查参与者排序

表格的第二行包含多种条件，可帮助调查管理员对条目进行排序。如果您单击表格中的任意列/条件，屏幕将刷新，并按照您刚单击的条件显示排序后的调查参与者。再次单击可按降序显示结果。

筛选调查参与者

要筛选调查参与者，请选择要筛选的列，然后在所需列下方的空白框中输入要筛选的值/字符串。

例如，在电邮状态字段中输入 "OK"，即可仅返回电子邮件地址有效的参与者。

提示： 筛选调查参与者时，您也可以使用运算符（例如：>、<、>=、<=、=）。

  要筛选“邀请已发送”、“提醒邮件发送”和“调查已完成”列，请使用 "=N" 或 "<>N"，分别表示“等于否”和“不等于否”。

对单个条目执行特定操作

在操作列中，您可以找到调查参与者表中每个单独条目可用的所有操作。可执行的操作如下：

• 查看反馈详情： 如果该调查是“跟踪”调查（即非匿名调查），将会出现另一个按钮，允许您查看该条目对应的反馈；
• 使用此邀请码启动调查： 使用生成的邀请码来执行调查；
• 发送邮件邀请： 使用此选项向相应的参与者发送邮件邀请，邀请其完成调查；
• 编辑调查参与者： 点击以更改调查参与者数据；
• 删除问卷参与者： 点击以删除该条目；
• 在参与者中央数据库中查看此人: 如果相应条目也存在于参与者中央数据库中，将显示一个图标。

对多个条目执行特定操作

在表格的左下方，您会找到已选择的参与者...按钮，可用于批量执行某些操作：

• 发送邮件邀请： 向所选的调查参与者发送邮件邀请；
• 发送邮件提醒： 向所选的调查参与者发送邮件提醒；
• 添加参与者至核心数据库： 若要在其他调查中使用部分邀请码条目，请将所选参与者添加到参与者中央数据库。之后，您可以将这些参与者添加到任何您想要的调查中。更多详情，请继续阅读 分享参与者 wiki 页面。

在执行上述任何功能之前，请务必先选择要执行该操作的调查参与者。

创建...

若要在调查参与者表中列出更多参与者，您可以添加新参与者，或从 CSV 文件或 LDAP 查询中导入。

添加参与者

典型的邀请码条目包含以下字段：

• 识别号： 自动分配给每位调查参与者的整数；
• 完成？: 默认禁用。如果启用，将包含调查完成的日期。启用后，不会向相应用户发送邀请或提醒。如果相应的调查参与者使用其分配的邀请码完成了调查，则会自动启用；
• 名： 调查参与者的名；
• 姓： 调查参与者的姓；
• 操作代码： 这是邀请码。可以手动或自动生成（通过生成邀请码按钮）；
• 语言： 在此可以为相应参与者选择调查的默认语言；
• 电子邮件： 参与者的电子邮件地址；
• 电邮状态： 此字段可帮助您跟踪无效的电子邮件地址。例如，如果调查管理员收到了该电子邮件地址的错误通知，则可以将此字段设置为“确定”以外的任何值（例如“用户未知”或“邮箱配额已超出”）。将此字段标记为“确定”以外的电邮状态，有助于在发送邀请或提醒邮件时跳过该条目。请注意，这完全是手动操作，除非您决定实现一个自动更新此字段的脚本；
• 邀请已发送？： 如果启用，将包含邀请邮件发送的日期；
• 提醒邮件发送？： 如果启用，将包含提醒邮件发送的日期；
• 使用剩余： 统计邀请码可使用的次数。注意：对于已填写过调查的用户（此时使用剩余会被设置为 0），如果增大此值（默认 = 1），您还必须将已完成字段从“是”切换为“否”；
• 有效起始： 和 直到：您可以设置此邀请码可使用的日期/时间范围。如果不想限制某些用户的参与时间范围，可以将其留空。如果用户正在回答调查而参与时间结束，该用户将立即被锁定，无法完成调查。

请注意，添加调查参与者面板有两个选项卡：常规选项卡和其他属性选项卡。其他属性选项卡可让您访问自定义属性——更多详情，请阅读以下 wiki 章节。

创建演示参与者

如果您不想通过电子邮件向调查参与者发送邀请码，而是通过其他方式提供邀请码，可以使用演示参与者。例如，可以给进行课堂评价的学生发一张印有邀请码的纸，让他们在在线调查开始时输入。这样可以提高收到更多反馈和意见的可能性。

点击创建演示参与者，将显示以下页面：

通过参与者数量字段，您可以输入要添加到调查参与者表中的演示参与者数量。其他字段的说明可在 添加参与者 wiki 小节中找到。

在名、姓和邮件地址字段中，您可以使用占位符{COUNTER}，它会被替换为一个数字，每创建一个参与者该数字递增，从 0 开始。例如，user{COUNTER}@example.org 将创建电子邮件地址 user0@example.org、user1@example.org、user2@example.org，依此类推。

填写完字段后，请按屏幕右上方的保存。

要检查是否已添加成功，请查看调查参与者表：

导入 CSV 文件中的参与者

导入功能允许您从 CSV文件或 LDAP 查询中导入信息。

• 选择要上传的csv文件： 选择您要导入的 CSV 文件。为避免可能出现的错误，我们建议您导入标准的 CSV（逗号分隔）文件，数值两侧可带可选的双引号（OpenOffice 和 Excel 的默认格式）。

第一行必须包含字段名称。该行必须包含以下字段：firstname, lastname, email。

这些字段必须至少包含一个字符。仅添加双引号而其中没有任何字符是无效的！

其他字段为可选字段：emailstatus, token, language, validfrom, validuntil, attribute_1, attribute_2, attribute_3, usesleft, ... .

 Hint: 要获取完整的邀请码字段名称列表，请导出现有的调查参与者表。

 Hint: CSV 邀请码导入文件中 "validfrom" 和 "validuntil" 字段的日期格式为 "YYYY-MM-DD HH:MM"。

• 文件的字符集： 选择与 CSV 文件所用字符相符的选项；
• 使用的分隔符： 您可以让 LimeSurvey 自动检测 CSV 中使用的分隔符，也可以选择逗号或分号分隔符；
• 筛选空白邮件地址： 如果启用，没有电子邮件地址的调查参与者将不会被导入到调查参与者表中；
• 允许无效的电子邮件地址： 如果禁用，此功能将检查电子邮件地址字段，确认地址是否具有电子邮件的结构（例如：a@a.net）；
• 显示属性警告： 如果启用，导入完成后，若字段存在问题，将显示警告。例如，如果任何必填字段为空，或者 CSV 文件中的电子邮件填写有误，您可能会收到属性警告。

• 筛选重复记录： 如果启用，您可以设置使用哪些字段来识别重复项。默认情况下，预先选中名、姓和电子邮件地址。如果在导入时发现重复项，相关行将被忽略。

• 重复的记录取决于： 选择您要用于筛选重复项的字段。

导入 CSV 文件时，您还可以导入自定义属性。您需要定义要添加哪些属性，可以按如下方式操作：

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

请注意，导入之前您需要确保这些属性已存在于属性表中。

选择好所需的导入设置后，请不要忘记点击上传按钮。

调查参与者导入故障排除

用户在尝试导入邀请码时，常见的错误是 CSV 文件无效，这通常由微软Excel引起。许多用户将电子邮件地址列表保存为 XLS 文档。在 Excel 中可以将文件另存为 CSV。但是，根据操作系统的区域设置，微软Excel可能会使用分号（;）作为分隔符，而标准的 CSV 文件使用逗号（,）作为分隔符。如果您不知道使用的是哪一种，请用标准文本编辑器打开该文件，查看所使用的分隔符。

推荐的免费纯文本编辑器有：适用于 Windows 的 PSPad、NotePad2 或 Notepad++，以及适用于 Macintosh 的 TextWrangler。

LimeSurvey 也应能检测到分号作为分隔符。但是，如果导入过程无法正常工作，请将分号替换为逗号，并在数值两侧添加双引号。

导入 LDAP 查询中的参与者

  建议仅具备 LDAP 查询高级知识的用户使用此选项。

此导入功能允许您从 LDAP 查询中导入信息（已在 openLdap 上测试，但应适用于任何符合 LDAP 标准的目录，包括 ActiveDirectory）。从 LDAP 中导入调查参与者页面提供以下选项：

• 查询由系统管理员在 config-ldap.php 文件中手动定义。
• 重复项通过名、姓和电子邮件地址来识别。如果在导入时发现重复项，相关行将被忽略（除非您取消勾选了筛选重复项复选框）。

有关 LimeSurvey 中 LDAP 设置的更多详细信息，请阅读以下维基页面。

管理属性

此选项允许您添加/编辑调查参与者表的附加字段。这些额外字段用于存储自定义的调查参与者资料。

输入您要添加到调查参与者表中的新属性字段数量，然后点击添加字段按钮。将显示以下页面：

属性字段表包含以下字段:

• 属性字段: 当您需要对相应的自定义属性字段执行各种操作时,可以使用此处输入的值,例如基于属性字段应用条件,或为非匿名调查导出结果。
• 字段描述: 用于替换属性字段名称。为每个属性字段设置自定义名称后,它们在管理面板中、浏览邀请码时、基于属性字段创建条件时或为非匿名调查导出结果时会显示得更美观。
• 必填?: 如果启用,调查管理员必须填写相应的属性字段。否则,受访者将无法注册到调查参与者表中。
• 注册时显示?: 如果调查参与者必须在完成调查之前进行注册,系统会要求他们提供某些详细信息。如果禁用,相应的属性字段将不会显示在调查注册页面上。
• 字段标题: 使用此字段可添加有关相应属性字段的角色/用途的更多详细信息。
• CPBC映射: 对属性进行映射,以便将其与参与者中央数据库中对应的属性相关联。
• 示例数据: 包含不同字段的字符串示例。例如,如果您想询问调查参与者的性别,则会在示例数据字段中看到男、女、拒答等示例。

填写完所有框后,请不要忘记点击位于屏幕左下方的保存按钮。

有关如何添加其他属性字段以及如何基于这些值使用条件的详细说明,请参阅这篇博客文章:“基于邀请码属性的条件”。

要添加更多字段,请转到页面底部,在请输入您想添加属性字段的个数:框中输入所需数量,然后点击添加字段按钮。

如果您想删除自定义属性,请转到页面底部,在删除这个属性:字段下方的下拉列表中选择要删除的属性。选择后,点击删除属性并确认删除。

导出

要导出调查参与者表,请点击邀请码管理工具栏上的“导出”按钮。在导出调查参与者列表之前,请选择所需的导出选项。

• 问卷状态:
  • 所有邀请码: 导出调查参与者表中的所有调查参与者;
  • 已完成: 仅导出已完成调查的调查参与者;
  • 未完成: 导出尚未完成调查的调查参与者;
  • 未开始: 导出尚未开始调查的调查参与者;
  • 已开始但尚未完成: 导出已开始调查但尚未完成的调查参与者。
• 邀请状态: 根据邀请状态导出参与者:所有、已邀请和未邀请;
• 提醒邮件状态: 根据提醒状态导出参与者:所有、发送提醒邮件、未发送提醒邮件;
• 语种过滤: 创建调查时,除基础语言外,您还可以添加其他语言。这些附加语言可用于根据调查参与者所分配的语言导出参与者;
• 邮件地址过滤: 导出相应邮件地址中包含该字符串的条目。例如,如果您的某些调查参与者使用“A公司”的工作邮箱地址,您可以输入 @companya.com,仅导出收到该公司工作邮箱地址的用户;
• 删除导出的参与者: 如果启用,已导出的用户将从您的调查参与者表中删除。

选择好导出选项后,点击位于屏幕右上方的下载 CSV 文件按钮。

导出调查参与者时,字段将按以下顺序导出:

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

邀请和提醒

邀请和提醒允许您管理 LimeSurvey 的邀请系统。您可以向调查参与者表中显示的参与者发送邀请或提醒。邮件退信跟踪系统可帮助您跟踪并标记未送达收件人(调查参与者)的电子邮件。

发送邮件邀请

您可以在调查参与者表中向所有尚未收到邀请的参与者批量发送邮件邀请。

启用忽略邮件地址有误的邀请码选项,可以跳过电子邮件状态不是“确定”的调查参与者。

要忽略所有条目的有效期设置,请启用在发送电子邮件前忽略日期控制：功能。这样,LimeSurvey 的邮件功能将不会考虑允许使用邀请码的日期/时间范围。

重新发送邀请

使用此功能可再次向特定的调查参与者发送邀请。使用发送邀请功能时,只有以前未收到过邀请的邮件地址才会收到邀请。这意味着,如果您在首次发送邀请后向调查参与者列表中添加了新的邮件地址,那么第二次发送邀请时,只有这些新地址会收到邀请。

这也意味着,您可以编辑某个条目中曾收到退信的邮件地址,然后仅向这个编辑后的地址发送邀请。操作方法是关闭已发送邀请?字段,然后再次点击发送邀请。

发送邮件提醒

向调查参与者表中已收到首次邀请但尚未回复的所有参与者批量发送邮件提醒。

发送提醒时,您可以:

• 忽略邮件地址有误的邀请码: 邮件地址有误的条目将被跳过,不会收到电子邮件;
• 两次提醒之间的最少天数: 如果“最近”已发送过提醒,则跳过该邀请码;
• 最大提醒次数: 如果已发送的提醒次数达到给定数量,则跳过该邀请码;
• 在发送电子邮件前忽略日期控制: 跳过不在可使用时间范围内的条目。

注意: 仅会向“已完成”字段处于关闭状态的参与者发送提醒(这意味着受访者尚未参与或尚未完成调查)。

分批发送邮件

同时发送大量电子邮件时,LimeSurvey 只会发送前 N 封邮件的第一批(此阈值由管理员在 LimeSurvey 安装的全局设置中的邮件设置里设定)。

确认邮件

如果您使用邀请码，并且参与者填写了调查，系统会向其电子邮件地址发送一封确认邮件。

如果您不希望发送此邮件，请在调查的常规设置中停用此功能。

启用退信处理

发送电子邮件时，LimeSurvey 退信跟踪系统会自动在邮件标题中添加调查 ID 和邀请码 ID。这些“自定义标题”会被添加到通过您的 LimeSurvey 安装发送给调查参与者的每封邀请邮件中。当邮件被退回时，系统会收到原始标题以及“投递通知”标题。然后系统会检查新邮件，解析带有这些自定义标题的邮件，并在调查参与者表中标记有问题的电子邮件地址。

退信设置

退信设置选项：

有关各字段的简要说明，请查看以下 wiki 章节。要使用 LimeSurvey 安装的全局设置，请前往Used bounce settings并选择使用全局设定选项。

有关更深入的说明，请查看我们关于退信跟踪系统的 wiki。

有关如何正确配置此功能的更多信息，请点击以下链接。

编辑邮件模版

要了解可以使用哪些占位符，或如何编辑 LimeSurvey 邮件模版，请阅读我们的 wiki 章节邮件模版。

生成邀请码

借助此功能，可以为调查参与者表中所有尚未获得邀请码的条目创建唯一的邀请码。

在CPDB中查看

邀请码管理工具栏上的最后一个选项是在CPDB中查看。通过它，调查管理员可以查看同时存在于参与者中央数据库和调查参与者列表中的参与者。

在以下示例中，我们有如下调查参与者列表：

ID 为 1 和 2 的用户是从参与者中央数据库共享而来的。要进行检查，请转到调查参与者表管理工具栏并点击在CPDB中查看

如您所见，在CPDB中查看功能本质上是应用一个筛选条件，以确定 CPDB 中的哪些用户存在于相应的调查中。

删除表

要删除调查参与者表，请点击显示参与者按钮，然后在屏幕右上方找到删除参与者表按钮。

系统将弹出一个窗口，要求您进行最终确认。

请注意，这不会从您的 LimeSurvey 安装中删除该表，系统会创建一个备份。要访问该备份，您需要系统管理员权限。

如果您确实希望彻底删除它，请使用位于配置对话框中的检查数据整合性选项。

其他提示与技巧

您可以随意在下面的列表中添加任何提示和技巧。以下列出的内容由我们社区的成员发布：

• 允许公开注册
• 公开注册中的驗證碼
• 使用邀請碼的调查能否确保匿名反馈？
• 批量生成虚假电子邮件地址的技巧
• 垃圾邮件问题
• 假名化参与

允许公开注册

您还可以利用使用邀請碼时提供的受访者控制类型，向公众开放您的调查。为此，请初始化您的调查参与者表，并在调查的主要设置中选择允许公开注册。在没有邀請碼的情况下访问您调查 URL 的人将有机会进行注册。（此设置以后可以在调查设置菜单中的参与者设置部分进行更改。）

如果参与者提供的电子邮件地址不在当前数据库中，系统将在调查参与者表中创建一个条目，并向其发送包含其唯一邀請碼的邀请电子邮件。

公开注册中的驗證碼

为了保护您的调查免受机器人注册，可以对所有注册、保存和加载表单启用驗證碼功能。有关详细信息，请阅读我们的 wiki：参与者设置。

使用邀請碼的调查能否确保匿名反馈？

可以，邀請碼既可用于匿名调查，也可用于非匿名调查。这在创建调查时确定。如果调查不是匿名的（或称“跟踪式”），则可以使用邀請碼列表查找某个人对该调查的反馈。如果调查是匿名的，则调查参与者表中的受访者与其对应的答案之间不存在任何关联（技术上称为外键关系）。

要启用或禁用匿名反馈，请查看 wiki 中的参与者设置部分。

批量生成虚假电子邮件地址的技巧

有时您可能需要大量虚假的电子邮件地址和邀請碼。您可以使用电子表格（例如 OpenOffice Calc）中的函数来生成它们。假设您需要成千上万个形如 1@test.com、2@test.com、3@test.com 等的地址。在 A1 中输入“1”。在 A2 中插入函数 =A1+1，然后根据需要向下复制 A2 多次，以获得一列连续的数字。在 B1 中使用连接函数将 A1 与“@test.com”连接起来，即 =CONCATENATE(A1;"@test.com")。然后向下复制 B1，使每个 A 单元格都有对应的地址（您也可以用类似方法生成虚假姓名）。最后，将文件保存为 CSV 格式，以便将其导入 LimeSurvey。

自 LimeSurvey 1.91 发布以来，您可以使用“生成虚拟邀請碼”功能。但是，这些虚拟条目不包含任何电子邮件地址。

垃圾邮件问题

用户经常抱怨没有收到邀请或提醒电子邮件，原因是他们的电子邮件垃圾邮件过滤器将来自 LimeSurvey 的邮件识别为垃圾邮件。

一封电子邮件是否被视为垃圾邮件，主要取决于所使用的垃圾邮件过滤器及其设置。垃圾邮件过滤器通常会检查发件人地址以及电子邮件的主题和内容。更改其设置可能会解决用户的电子邮件提供商处理来自 LimeSurvey 邮件的问题。

LimeSurvey 会根据您登录 LimeSurvey 管理后台时所使用的 URL，自动尝试确定邀请链接的 URL。但是，在某些服务器配置不当的情况下，这可能无法正常工作，您将需要手动进行设置。

您可以编辑 "application/config/config.php" 来更改默认的基础 URL 值。如下所示，在现有的 'components' 阵列中添加 hostInfo 属性。

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

有关如何编辑 LimeSurvey 安装的配置文件的更多详细信息，请阅读我们的 wiki：LimeSurvey 可选设置。

关于问题的根源，LimeSurvey 会尝试从服务器 PHP 变量 $_SERVER['HTTP_HOST'] 或 $_SERVER['SERVER_NAME'] 中确定域名。

某些网页服务器软件似乎无法正确提供此信息，或者配置有误。

假名化参与

借助虚拟邀請碼，您可以实现一种假名化参与方式：导出创建的虚拟邀請碼，然后在外部将其与您的参与者列表合并。这样，LimeSurvey 即可作为调查平台使用，而无需将参与者的个人信息放入系统中。

唯一的缺点是，您需要自行分发参与邀請碼。