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

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

构建 .csv 文件时，可以使用一系列预定义的列标题，但也可以使用其他自定义标题。成功上传 CSV 文件后，具有预定义标题的列中包含的信息将映射到 Orchestrator 中找到的列。具有自定义标题的列中包含的信息位于 Orchestrator 中相应项目的“特定数据”部分下。在此处查看有关列映射的详细信息，并在此处查看示例。

备注：

上传限制为每个文件 15,000 个项目。您可以使用Upload.Queues.MaxNumberOfItems应用程序设置降低此限制。

列映射

文件列标题	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. 在“队列” 页面中，单击所需队列的相应“更多操作” 按钮，然后单击“上传项目” 。 系统将显示“上传项目” 窗口。

   图 1. 上传项目

   

2. 选择“浏览”，然后选择所需的 CSV 文件。

3. 选择“打开”（“项目” >“打开”）。如果您的文件符合支持的格式规则，则上传操作成功。

4. 选择 “上传策略”（上传策略） ：

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

5. 如果您希望 Orchestrator 将 CSV 文件中的字符串字符解释为整数或布尔值，请选中“动态输入”复选框。当需要匹配架构定义时，建议将队列项目上传到具有架构定义的队列。阅读有关动态类型 的更多信息。如果您希望将字符串解释为字符串，请将其取消选中。

   图 2. 动态输入

   

6. 单击“上传”。系统会根据先前选择的策略将这些项目添加到您的队列中。

7. 如果您使用了“单独处理所有项目” 选项并且存在未处理的项目，则“上传” 按钮将变为“下载”，使您能够下载包含未处理项目的 CSV 文件。

示例

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

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

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

图 3. CSV 文件

1. 单击所需队列的“上传项目”，然后选择 CSV 文件。 Orchestrator 会解析文件以确认其符合格式规则。
2. 选择所需的上传策略，然后单击“上传”以完成该过程。
3. 选择“更多操作”>“查看事务”以查看上传的队列项目。

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

图 4. “事务”页面

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

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