如果需要避免耗时的手动数据输入或者需要从其他系统迁移数据，请批量导入时间条目。
还可以在批量导入程序中使用会话，一次性更新多个时间条目。
工作原理
打开一个新的批量导入程序会话，然后从启动面板中的批量导入程序页面下载 Excel 模板。 在模板中准备好数据之后，即可在批量导入程序页面上传模板。
已上传的时间条目会在哪里？
上传时间条目之后，相关数据在以下应用程序中可用：
- 时间表应用程序
- 项目应用程序
工作流
说明
只有当您想要将时间条目与项目关联时，才需要创建项目。
权限
只有系统管理员才能从批量导入程序批量上传 Diligent One 资源。
批量上传新的时间条目
说明
- 界面术语均可自定义，而且字段和选项卡均可配置。 在 Diligent One 实例中，某些术语、字段和选项卡可能有所不同。
- 如果必填字段留空，您会看到一则警告消息：此字段是必填项。 某些自定义字段可能包含默认值。
打开一个新的批量导入程序会话并下载 Excel 模板
-
说明
如果贵公司在启动面板中使用多个实例，请确保相应的实例处于活动状态。
- 选择平台设置 > 组织。
如果您没有看到组织选项，则表明您用于登录的帐户没有管理员权限。
- 在批量导入程序下，单击管理批量资源。
开启一个新的批量导入程序会话，其中会话 ID 已附加到 URL。
说明您可以使用之前的会话来更新之前上传的数据。 要了解更多信息，请参阅批量导入程序中的更新功能。
-
在资源类型的选择资源下，选择所有资源。
- 单击下载 .xlsx 模板。
Excel 模板会保存到您的本地计算机。
了解详细信息准备模板中的数据
- 打开下载的模板 (HighBond_Template.xlsx)，然后转到 TimeEntries 工作表。
- 将您的数据复制并粘贴或输入到模板。有关输入数据的帮助信息，请参阅有关准备内容的提示。 说明
- 如果使用 Add-in（面向 Excel），请确保已禁用 ACL Add-In 选项。 要了解如何操作，请参阅配置 Add-in（面向 Excel）。
- 请勿更改工作表或这些字段的名称。 它们区分大小写，不得修改。
- 一次最多可以上传 2000 行（包括所有工作表）。
字段 描述 必须
指定资源的唯一 ID。 对于工作表中的每一行，该值必须是唯一的。
它可以包含文本和数字的组合，最大长度为 255 个字符。
此字段是模板中每行的主键。 如果要再次更新此资源，则需要此键。
重要信息
您可以使用参考 ID 随时将资源彼此关联。 例如，您可以在同一上传中创建一个新项目以及一个与该项目关联的新目标。 具体操作方法就是：在必填字段中输入 referenceId，以此将项目与目标关联起来。
有关在批量导入程序中关联 Diligent One 资源的更多信息，请参阅使用参考 ID，关联批量导入程序中的资源。
说明
使用批量导入程序添加或更新资源时，需要参考 ID。 当您从 Diligent One 用户界面添加/更新资源时，参考 ID 不可用。
日期
必须
指定时间条目的日期。
日期必须采用 YYYY-MM-DD 格式。
时间
必须
指定花费的时间（以小时为单位）。
单日内可以有多个时间条目，但总时数不得超过 24 小时。
clientDelay
指定是否延迟项目。
- True：延迟项目。
- False：项目按计划进行。
assignedUserId
指定分配给时间条目的用户。
description
指定时间条目的详细描述。
提示使用 HTML 标签设置文本格式。 例如：<b>、<i>、<ol> 和 <ul>。
position
指定时间条目在列表中的排列顺序。
目标 ID
有条件地必填
指定必须放置此时间条目的资源的 ID。
例如：项目的主页、计划或外勤工作选项卡等。
您可以在 URL 中找到资源 ID。
例如：
https://stark.projects.highbond.com/audits
/1494/time_entries，其中 1494 是项目 ID。说明
只需填写以下任一内容：
- 目标 ID 与目标类型：适用于与项目关联的时间条目。
- 类别 ID：适用于与非项目时间类别关联的时间条目。
目标类型
有条件地必填
指定必须放置此时间条目的组件类型。
目标类型必须是下列类型之一：
projectsnarrativesobjectiveswalkthrough_summariesproject_planningswalkthroughscontrol_testscontrol_test_plansproject_resultsproject_filesrisk_control_matricestesting_roundsriskscontrols
重要信息请使用上面提到的确切术语。
说明
请对此字段仅使用英语默认值。 批量导入程序尚不支持自定义英语值和本地化（非英语）值。
说明
只需填写以下任一内容：
- 目标 ID 与目标类型：适用于与项目关联的时间条目。
- 类别 ID：适用于与非项目时间类别关联的时间条目。
categoryId
有条件地必填
指定非项目时间类别的 ID。
在此字段中，您可以提供已添加到当前模板的新非项目时间类别的参考 ID。
说明
只需填写以下任一内容：
- 目标 ID 与目标类型：适用于与项目关联的时间条目。
- 类别 ID：适用于与非项目时间类别关联的时间条目。
- 保存并关闭模板。
准备内容的提示
准备内容包括：
- 将源数据复制并粘贴到 Excel 模板
- 根据具体情况，在 Excel 模板中输入数据
- 保存模板以准备批量上传
使用参考 ID 链接批量导入程序中的资源
参考 ID 是批量导入程序 Excel 模板中的一个字段。 它是所有工作表中的第一个字段，可用于所有资源。 它是工作表中每条记录的唯一标识符。
您可以使用参考 ID，随时将各种 Diligent One 资源彼此关联。 例如，您可以在同一导入中创建一个项目，以及与该项目关联的目标。 具体操作方法就是在必填字段中输入 referenceId。
上传数据
执行以下操作之一：
结果根据进程的结果，将显示一条成功或失败消息，并在会话表中更新最新的会话。
批量导入程序中的会话
批量导入程序中的会话是指导入 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，其中 说明
Web 会话 ID 与 API 会话 ID 看上去很相似，确保不要互换这两个 ID，以免出错。 |
|
日期 |
显示会话的日期和时间。 您可以按升序或降序对日期进行排序。 |
|
上传者： |
显示用户的名称。 |
|
状态 |
显示上传的状态（成功或失败）。 单击状态可查看完整的导入详情。 |
|
文件名 |
显示已上传的模板/错误日志的名称。例如：HighBond_Template.xlsx，ErrorLog.xlsx。 模板您可以单击并下载模板，更正之前已上传的数据。 错误日志当上传失败时，系统会生成错误日志。 您可以检查错误日志，更正错误并重新上传模板。 说明
|
批量更新现有时间条目
可以在批量导入程序中使用会话一次更新多项。
说明
只能更新使用批量导入程序上传的资源。
疑难解答
您可以从 Sessions 表下载并查看错误日志。 了解常见的批量上传错误，并了解如何修复错误。
下表提供了上传模板时可能发生的错误报告。
| 错误 | 解决方案 |
|---|---|
| 上传文件中可能有超过 2000 行（包括所有工作表）。 | 从模板中删除多余的行并重新上传。 |
| 上传文件中的必填字段可能为空或缺失。 | 确保完成所有必填字段（在模板中用红色和橙色列名标记）。 说明 如果您没有在必填字段中提供数据，则不会处理该行。 |
| 数据格式可能不正确 |
确保文本字段中的数据有效，且不超过最大字段长度：255 个字符。 富文本字段对字符数没有限制。 |
| 数据值可能无效，或者可能与下拉列表值不匹配。 |
例如：请求 (Requests) 工作表中的 received 和 sendRecurrentNotifications 字段的值必须为 True 或 False。 |
| 模板中的字段无效。 |
|
| 模板可能没有使用预期的格式。 |
确保文件格式为 .xlsx。 |
| 工作表名称无效。 |
请勿更改工作表的名称。 |
| 会话可能已过期。 |
请刷新页面并重新尝试上传。 |
| 会话 ID 可能无效。 | 请确保使用 Web 会话 ID。 |
