批量导入 框架

如果需要避免耗时的手动数据输入或者需要从其他系统迁移数据，请批量导入 框架。

您还可以在批量导入程序中使用会话一次更新多个 框架。有关详细信息，请参阅 。

工作原理

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

已上传的 框架 在哪里？

上传 框架 后，数据可在以下位置中获得：

框架 应用程序

工作流

权限

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

批量上传新 框架

说明

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

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

  1. 打开 平台主页 页面 (www.diligentoneplatform.com)。

    说明

    如果您的公司在 平台主页 页面中使用多个实例，请确保相应的实例处于活动状态。

  2. 选择 平台设置，然后在组织管理下选择组织。

  3. 在出现的页面上，单击批量导入程序部分中的管理批量资源。

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

    注意

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

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

    说明

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

  4. 在选择资源下的资源类型中，选择以下选项之一：

    • 框架 > 项目类型按项目类型创建 框架。选用动态模板，它包含选定 项目 的内置配置。使用此选项，您可以根据 项目 类型创建多个 Diligent One 资源（项目、框架、目标、风险、控制和缓解措施）。
    • 所有资源若要一次性批量导入所有资源：项目、框架、目标、风险、控制、缓解措施、问题、操作、请求、实体和合规映射。选用静态模板，可能需要花一些时间才能完成，因为用户必须手动解决资源的配置问题。
      • 说明

      Excel 模板根据所选资源和组织配置动态生成。因此，根据具体的配置，模板中包含的属性、字段和必填列可能会有所不同。

  5. 单击下载 .xlsx 模板。

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

准备模板中的数据

  1. 打开已下载的模板并转到 Frameworks 工作表。如果是动态模板，则工作表的名称由资源及其 项目 类型 ID 组合而成。例如：Frameworks-85692。
  2. 复制并粘贴或输入您的数据到模板。有关输入数据的帮助，请参阅准备内容的提示。
    说明
    • 如果使用 Add-in（面向 Excel），请确保已禁用 ACL Add-In 选项。要了解如何操作，请参阅配置 Add-in（面向 Excel）。
    • 请勿更改工作表或这些字段的名称。它们区分大小写，不得修改。
    • 一次最多可以上传 2000 行（包括所有工作表）。
    域描述

    referenceId

    必须

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

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

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

    重要信息

    您可以使用参考 ID 随时将资源彼此关联。例如，您可以在同一次上传中创建一个新 项目 和一个与该 项目 相关联的新 目标。您可以通过在必填字段中提供 referenceId，在 项目 和 目标 之间创建链接来实现此目的。

    要详细了解如何在批量导入程序中关联 Diligent One 资源，请参阅使用参考 ID 链接批量导入程序中的资源。

    说明

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

    名称

    必须

    指定 框架 的描述性名称。

    最大长度为 120 个字符。

    有关 框架 的信息，请参阅使用 框架 管理信息。

    描述

    指定 框架 的详细描述。

    提示

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

    背景

    指定 框架 的上下文背景。

    目的

    指定 框架 的预期结果、意图或目标。

    projectTypeId

    必须

    （仅限静态模板）

    指定与 框架 相关联的项目类型。

    当导航到项目类型时，该项目类型 ID 在 URL 中可用。

    例如：

    https://stark.projects.diligentoneplatform.com/
    audit_types/36245/description    ，其中 36245 是项目类型 ID。

    有关详细信息，请参阅工作流和 项目 类型。

    范围

    指定 框架 所涵盖的内容

    风险保障

    指定 框架 的风险保障功能状态。

    • True：已启用。
    • False：已禁用。

    默认是 false。

    有关详细信息，请参阅开始使用风险保障。

    实体

    指定标记到 框架 项目的实体的实体 ID。

    导航到实体后，可以在 URL 中找到实体 ID。

    例如： 

    https://stark.projects.diligentoneplatform.com/
    auditable_entities/33055    ，其中 33055 是实体 ID。

    可以提供多个 ID，并用逗号将它们分隔开来 。

    说明

    或者，可以在这个字段中输入添加到当前模板的新实体的参考 ID。上传模板后，这会将 框架 与实体关联。

    要详细了解如何在批量导入程序中关联 Diligent One 资源，请参阅使用参考 ID 链接批量导入程序中的资源。

    要了解有关实体的详细信息，请参阅设置实体标签。

    文件夹名称

    指定 框架 的文件夹名称。

    customAttributes_1_term - customAttributes_n_term

    指定自定义属性字段 1 到 n。

    Excel 模板中的自定义属性取决于模板类型，具体如下所述：

    • 框架 > 项目类型：默认情况下，模板将包含在 项目 类型中定义的自定义属性字段。
    • 所有资源：必须手动检查并输入自定义属性字段，包括术语和值。模板会包含一对自定义属性术语和值，并且可以根据需要再添加九对。若要添加术语和值，请遵循相同的命名约定，即添加一个计数器，例如：customAttributes_2_term、customAttributes_2_value 等。

    项目、框架 及其组件的自定义属性在 项目 类型中定义。有关自定义属性的详细信息，请参阅自定义术语、字段和通知。

    customAttributes_1_value - customAttributes_n_value

    指定自定义属性值 1 到 n。

    Excel 模板中的自定义属性取决于模板类型，具体如下所述：

    • 框架 > 项目类型：默认情况下，模板将包含在 项目 类型中定义的自定义属性字段。
    • 所有资源：必须手动检查并输入自定义属性字段，包括术语和值。模板会包含一对自定义属性术语和值，并且可以根据需要再添加九对。若要添加术语和值，请遵循相同的命名约定，即添加一个计数器，例如：customAttributes_2_term、customAttributes_2_value 等。

    项目、框架 及其组件的自定义属性在 项目 类型中定义。有关自定义属性的详细信息，请参阅自定义术语、字段和通知。

    说明
    • 如果值以方括号开头或者包含一个逗号、分号或换行符，请将该值放在双引号 (" ") 中。
      例如："[2021]", "First, second asset", "This is important; this too"。
    • 对于多选字段，则可以使用逗号分隔每个值，通过这种方式来添加多个值。
    • 对于下拉列表或多选字段，请确保这些值与选项中提供的值完全相同。
    说明

    在动态模板中，对于下拉字段，下拉列表将只显示第一行的选项。若要获得更多行的这些选项，请复制第一行并将其粘贴到所需的行中。

  3. 保存并关闭模板。

