批量导入资产

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

还可以在批量导入程序中使用会话,一次性更新多个资产。有关详细信息,请参阅 批量更新现有资产

工作原理

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

上传的资产在哪里?

上传资产后,可在资产库存应用程序或 风险登记应用程序中使用数据。

工作流

权限

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

批量上传新资产

说明

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

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

  1. 打开启动面板

    说明

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

  2. 选择平台设置 > 组织

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

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

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

    注意

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

    说明

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

  4. 选择资源下的资源类型中,选择资产,然后选择资产类型

    根据选定的资产类型,模板将仅包含资产类型中已配置的那些字段。

  5. 单击下载 .xlsx 模板

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

准备模板中的数据

  1. 打开已下载的模板并转到资产工作表。

    Excel 模板与资产工作表的名称具有以下格式:

    • 模板:<资产类型名称> 资产导入程序表。例如,第三方资产导入程序表 (Third-party Asset Importer Sheet)。
    • 工作表:assetType-<资产类型 ID>。例如,assetType-1311013。
  2. 复制并粘贴或输入您的数据到模板。有关输入数据的帮助信息,请参阅准备内容的提示
    说明
    • 如果使用 Add-in(面向 Excel),请确保已禁用 ACL Add-In 选项。要了解如何操作,请参阅配置 Add-in(面向 Excel)
    • 请勿更改工作表或这些字段的名称。它们区分大小写,不得修改。
    • 一次最多可以上传 2000 行(包括所有工作表)。
    字段描述

    referenceId

    必须

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

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

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

    说明

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

    name

    必填

    指定资产名称。

    如果名称以方括号开头或者包含一个逗号、分号或换行符,请将该值放在双引号 (" ") 中。

  3. 根据要求填写其他字段。
    说明
    • 根据选定的资产类型,模板将仅包含资产类型中已配置的那些字段。
    • referenceIdname 是仅有的两个必填字段。其他红色标记的字段是有条件的必填项,资产进入工作流周期后,在特定的工作流状态下可能需要填写这些字段。
    • 如果字段值以方括号开头或包含一个逗号、分号或换行符,请将其放在双引号 (" ") 中。
    • 如果模板包含下拉字段,则下拉列表将只显示第一行的选项。若要获得更多行的这些选项,请复制第一行并将其粘贴到所需的行中。
  4. 保存并关闭模板。

准备内容的提示

准备内容包括:

  • 将源数据复制并粘贴到 Excel 模板
  • 根据具体情况,在 Excel 模板中输入数据
  • 保存模板以准备批量上传

上传数据

执行以下操作之一:

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

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

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

数据格式可能不正确

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

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

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

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

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

确保文件格式为 .xlsx

工作表名称无效。

请勿更改工作表的名称。

会话可能已过期。

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

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