批量导入调查问卷

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

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

工作原理

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

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

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

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

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

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

组件类型 描述

集合

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

调查问卷

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

简单问题

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

数值问题

包含数值量表的问题，例如：0 到 10。

选择题

多选题。

环节

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

分页符

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

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

已上传的组件在哪里？

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

权限

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

批量上传调查问卷组件

说明

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

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

  1. 打开启动面板。

    说明

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

  2. 选择平台设置 > 组织。

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

  3. 在批量导入程序下，单击管理批量资源。

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

    注意

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

    例如：您想要分两个批次 (100 + 100) 导入 200 个实体。 如果您在同一会话中先后上传这两个批次，则上传第二个批次后，第一个批次已上传的数据会被第二个批次的数据替换。 为避免出现这种数据丢失问题，请始终在一个会话中上传第一个批次，然后开启新会话上传另一个批次。 同样，可开启新会话来添加更多新资源。

    说明

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

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

  5. 单击下载 .xlsx 模板。

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

准备模板中的数据

  1. 打开已下载的模板 (HighBond_Template_Questionnaires.xlsx)。
    说明
    • 如果使用 Add-in（面向 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_
reference

指定选择题中选项 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 (referenceID)、章节名称/问题文本 (Section Name/Question text)、调查问卷项目类型 (Questionnaire Item Type) 以及位置 (Position)，以此将所有调查问卷项目（简单问题、数值问题、章节、分页符等）添加到 Instructions 工作表。

  3. 对Questionnaire Item Type字段应用过滤器，以此来过滤问题。 在这个示例中，我们将使用 SimpleQuestions。
  4. 复制已过滤简单问题的参考 ID，并将其粘贴到 SimpleQuestions 工作表的referenceID 字段。
  5. 使用 VLOOKUP 函数，将 Instructions 工作表中的下述字段值填充到 SimpleQuestions 工作表：Section Name/Question text 与 Position。

    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. 对于其他工作表，请重复执行步骤 3 至 5。 “数值问题与选择题 (Numeric Questions 与 Choice Questions)”工作表中的文本以及位置字段，“章节 (Sections)”工作表中的名称以及位置字段，“分页符 (Page Breaks)”工作表中的位置字段。
  8. 保存并关闭模板。

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

调查问卷包含许多元素，具体有：

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

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

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

示例

场景

您想要使用批量导入程序来添加调查问卷，操作方法如下所述：

  • 5 个简单问题
  • 5 个数值问题
  • 简单问题和数值问题的单独章节
  • 简单问题之后出现分页符

流程

下载并打开调查问卷模板，然后转到下列工作表，执行以下操作：

  • Sections：添加章节并在位置字段中输入 1。
  • SimpleQuestions：添加简单问题并在位置字段中输入 2 至 6。
  • PageBreaks：添加分页符并在位置字段中输入 7。
  • Sections：添加另一个章节并在位置字段中输入 8。
  • NumericQuestions：添加 5 个数值问题并在位置字段中输入 9 至 13。

结果

上传模板后，调查问卷将按以下顺序显示具体内容：

调查问卷从第一个章节开始，随后列出 5 个简单问题，然后是一个分页符。 在下一页中，第二个章节开始，随后列出 5 个数字问题。

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

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

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

示例 1

场景

想要使用批量导入程序，在单次上传中完成以下任务：

  • 创建一个新项目。
  • 创建一个新目标并将其关联到新项目。

流程

下载并打开 Excel 模板。 转到 Projects 工作表并填写所有必填字段，包括 referenceId。 复制新项目的 referenceId。

然后转到 Objectives 工作表，添加新目标详细信息，并将从 Projects 工作表复制的 referenceId 粘贴到 parentResourceId 字段中。 如此一来，便可以将新目标关联到新项目。

结果

上传模板后，会出现以下情况：

  • 创建一个新项目。
  • 创建一个新目标并将这个新目标关联到新项目。

示例 2

场景

想要使用批量导入程序，在单次上传中完成以下任务：

  • 创建 1 个新项目。
  • 创建 1 个新目标并将其关联到新项目。
  • 创建 2 个新风险和 2 项新控制，并将其关联到新目标。

流程

下载并打开 Excel 模板，转到 Projects 工作表，添加新项目详细信息，例如 referenceId 和其他必填字段。 复制新项目的 referenceId。