关于准备内容的提示

准备内容包括：

  • 将源数据复制并粘贴到 Excel 模板
  • 适用时，在 Excel 模板中输入数据
  • 保存模板以准备批量上传

下表提供了您可以用来快速有效地在 Excel 模板中准备您的内容的大量提示。

任务步骤
在一个屏幕上同时查看模板以及您的源文档

Windows 用户：

按 Windows 键 + 右或左箭头。

Mac 用户：

拖动窗口以填充一半屏幕。

从您的模板中的多个单元格复制/粘贴数据
  1. 在 Excel 中，选择适当的单元格。
  2. 按下 CTRL + C。
  3. 单击您希望粘贴数据的适当单元格。
  4. 按下 CTRL + V 粘贴。
将数值或公式当作文本在 Excel 中，在公式数值之前插入一个撇号。
修改列宽或行高以自动适合您的数据
在 Excel，执行以下任一操作：
  • 选择您希望修改的列，双击所选列标题右侧的边界。
  • 选择您希望修改的行，双击所选行底部的边界。
输入连续的数值数据
  1. 在 Excel 中，在适当的单元格中输入该序列的第一个数字。
  2. 选择该单元格。
  3. 将光标移动到单元格的右下角，并拖动选中区域到序列应该结束的位置。
  4. 单击自动填充选项。
  5. 选择填充序列。
使用公式计算数据
  1. 在 Excel 中，单击适当的单元格。
  2. 在 fx 字段中输入您的公式。

    如下是一些常用公式：

    • SUM - 允许您累加两个或更多数值。

      示例：=SUM(A1:B5)

    • COUNT - 统计其中有数值的单元格数量。

      示例：=COUNT(A1:A10)

    • TRIM - 删除单元格中的任何空格，除了单词之间的单个空格。

      示例：=TRIM(A1)

    • LEN - 统计单元格中字符的数量。

      示例：=LEN(A1)

排序或过滤单个列中的数据
  1. 在 Excel 中，执行以下操作之一：
    1. 单击开始 > 排序和筛选。
    2. 单击数据 > 筛选。

      列标题有一个箭头与标题名称相邻。

  2. 导航到您要筛选的列并单击标题旁的箭头。

    排序和过滤窗口将打开。

  3. 如有需要，排序或过滤器列中的数据。

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

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

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

在导入过程中，可以使用参考 ID 将目标链接到风险和控制。

示例 1

场景

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

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

流程

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

然后，转到 Objectives 工作表，添加新的 目标 详细信息，并在 parentResourceId 字段中，粘贴您从 Projects 工作表复制的 referenceId。通过这种方式，您可以将新的 目标 关联到新的 项目。

结果

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

  • 此时将创建一个新的 项目。
  • 创建了一个新的 目标，并且将新的 目标 关联到了新的 项目。

示例 2

场景

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

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

流程

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

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

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

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

结果

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

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

上传数据

执行以下操作之一：

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

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

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

批量导入程序中的会话

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

会话表包含以下信息。

域名称

描述

Web 会话

显示 Web 会话列表。

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

API 会话

显示 API 会话列表。

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

刷新

重新加载会话表。

会话 ID

会话标识符。

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

例如：https://stark.bulkimporter.diligentoneplatform.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. 打开 平台主页 页面 (www.diligentoneplatform.com)。

    说明

    如果您的公司在 平台主页 页面中使用多个实例，请确保相应的实例处于活动状态。

  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 行（包括所有工作表）。从模板中删除多余的行并重新上传。
上传文件中的必填字段可能为空或缺失。确保完成所有必填字段（在模板中用红色和橙色列名标记）。
说明

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

数据格式可能不正确

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

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

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

例如：请求 (Requests) 工作表中的 received 和 sendRecurrentNotifications 字段的值必须为 True 或 False。

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

确保文件格式为 .xlsx。

工作表名称无效。

请勿更改工作表的名称。

会话可能已过期。

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

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