批量导入调查问卷

如果想要避免耗时的手动数据输入,可以批量导入调查问卷。

还可以在批量导入程序中使用会话,一次性更新多个调查问卷

工作原理

打开一个新的批量导入程序会话,然后从启动面板中的批量导入程序页面下载 Excel 模板。在模板中准备好数据之后,即可在批量导入程序页面上传模板。

可以批量导入哪些调查问卷组件?

结果应用程序中的调查问卷包含与多个组件的链接。

  • 集合 集合包含调查问卷。
  • 调查问卷 调查问卷包含不同类型的项目(问题、章节和分页符)。

使用批量导入程序,您可以在单次上传时导入所有组件(集合、调查问卷、问题、章节等)。每个组件都有自己的工作表。您可以填写所需组件的工作表并上传模板。

下表显示了可批量导入的组件列表。

组件类型 描述

集合

集合是组织结果数据的容器。关于集合的更多信息

调查问卷

调查问卷被用于收集受访者的信息以及为数据提供情境。关于调查问卷的更多信息

简单问题

包含问题类型:段落、附件、文本、电子邮件、数值、数据、数字签名。

数值问题

包含数值量表的问题,例如:0 到 10。

选择题

多选题。

环节

用于组织调查问卷内容的布局项。可添加标题来创建章节。

分页符

用于组织调查问卷内容的布局项。可添加分页符来划分调查问卷。

有关调查问卷组件的更多信息,请参阅调查问卷组成部分

已上传的组件在哪里?

上传调查问卷组件后,数据在结果应用程序中可用。

权限

只有系统管理员才能从批量导入程序批量上传 Diligent One 资源。

批量上传调查问卷组件

说明

  • 界面术语均可自定义,而且字段和选项卡均可配置。在 Diligent One 实例中,某些术语、字段和选项卡可能有所不同。
  • 如果必填字段留空,您会看到一则警告消息:此字段是必填项。某些自定义字段可能包含默认值。

打开一个新的批量导入程序会话并下载 Excel 模板

  1. 打开启动面板

    说明

    如果贵公司在启动面板中使用多个实例,请确保相应的实例处于活动状态。

  2. 选择平台设置 > 组织

    如果您没有看到组织选项,则表明您用于登录的账户没有管理员权限。

  3. 批量导入程序下,单击管理批量资源

    开启一个新的批量导入程序会话,其中会话 ID 已附加到 URL。

    注意

    请始终开启新会话以添加新资源,否则您可能会丢失之前已上传的数据。

    说明

    您可以使用之前的会话来更新之前上传的数据。要了解更多信息,请参阅批量导入程序中的更新功能

  4. 在资源类型的选择资源下,选择调查问卷

  5. 单击下载 .xlsx 模板

    Excel 模板会保存到您的本地计算机。

准备模板中的数据

  1. 打开已下载的模板 (HighBond_Template_Questionnaires.xlsx)。
    说明
    • 如果使用 Add-in(面向 Excel),请确保在修改 Excel 模板之前已禁用 ACL Add-In 选项。要了解如何操作,请参阅配置 Add-in(面向 Excel)
    • 请勿更改工作表或这些字段的名称。它们区分大小写,不得修改。
    • 一次最多可以上传 2000 行(包括所有工作表)。
    • 每份调查问卷最多可以包含 500 个问题(简单题、数值题、选择题),取决于调查问卷链接到的表中的现有列。例如,如果调查问卷链接到的表中有 100 列,则调查问卷不得超过 400 个问题。
  2. 转到所需的工作表并输入数据。

    有关每个工作表中字段的信息,请单击下面的链接。

    有关输入数据的帮助信息,请参阅准备内容的提示

  3. 保存并关闭模板。

调查问卷模板中的字段

以下部分包含有关每个工作表中字段的信息。

集合工作表 (Collections worksheet)

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

name

必须

指定集合名称。

description

指定集合的详细描述。

提示

使用 HTML 标签设置文本格式。例如:<b>、<i>、<ol> 和 <ul>。

type

指定集合的类型。

  • RegularProject
  • AssessmentProject

默认设置是 RegularProject。

调查问卷工作表
先决条件:需要拥有集合,才能创建调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

collectionId

必须

指定要将此调查问卷添加到的集合 ID。

导航到结果集合后,可以在 URL 中找到集合 ID。

例如:

https://stark.results.highbond.com/
projects/135614
,其中的 135614 是集合 ID。

或者,也可以在这个字段中提供已添加到当前模板的新集合参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

name

必须

指定调查问卷名称。

instruction

指定将会收到调查问卷的人员的说明。

position

指定集合中的调查问卷顺序。

resubmittable

指定在不提供解释性注释的情况下,人们是否可以提交对之前分配的调查问卷的更新回答。

  • True:是,允许重新提交。
  • False:否,不允许重新提交。