然后转到 Objectives 工作表，添加新目标，并将从 Projects 工作表复制的新项目 referenceId 粘贴到目标的 parentResourceId 字段中。 此时，可复制新目标的 referenceId。

然后转到 Risks 工作表，添加新风险，并将从 Objectives 工作表复制的新目标 referenceId 分别粘贴到每个风险的 objectiveId 字段。

最后转到 Controls 工作表，添加新控制，并将从 Objectives 工作表复制的新目标 referenceId 分别粘贴到每项控制的 objectiveId 字段。

结果

上传模板后，会出现以下情况：

  • 创建 1 个新项目。
  • 创建 1 个新目标并将其关联到新项目。
  • 创建 2 个新风险和 2 个新控制，并将其关联到新目标。

上传数据

执行以下操作之一：

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

    一次只能上传一个 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.xlsx，ErrorLog.xlsx。

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

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

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

批量更新现有调查问卷

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

说明

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

工作原理

从批量导入程序页打开上一个会话。 打开在上一个会话中上传的模板并进行所需的更改。 然后，在批量导入程序页面上传模板。

重要信息

  • 使用之前的会话进行更改或更正之前上传的数据。
  • 开始新会话以上传新资源，即使这些资源与之前上传的数据相关。

例如：您在之前的一个会话中上传了一个项目和几个目标。 打开同一个会话以更新这些资源。 如果要上传与该项目或目标相关的风险、控制或任何其他资源，请开始新会话。

更新前的要求

在更新之前，必须执行以下操作：

  1. 决定要选择的会话。 这是必需的，因为上传的数据链接到会话。 因此，必须打开链接到待更新数据的会话。 有关会话的信息，请参阅批量导入程序中的会话。

  2. 确保您有权访问待选择会话中上传的 Excel 模板。 该模板包含参考 ID，它们是该模板中各行的唯一标识符。 这些是更新数据所必需的。 有关参考 ID 的详细信息，请参阅准备模板中的数据。

    注意

    根据相应的会话和参考 ID 更新数据。 会话和参考 ID 之间不匹配可能会创建重复项或导致错误。

更新步骤

说明

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

打开上一个会话

说明

首次打开批量导入程序页面时，以前的会话将不可用。 必须至少上传一次才能查看会话详细信息。

有关会话的更多信息，请参阅批量导入程序中的会话。

  1. 打开启动面板。

    说明

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

  2. 选择平台设置 > 组织。

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

  3. 在批量导入程序下，单击管理批量资源。

  4. 向下滚动到会话部分，然后单击您选择的会话 ID。

    结果加载会话，同时所选会话 id 会附加到 URL。

    说明

    确保选择正确的会话，以便更新之前上传的数据。 会话和参考 ID 之间不匹配可能会创建重复项或导致错误。 有关详细信息，请参阅更新前的要求。

更新模板中的数据

  1. 打开在上一步选择的会话中上传的 Excel 模板。 此文件包含以前上传的数据以及参考 ID。 有关详细信息，请参阅更新前的要求。

    说明

    在修改 Excel 模板之前，请确保已禁用 ACL Add-In 选项，否则上传将失败。 有关 ACL Add-In 的详细信息，请参阅配置 Add-in（面向 Excel）。

  2. 转到相应的工作表并根据参考 ID 更新数据。 有关字段的详细信息，请参阅 准备模板中的数据

    说明

    确保更新与参考 ID 相对应的值，将根据这些值更新之前上传的数据。 不匹配可能会创建重复项或导致错误。

  3. 保存并关闭文件。

上传数据

执行以下操作之一：

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

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

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

疑难解答

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

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

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

如果您没有在必填字段中提供数据，则不会处理该行。
数据格式可能不正确

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

富文本字段对字符数没有限制。
数据值可能无效，或者可能与下拉列表值不匹配。

例如：请求 (Requests) 工作表中的 received 和 sendRecurrentNotifications 字段的值必须为 True 或 False。
模板中的字段无效。
  • 不要向模板添加新字段。
  • 不要从模板中移除字段。
模板可能没有使用预期的格式。

确保文件格式为 .xlsx。
工作表名称无效。

请勿更改工作表的名称。
会话可能已过期。

请刷新页面并重新尝试上传。
会话 ID 可能无效。 请确保使用 Web 会话 ID。