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

此功能使您能够使用 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.

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

You can lower the limit using the Upload.Queues.MaxNumberOfItems app setting.

列映射

文件列标题	Orchestrator 字段
参考 对唯一参考队列为必需。 它支持所有特殊字符，但双引号 " 除外。	参考 References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
截止日期 如果使用，必须使用以下任一种格式填充日期： 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. 在“队列” 页面中，单击所需队列的相应“更多操作” 按钮，然后单击“上传项目” 。 系统将显示“上传项目” 窗口。

   

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

3. Click Open. If your file is compliant with the supported formatting rules, the upload operation is successful.

4. 选择“上传策略”：

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

5. Select the Dynamic typing checkbox if you want Orchestrator to interpret string characters in the CSV files as integer or boolean. This is recommended when uploading queue items to queues with schema definitions when it's required to match the schema definition. Leave it unselected, if you want strings to be interpreted as strings.

   

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

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

示例

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

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

Notice that this file contains 3 predefined columns, having the same name as in Orchestrator (Reference,Deadline, and Priority, highlighted in green) and 2 custom columns (Customer and Color, highlighted in red).

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

The Transactions page displays each item uploaded from your file. The information contained within the file's predefined columns is mapped to the columns with the same name in Orchestrator (Reference,Deadline, and Priority, highlighted in green):

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