默认是 false。

respondentView

指定受访者可以查看哪些关于记录的信息。

  • all_records:显示所有的记录字段。
  • select_records:显示选定的记录字段。
  • no_records:不显示任何字段。

默认设置是 all_records。

emailSubject

指定发送调查问卷时,向受访者发送电子邮件通知的主题。

emailMessage

指定发送调查问卷时,向受访者发送电子邮件通知的内容。

linkedTablesIds

指定链接到此调查问卷的表 ID。

linkedTablesOnly

指定是否仅允许从链接到此调查问卷的表发送此调查问卷。

  • True:仅允许从链接的表发送此调查问卷。
  • False:可以从链接的表或非链接的表发送此调查问卷。

默认是 false。

weighting

指定调查问卷是否支持加权问题和答案。

  • True:支持加权问题和答案。
  • False:不支持加权问题和答案。

参考

为集合中的调查问卷、调查问卷中的问题,以及选择题中的答案选项指定唯一标识符。

locale

指定调查问卷中系统标签和按钮的语言。

语言必须是以下选项之一:

  • en: 英语
  • de: 德语
  • es: 西班牙语
  • fr: 法语
  • pt: 葡萄牙语
  • ja: 日语
  • zh: 汉语
  • el: 希腊语
  • it: 意大利语
  • pl: 波兰语
  • ro: 罗马尼亚语
  • ru: 俄语
  • uk: 乌克兰语

简单题工作表
先决条件:在开始添加问题之前,需要有一份调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

questionnaireId

必须

指定要将此问题添加到的调查问卷 ID。

导航到调查问卷后,便可在 URL 中找到调查问卷 ID。

例如:

https://stark.results.highbond.com/
projects/135614/questionnaires/448632
,其中的 448632 是调查问卷 ID。

或者,也可以在这个字段中提供已添加到当前模板的新调查问卷参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

文本

必须

指定问题的主要文本。例如:公司名称是什么?

instructions

指定回答问题的说明。

columnText

指定链接的表中的列显示名称。

可选

指定问题是否为选答题。

  • True:选答题。
  • False:必答题。

默认是 false。

itemType

必须

指定调查问卷项目的类型。

项目类型必须为以下之一:

  • ParagraphTextQuestion
  • AttachmentQuestion
  • TextQuestion
  • EmailQuestion
  • NumericQuestion
  • DateQuestion
  • DigitalSignatureQuestion

position

指定调查问卷中的问题顺序。

有关详细信息,请参阅 位置字段有什么重要作用?

参考

指定调查问卷中简单题的唯一标识符。

respondentView

指定受访者可以查看哪些关于记录的信息。

  • all_records:显示所有的记录字段。
  • select_records:显示选定的记录字段。
  • no_records:不显示任何字段。

默认设置是 all_records。

weight

指定问题的重要性权重。

数值题工作表
先决条件:在开始添加问题之前,需要有一份调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

questionnaireId

必须

指定要将此问题添加到的调查问卷 ID。

导航到调查问卷后,便可在 URL 中找到调查问卷 ID。

例如:

https://stark.results.highbond.com/
projects/135614/questionnaires/448632
,其中的 448632 是调查问卷 ID。

或者,也可以在这个字段中提供已添加到当前模板的新调查问卷参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

文本

必须

指定问题的主要文本。

instructions

指定回答问题的说明。

columnText

指定链接的表中的列显示名称。

可选

指定问题是否为选答题。

  • True:选答题。
  • False:必答题。

默认是 false。

scaleStart

必须

指定数值范围的起点。例如,0 或 1。

scaleEnd

必须

指定数值范围的终点。例如,2 到 10。

labelLeft

指定数值范围低端的标签。

labelCenter

指定数值范围中端的标签。

labelRight

指定数值范围高端的标签。

position

指定调查问卷中的问题顺序。

有关详细信息,请参阅 位置字段有什么重要作用?

参考

指定调查问卷中数值范围问题的唯一标识符。

weight

指定问题的重要性权重。

选择题工作表
先决条件:在开始添加问题之前,需要有一份调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

questionnaireId

必须

指定要将此问题添加到的调查问卷 ID。

导航到调查问卷后,便可在 URL 中找到调查问卷 ID。

例如:

https://stark.results.highbond.com/
projects/135614/questionnaires/448632
,其中的 448632 是调查问卷 ID。

或者,也可以在这个字段中提供已添加到当前模板的新调查问卷参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

文本

必须

指定问题的主要文本。

instructions

指定回答问题的说明。

columnText

指定链接的表中的列显示名称。

可选

指定问题是否为选答题。

  • True:选答题。
  • False:必答题。

默认是 false。

itemType

必须

指定调查问卷项目的类型。

