中央参与者数据库
From LimeSurvey Manual
介绍
访问此选项： "配置" -> "中央参与者数据库"：
此功能允许管理员将参与者信息存储在一个独立于任何调查参与者表的中央表中。其主要优点如下:
- 中央表可作为备份。用户创建新调查时,无需先将参与者导出为 CSV 文件,再导入到新调查中。
- 用户只需将参与者添加到中央表,之后即可将这些参与者添加到任意数量的调查中。
- 如果有多个用户访问同一个 LimeSurvey 安装,所有者可以选择与其他用户共享其参与者,并为被共享的用户设置访问权限。
在您的 LimeSurvey 安装中,您还可以找到高级的属性控制以及其他多种功能。
参与者面板管理工具
提供以下选项:
显示 CPDB 参与者
这是该面板的主要组成部分。大多数选项都可以从这里访问,例如添加、删除、导出参与者,以及将参与者添加到调查等。
表格中列出的每位参与者在操作列中都有五个可用选项:
添加参与者
单击窗口右上方的添加新参与者按钮:
。
随后将出现一个包含以下基本属性的对话框:
- 名字
- 姓氏
- 电子邮件
- 将用户加入黑名单
- 所有者:在用户管理页面中定义的任何 LimeSurvey 用户都可以成为所有者。
编辑参与者
要编辑参与者的基本属性和/或自定义属性,请单击操作列中的第一个按钮(从左到右)(
)。随后将显示包含所有可用属性的窗口。
删除参与者
您可以轻松删除一位或多位参与者:
- 如果要删除一位参与者,请找到该参与者所在的行,然后单击红色的垃圾桶按钮:
。 - 如果要删除两位或更多参与者,请先选中相应的条目,然后单击所选参与者...按钮(位于最后一行下方、操作列的下面):
。然后单击删除选项。
删除参与者时,有三个选项可供选择:
1) 仅从中央面板删除:第一个选项仅从中央参与者数据库中删除该参与者。如果该参与者位于任何调查参与者表中,则不会被移除。
2) 从中央面板及关联的调查中删除:第二个选项会从中央面板以及该参与者已被添加到的调查中删除该参与者,但不会删除其回答。
3) 从中央面板、关联的调查及所有关联的回答中删除:第三个选项会从系统中删除该参与者的所有痕迹,包括其回答。
注意 : 请注意,在这三种情况下,为保留参与者历史记录而创建的链接也会被一并删除。
共享参与者
这是中央参与者数据库的另一项重要功能。您可以与其他用户共享您的参与者。您只需选择要共享的参与者,然后点击绿色右箭头图标(
)或参与者表格左下方的所选参与者...按钮。随后会打开一个模态框,您可以在其中选择要与之共享相应参与者的用户。您还可以设置获得共享的用户是否可以编辑这些参与者。如果设置为否,则该用户在尝试编辑共享参与者的条目时会收到拒绝访问错误。
列出活动问卷
如果您点击下一个图标(
),将列出相应参与者已被添加到的所有活动问卷。
将参与者添加到问卷
点击操作列中的最后一个图标(
),即可将参与者添加到问卷。如果您希望将多个参与者添加到问卷,请勾选这些参与者,然后在所选参与者...对话框(位于中央表格左下方)中选择共享选项。
请注意,如果您希望将中央数据库中的参与者添加到问卷,相应问卷必须包含问卷参与者表!更多详情请继续阅读以下维基章节。对话框的标题会显示将要添加到相应问卷的参与者数量。此外,还有一个复选框,勾选后,系统将带您前往您要添加参与者的问卷的问卷参与者表。
点击“下一步”后,您将进入属性映射页面。
属性映射页面包含四个表格,并使用高级拖放功能:
- 第一个表格“Unmapped participant attributes”显示中央参与者数据库中存在的所有属性。这些属性目前尚未映射,即不存在于问卷参与者表中。这些未映射的属性可以移入“Token attributes to create”表格,从而在问卷参与者表中创建新属性;也可以将未映射的属性拖到“Existing token attributes”表格中您希望与之合并的现有令牌属性旁边,与现有令牌属性合并。
- 第二个表格“Token attributes to create”可帮助您将未映射的参与者属性复制到问卷参与者表中,并创建新列。拖动您希望添加到问卷参与者表的属性,并将其放入第二个表格。这样,新的列/属性就会添加到问卷参与者表中。
- 第三个表格“Existing token attributes”显示问卷参与者表中当前存在的属性。如果您希望将未映射属性中的数据复制到某个现有令牌属性中,请将未映射的属性放到此处(见下方截图)
- 第四个表格“Standard token fields”显示可与未映射的参与者属性合并的标准令牌字段。问卷参与者表中唯一可以编辑的标准令牌字段是令牌字段。例如,当您希望在不同的 LimeSurvey 安装之间轻松复制令牌代码时,这一点非常重要。
如果参与者已经存在,您还可以覆盖问卷参与者表中现有的令牌属性值。请谨慎使用此选项,以免丢失有关问卷受访者的重要数据。
映射完所有属性后,您可以点击继续。参与者处理完成后,将显示一个摘要页面,告知您成功复制了多少位参与者。如果您之前选择了跳转,则会被重定向到问卷参与者表,否则将被重定向到 CPDB 主页。
信息
显示CPDB统计信息:
1) 中央表中的参与者总数:位于中央参与者数据库中的参与者总数。
2) 您拥有的参与者:显示以您为所有者的参与者总数。默认情况下,录入中央参与者数据库的新参与者以最先添加他们的用户为所有者。
3) 与您共享的参与者:其他用户与您共享的参与者数量。
4) 您已共享的参与者:您与其他用户共享的参与者数量。
5) 黑名单参与者:被列入黑名单的参与者数量。
6) 中央表中的属性总数:中央表中的属性总数。
导入
如果您希望通过导入功能添加参与者,请点击中央参与者数据库页面主工具栏上的“导入”按钮:
提供以下选项:
请注意CSV 输入格式框中的说明:
必填字段:email
可选字段:firstname、lastname、blacklisted、language
导入步骤
1) 选择要导入的文件,并指定与其相关的设置。
2) 映射 CSV 文件中的属性。您可以将属性数据导入到中央参与者数据库中已有的属性,也可以通过创建新属性将其导入到新列。新创建的属性为文本框类型,之后可以更改其格式。
在上面的截图中,将创建一个名为“New Age”的新属性。属性“Sex”的数据已被映射并复制到中央参与者数据库中现有的“Sex”属性。
CSV文件中已存在于参与者中央数据库的参与者不会被再次导入。如果文件中包含 participant_id 列,则通过参与者ID查找已有参与者。否则,将在您拥有的参与者中,根据名、姓和邮件地址的组合进行查找。
新参与者的参与者ID取自 participant_id 列。该ID必须是 UUID(LimeSurvey 用于参与者ID的格式,例如 0a1b2c3d-4e5f-4071-8293-a4b5c6d7e8f9)。如果某些行将创建参与者ID为其他格式的新参与者,则这些行不会被导入,摘要中会列出这些行及其行号。如果该列为空,LimeSurvey 会创建新的参与者ID。参与者ID为旧格式(其他格式)的现有参与者仍可被找到并更新。 (New in 7.8.0 )
勾选Overwrite existing participant attribute values if a duplicate participant is found?可根据CSV文件更新这些已有参与者:更新其已映射属性的值、语言和黑名单状态。名、姓和邮件地址不会被导入更改。只有您有权编辑的参与者才会被更新。
3) 点击“继续”,并等待处理完成。处理结束后,将显示简短的摘要。
点击“确定”将跳转到参与者页面,并显示新导入的参与者。
黑名单设置
黑名单设置按钮位于中央参与者数据库页面的主工具栏上。点击后将显示以下页面。
提供以下“是/否”选项:
- 设置全局字段后,将参与者加入所有现有问卷的黑名单:如果设置为“是”,被列入黑名单的参与者将无法被添加到任何问卷。
- 设置全局字段后,将参与者加入所有新添加问卷的黑名单:创建新问卷时,相应的参与者将无法被添加到这些问卷(如果选择“是”)。但是,他们仍可被添加到之前创建的问卷。
- 允许将黑名单参与者添加到问卷:即使参与者已被列入黑名单,仍可将其添加到问卷。
- 隐藏黑名单参与者:当您希望在特定时间段内隐藏参与者,之后再将其提供给与之共享这些黑名单参与者的其他用户时,此功能非常有用。
- 从数据库中删除全局黑名单参与者:如果选择“是”,黑名单参与者将从数据库中删除。
- 允许参与者自行移出黑名单:如果选择“是”,参与者无需 LimeSurvey 用户的帮助即可自行移出黑名单。
属性
要访问属性管理面板,请点击 CPDB 主页面主工具栏上的属性按钮:
属性管理支持添加三种类型的属性:文本框、日期和下拉列表。要添加新属性,请点击窗口右上角的添加新属性:
添加新属性时,提供以下选项:
- 默认名称:如果没有提供其他英文名称,LimeSurvey 将使用它来命名该属性。
- 属性类型:您可以选择任意一种属性类型,编辑时将显示相应的用户界面。
- 此属性是否应在面板上可见?:可选择“是”或“否”。此功能决定该属性是否在 CPDB 表格中可见。之后可以在主属性表格的可见列中进行编辑。
- 语言:如果您不希望 LimeSurvey 使用默认名称作为属性名称,请在此处输入所需的名称。请注意,属性管理支持多语言。选择语言后,请点击加号。英文/默认语言下方将出现一个新字段。
完成更改后,请点击保存。
即使您只使用一种语言(基础语言),我们也建议您在相应的语言框中填写属性名称。原因在于:当您映射属性并希望将其添加到不同的问卷参与者表时,相应面板中不会显示属性的默认名称,只会显示您在相应语言框中填写的名称。在属性表格中,提供两种操作(见“操作”列):
点击第一个图标,将显示一个对话框,其中包含所选属性的基本设置,您可以根据需要进行编辑。
要从表格中删除属性,请点击位于编辑按钮旁边的红色垃圾桶按钮。点击删除按钮不仅会删除该属性,还会删除 CPDB 中与之关联的值。
共享面板
共享面板显示与共享参与者相关的所有信息。请注意,此面板仅显示该用户所拥有的共享参与者。
此面板显示以下值:
1) 姓
2) 名
3) 电子邮件地址
4) 共享者
5) 所有者
6) 添加日期
7) 可以编辑?
这些信息仅供查看/排序之用。用户只能编辑可以编辑字段。通过可以编辑字段,您可以决定是否允许与之共享该参与者的用户编辑该参与者。点击复选框将发起 AJAX 调用,并将更改保存到服务器。
导出参与者
导出功能位于中央参与者数据库页面的主工具栏上:
导出为 CSV 时,系统会显示一个对话框,要求您勾选要导出的属性。
您可以导出:
- 不导出任何附加属性
- 导出所有附加属性
- 导出部分附加属性
导出文件的格式为 CSV。
导出筛选后的参与者
要导出筛选后的参与者,请先使用搜索筛选器。然后,点击操作列左侧的复选框(以选中所有筛选出的参与者)。接着,点击表格右下方的所选参与者...按钮并选择导出功能。这样,将只导出筛选后的参与者。
搜索筛选器
如果您想筛选数据库中的用户,请使用每个列标题下方的搜索框/下拉框:
在搜索字段中输入信息,或(在可能的情况下)从下拉列表中进行选择,以列出筛选后您想要显示的参与者。
其他信息
更多(技术)信息请参阅 中央参与者数据库(用户面板)开发 wiki。