使用 CSV 文件批量上传队列项目

使用 CSV 文件将队列项目批量上传到 Orchestrator 队列。

此功能使您能够使用 CSV 文件将队列项目批量上传到 Orchestrator 中的特定队列。 为此，请首先将文件上传到特定队列的 Orchestrator 实例中。 成功处理文件后，系统会根据所选策略将包含的项目上传到队列中。 请注意，必须使用预定义的格式预先填充文件，以便上传操作成功。

There is a series of predefined column headers that you can use when building your CSV file, but you can also use other custom headers. After successfully uploading the CSV file, information contained in columns with predefined headers is mapped to columns as found in Orchestrator.

Information contained in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator. See detailed information about column mapping here and an example here.

备注：

上传限制为每个文件 15,000 个项目。

列映射

文件列标题	Orchestrator 字段
参考 对唯一参考队列为必需。 它支持所有特殊字符，但双引号 " 除外。	参考 注意：引用与 Orchestrator 或机器人的 v2016.2 或更低版本不兼容。
截止日期 如果使用，必须使用以下任一种格式填充日期： yyyy-MM-dd YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	截止日期
延期 如果使用，必须使用以下任一种格式填充日期： yyyy-MM-dd YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	延期
优先级 如果使用，必须使用以下任一种格式填充日期： Low or 1 Normal or 2 高或 3 如果未在文件中指定优先级，则默认情况下将以高优先级上传项目。	优先级 分别映射到以下值： 低 正常 高
[Custom_Name] 名称只能由字母数字字符组成：0-9、a-z 或下划线。	特定数据 以 JSON 格式映射。 例如： 银行内求偿支票：5540

请注意，文件中不能有空的列标题。

备注：

预定义的列标题区分大小写，请确保遵循上述映射规则。 CSV 中名为reference的列将映射到“特定数据” 部分，而不是“引用” 列。

上传策略

有两种处理上传的策略：

• “全部独立处理” - 单独处理所有项目，如果成功，则将其添加到队列中。 如果不是，则返回处理失败的列表。 您可以选择将列表下载到 CSV 文件中，该文件填充的字段与最初上传的文件中的字段相同。
• “全部或无”- 仅在所有项目都已成功处理时添加项目。否则，不添加任何项目。

动态输入

将队列项目上传到具有架构定义的队列时，有时您需要 Orchestrator 将字符串字符解释为整数或布尔值，以便匹配架构定义。

“动态类型”是一个选项，用于控制 Orchestrator 对 .csv 文件（用于上传队列项目）中的字符串值的解析方式。

备注：

数字数据必须符合十进制文字的定义。系统不会为保留精度而将大于 2 ⁵³或小于 -2 ⁵³的数值转换为“整数”。确保使用点作为小数分隔符，使用逗号作为千位分隔符。

使用 CSV 文件上传队列项目

本节介绍使用 Orchestrator 中的 CSV 文件将项目添加到队列中。

1. In the Queues page, Select the corresponding More Actions button for the desired queue, and then Upload Items. The Upload Items window is displayed.

图 1. 上传项目

2. 选择“浏览”，然后选择所需的 CSV 文件。
3. 选择“打开”（“项目” >“打开”）。如果您的文件符合支持的格式规则，则上传操作成功。
4. 选择 “上传策略”（上传策略） ：
   • 单独处理所有项目 - 如果成功，则单独处理所有项目并将其添加到队列中。 如果不是，则返回处理失败的列表。 您可以选择将列表下载到 CSV 文件中，该文件填充的字段与最初上传的文件中的字段相同
   • “全部或全部” - 仅在成功处理所有项目时添加项目。 否则，不添加任何内容。
5. 如果您希望 Orchestrator 将 CSV 文件中的字符串字符解释为整数或布尔值，请选中“动态输入”复选框。当需要匹配架构定义时，建议将队列项目上传到具有架构定义的队列。阅读有关动态类型 的更多信息。如果您希望将字符串解释为字符串，请将其取消选中。

图 2. 动态输入

6. Select Upload. The items are added to your queue according to the previously selected strategy.
7. 如果您使用了“单独处理所有项目” 选项并且存在未处理的项目，则“上传” 按钮将变为“下载”，使您能够下载包含未处理项目的 CSV 文件。

示例

假设您已将以下 CSV 文件的内容上传到队列。创建此类文件的一种简单方法是将数据填充到 Excel 文件中，并将其保存为 CSV 文件。

或者，您也可以下载具有所有预填充列标题的 CSV 文件，并根据需要自定义它。

请注意，此文件包含三个预定义列，与在 Orchestrator 中同名（“引用”、“截止时间”和“优先级”，以绿色突出显示）以及两个自定义列（“客户”和“颜色”，以红色突出显示）。

图 3. CSV 文件

1. Select Upload Items for the desired queue, and select the CSV file. Orchestrator parses the file to confirm it meets formatting rules.
2. Select the desired upload strategies and Select Upload to finish the process.
3. 选择“更多操作”>“查看事务”以查看上传的队列项目。

“事务”页面显示从您的文件中上传的每个项目。在文件预定义列中包含的信息会在 Orchestrator 中映射到同名列（以绿色突出显示的引用、截止时间和优先级）中。

图 4. “事务”页面

自定义列中的信息以 JSON 格式映射到每个项目的特定数据部分。选择所需项目的“查看详细信息”，以查看详细信息。

图 5. “详细信息”选项卡