项目类型必须为以下之一:

  • SingleChoiceQuestion
  • MultipleChoiceQuestion
  • DropdownQuestion

position

指定调查问卷中的问题顺序。

有关详细信息,请参阅 位置字段有什么重要作用?

otherValue

指定后,如果可用选项不适用于他们,受访者可以输入其他答案。文本将用作此选项的标签。

参考

指定调查问卷中数值范围问题的唯一标识符。

weight

指定问题的重要性权重。

options_1_text

必须

指定选项 1 的文本。

同样,还可以添加选项 2、3 和 4 的文本。

options_1_
followUpQuestions

指定选择选项 1 时的跟进式问题。

同样,还可以添加选择了选项 2、3 和 4 时的跟进式问题。

options_1_
参考

指定选择题中选项 1 的唯一标识符。

同样,还可以添加选项 2、3 和 4 参考的唯一标识符。

options_1_
weight

指定选项 1 的重要性权重。

同样,还可以添加选项 2、3 和 4 的重要性权重。

章节工作表
先决条件:在开始添加章节之前,需要有一份调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

questionnaireId

必须

指定要将此问题添加到的调查问卷 ID。

导航到调查问卷后,便可在 URL 中找到调查问卷 ID。

例如:

https://stark.results.highbond.com/
projects/135614/questionnaires/448632
,其中的 448632 是调查问卷 ID。

或者,也可以在这个字段中提供已添加到当前模板的新调查问卷参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

name

必须

指定章节名称。

description

指定章节的详细描述。

position

指定调查问卷中的章节位置。

有关详细信息,请参阅 位置字段有什么重要作用?

参考

指定调查问卷中章节的唯一标识符。

分页符工作表
先决条件:在开始添加分页符之前,需要有一份调查问卷。

字段 描述

referenceId

必须

指定资源的唯一 ID。对于工作表中的每一行,该值必须是唯一的。

它可以包含文本和数字的组合,最大长度为 255 个字符。

此字段是模板中每行的主键。如果要再次更新此资源,则需要此键。

重要信息

您可以使用参考 ID 随时将资源彼此关联。例如,您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。具体操作方法就是:在必填字段中输入 referenceId,以此将项目与目标关联起来。

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

说明

使用批量导入程序添加或更新资源时,需要参考 ID。当您从 Diligent One 用户界面添加/更新资源时,参考 ID 不可用。

questionnaireId

必须

指定要将此问题添加到的调查问卷 ID。

导航到调查问卷后,便可在 URL 中找到调查问卷 ID。

例如:

https://stark.results.highbond.com/
projects/135614/questionnaires/448632
,其中的 448632 是调查问卷 ID。

或者,也可以在这个字段中提供已添加到当前模板的新调查问卷参考 ID

有关在批量导入程序中关联 Diligent One 资源的更多信息,请参阅使用参考 ID,关联批量导入程序中的资源

position

指定调查问卷中的分页符位置。

有关详细信息,请参阅 位置字段有什么重要作用?

参考

指定调查问卷中分页符的唯一标识符。

准备内容的提示

