使用 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	延期
优先级 如果使用，必须使用以下任一种格式填充日期： 低或 1 正常或 2 高或 3 如果未在文件中指定优先级，则默认情况下将以高优先级上传项目。	优先级 分别映射到以下值： 低 正常 高
[Custom_Name] 名称只能由字母数字字符组成：0-9、a-z 或下划线。	特定数据 以 JSON 格式映射。 例如： 银行内求偿支票：5540

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

注意：预定义的列标题区分大小写，请确保遵循上面的映射规则。reference 的 CSV 中的列将映射到特定数据部分，而不是参考列。

上传策略

有两种处理上传的策略：

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

动态输入

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

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

注意： 数字数据必须符合十进制文字的定义。 大于 2⁵³ 或小于 -2⁵³ 的数值不会转换为整数以保持精度。 确保使用点作为小数分隔符，使用逗号作为千位分隔符。

使用 CSV 文件上传队列项目

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

1. 在“队列”页面中，单击所需队列对应的“更多操作”按钮，然后单击“上传项目”。显示“上传项目”窗口。

   
   

   

   
   

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

   注意：无法使用事务 .CSV 文件将项目上传到队列。
3. 单击 “打开”。 如果您的文件符合 支持的格式规则，则上传操作成功。

4. 选择“上传策略”：

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

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

   
   

   

   
   
6. 单击“上传”。系统会根据先前选择的策略将这些项目添加到您的队列中。
7. 如果您使用了“独立处理全部”选项，并且有未处理的项目，则“上传”按钮将变为“下载”，单击该按钮可下载包含未处理项目的 CSV 文件。

示例

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

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

请注意，此文件包含 3 个预定义列（其名称与 Orchestrator 中的名称相同（“参考”、“截止日期”和“优先级”，并以绿色突出显示））和 2 个自定义列（“客户”和“颜色”，并以红色突出显示）。

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

“事务”页面会显示从文件上传的每个项目。文件的预定义列中包含的信息将映射到 Orchestrator 中具有相同名称的列（“参考”、“截止日期”和“优先级”，并以绿色突出显示）：

自定义列中的信息以 JSON 格式映射到每个项目的特定数据部分。单击所需项目的查看详细信息以查看该项目：