在每个工作表中手动添加许多调查问卷元素并跟踪这些元素的位置,这种做法比较繁琐。为简化操作,可以在 Microsoft Excel 中使用 VLOOKUP 函数,操作方法如下所述:

  1. 打开模板并转到 Instructions 工作表。
  2. 填写参考 ID、章节名称/问题文本、调查问卷项目类型以及位置,以此将所有调查问卷项目(简单问题、数值问题、章节、分页符等)添加到 Instructions 工作表。

  3. 调查问卷条目类型字段应用过滤器,以此来过滤问题。在这个示例中,我们将使用 SimpleQuestions
  4. 复制已过滤简单问题的参考 ID,并将其粘贴到 SimpleQuestions 工作表的 referenceID 字段。
  5. 使用 VLOOKUP 函数,将 Instructions 工作表中的下述字段值填充到 SimpleQuestions 工作表:章节名称/问题文本位置
    1. 要填充章节名称/问题文本,请将以下函数复制并粘贴到 SimpleQuestions 工作表的文本字段,然后按 Enter 键:

      =VLOOKUP(A2, Instructions!$A$3:$D$100, 2, FALSE)

    2. 要填充位置 ,请将以下函数复制并粘贴到 SimpleQuestions 工作表的位置字段,然后按 Enter 键:

      =VLOOKUP(A2, Instructions!$A$3:$D$100, 4, FALSE)

      ,其中 A2 包含参考 ID,Instructions!$A$3:$D$100 是在 100 行中查找值的查找范围,2 和 4 是列号(章节名称/问题文本与位置,FALSE 是指完全匹配。

    说明

    请根据调查问卷项目的数量,修改查找范围。例如:如果项目扩展为 200 行,则请将查找范围修改为 $A$3:$D$200

  6. 将函数拖动到所需的所有列。
  7. 对于其他工作表,请重复执行步骤 35。“数值问题与选择题 (Numeric Questions 与 Choice Questions)”工作表中的文本以及位置字段,“章节 (Sections)”工作表中的名称以及位置字段,“分页符 (Page Breaks)”工作表中的位置字段。
  8. 保存并关闭模板。

位置字段有什么重要作用?

调查问卷包含许多元素,具体有:

  • 问题包括简单问题、数值问题以及选择题。
  • 章节用于组织调查问卷内容的布局项。
  • 分页符用于组织调查问卷内容的布局项。

以有序的方式组织这些元素,呈现调查问卷的合理结构,这一点非常重要。例如,调查问卷从某个章节开始,接着列出一些问题,然后可能会出现一个分页符。

为帮助组织这些元素,每个工作表都包含一个名为位置的字段。借助这个字段,可以为工作表中的每个项目分配一个数字,然后这些项目会按照分配的数字显示在调查问卷中(按升序)。

使用参考 ID 链接批量导入程序中的资源

参考 ID 是批量导入程序 Excel 模板中的一个字段。它是所有工作表中的第一个字段,可用于所有资源。它是工作表中每条记录的唯一标识符。

您可以使用参考 ID,随时将各种 Diligent One 资源彼此关联。例如,您可以在同一导入中创建一个项目,以及与该项目关联的目标。具体操作方法就是在必填字段中输入 referenceId

上传数据

执行以下操作之一:

  • 拖放模板到浏览器窗口。
  • 单击从计算机选择,从您的计算机选择更新的模板。

    一次只能上传一个 Excel 模板(每个文件单独验证)。

  • 结果根据进程的结果,将显示一条成功或失败消息,并在会话表中更新最新的会话

批量导入程序中的会话

批量导入程序中的会话是指导入 Diligent One 资源的一系列用户交互。每个用户会话都记录在会话表中。

会话表包含以下信息。

域名称

描述

Web 会话

显示 Web 会话列表。

Web 会话是指使用批量导入程序用户界面完成的会话。每次打开批量导入程序页面时,即会开启一个新会话

API 会话

显示 API 会话列表。

API 会话是指使用 Postman 等 API 平台完成的会话。

刷新

重新加载会话表。

会话 ID

会话标识符。

在 Web 会话中,您可以单击会话 ID 转到特定会话,且会话 ID 会附加到 URL。

例如:https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc,其中
bcc1e04e-4cd3-46d2-a8be-0b9083baccdc 是会话 ID。

说明

Web 会话 ID 与 API 会话 ID 看上去很相似,确保不要互换这两个 ID,以免出错。

日期

显示会话的日期和时间。您可以按升序或降序对日期进行排序。

上传者:

显示用户的名称。

状态

显示上传的状态(成功或失败)。

单击状态可查看完整的导入详情。

文件名

显示已上传的模板/错误日志的名称。例如:HighBond_Template.xlsxErrorLog.xlsx

模板您可以单击并下载模板,更正之前已上传的数据。

错误日志当上传失败时,系统会生成错误日志。您可以检查错误日志,更正错误并重新上传模板。

说明
  • 自上传之日起,模板和错误日志最多可供下载 18 个月。
  • 只有从 2022 年 5 月 13 日起的会话才提供下载模板的链接。您无法下载此日期之前的会话所关联的模板。

批量更新现有调查问卷

可以在批量导入程序中使用会话一次更新多项。

说明

只能更新使用批量导入程序上传的资源。

疑难解答

您可以从 Sessions 表下载并查看错误日志。了解常见的批量上传错误,并了解如何修复错误。

下表提供了上传模板时可能发生的错误报告。

错误 解决方案
上传文件中可能有超过 2000 行(包括所有工作表)。 从模板中删除多余的行并重新上传。
与调查问卷链接的表中可能有 500 多个列。 从模板中移除多余的列(通过移除一些问题),然后重新上传。
上传文件中的必填字段可能为空或缺失。 确保完成所有必填字段(在模板中用红色和橙色列名标记)。
说明

如果您没有在必填字段中提供数据,则不会处理该行。

数据格式可能不正确

确保文本字段中的数据有效,且不超过最大字段长度:255 个字符。

富文本字段对字符数没有限制。

数据值可能无效,或者可能与下拉列表值不匹配。

例如:请求工作表中的 receivedsendRecurrentNotifications 字段的值必须为 TrueFalse

模板中的字段无效。
  • 不要向模板添加新字段。
  • 不要从模板中移除字段。
模板可能没有使用预期的格式。

确保文件格式为 .xlsx

工作表名称无效。

请勿更改工作表的名称。

会话可能已过期。

请刷新页面并重新尝试上传。

会话 ID 可能无效。 请确保使用 Web 会话 ID。