此功能使您能够使用 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 个项目。您可以使用
Upload.Queues.MaxNumberOfItems应用程序设置降低此限制。
列映射
| File Column Header | Orchestrator Field |
|---|---|
| Reference Mandatory for unique reference queues. It supports all special characters, except double quotes - ". | Reference Note: References are not compatible with v2016.2 or lower versions of Orchestrator or Robot. |
| Deadline Must be populated with a date in one of the following formats: 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 | Deadline |
| Postpone Must be populated with a date in one of the following formats: 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 | Postpone |
| Priority Must be populated with one of the following values: Low or 1 Normal or 2 High or 3 If the priority is not specified in the file, the items are uploaded with a high priority, by default. | Priority Mapped to the following values, respectively: Low Normal High |
| [Custom_Name] The name can only be made of alphanumeric characters: 0-9, a-z, or underscores. | Specific Data Mapped in JSON format. For example: On-Us Check: 5540 |
Please note that you cannot have empty column headers in your file. More details about field descriptions are available here.
重要
预定义的列标题区分大小写，请确保遵循上述映射规则。 CSV 中名为
reference的列将映射到“特定数据” 部分，而不是“引用” 列。
上传策略
有两种处理上传的策略：
- “全部独立处理” - 单独处理所有项目，如果成功，则将其添加到队列中。 如果不是，则返回处理失败的列表。 您可以选择将列表下载到 CSV 文件中，该文件填充的字段与最初上传的文件中的字段相同。
- “全部或无”- 仅在所有项目都已成功处理时添加项目。否则，不添加任何项目。
动态输入
将队列项目上传到具有架构定义的队列时，有时您需要 Orchestrator 将字符串字符解释为整数或布尔值，以便匹配架构定义。
动态类型是一个选项，用于控制 Orchestrator 如何解析 .csv 中的字符串值 用于上传队列项目的文件。
Numeric data must conform to the definition of a decimal literal. Numerical values greater than 253 or less than -253 are not converted to Integer to preserve precision. Make sure to use the dot as a decimal separator and the comma as a thousand separator.
使用 CSV 文件上传队列项目
This section concerns adding items to a queue using a CSV file from Orchestrator. For details on how to add items through automation projects aka workflow design in Studio, see Managing queues in Studio.
- 在“队列” 页面中，单击所需队列的相应“更多操作” 按钮，然后单击“上传项目” 。 系统将显示“上传项目” 窗口。
- 单击“浏览”，然后选择所需的 CSV 文件。
- 单击“打开” 。 如果您的文件符合受支持的格式规则，则上传操作成功。
- 选择上传策略：
- 单独处理所有项目 - 如果成功，则单独处理所有项目并将其添加到队列中。 如果不是，则返回处理失败的列表。 您可以选择将列表下载到 CSV 文件中，该文件填充的字段与最初上传的文件中的字段相同
- “全部或全部” - 仅在成功处理所有项目时添加项目。 否则，不添加任何内容。
- 如果您希望 Orchestrator 将 CSV 文件中的字符串字符解释为整数或布尔值，请选中“动态输入”复选框。 当需要匹配架构定义时，建议在将队列项目上传到具有架构定义的队列时使用此方法。 阅读有关动态类型的更多信息。 如果您希望将字符串解释为字符串，请将其取消选中。
- 单击“上传”。系统会根据先前选择的策略将这些项目添加到您的队列中。
- 如果您使用了“单独处理所有项目” 选项并且存在未处理的项目，则“上传” 按钮将变为“下载”，使您能够下载包含未处理项目的 CSV 文件。
示例
假设您将以下 CSV 文件的内容上传到队列中。 创建此类文件的一种简单方法是将数据填充到 Excel 文件中，并将其另存为 CSV 文件：
Or you can download a CSV file with all the pre-filled column headers and customize it to your needs.
请注意，此文件包含 3 个预定义列，与 Orchestrator 中的名称相同（“引用”、“截止日期”和“优先级”，以绿色突出显示）和 2 个自定义列（“客户”和“颜色”，以红色突出显示）。
- 单击所需队列的“上传项目”，然后选择 CSV 文件。 Orchestrator 会解析文件以确认其符合格式规则。
- 选择所需的上传策略，然后单击“上传”以完成该过程。
- 选择“更多操作”>“查看事务”以查看上传的队列项目。
“事务”页面会显示从文件上传的每个项目。文件的预定义列中包含的信息将映射到 Orchestrator 中具有相同名称的列（“参考”、“截止日期”和“优先级”，并以绿色突出显示）：
自定义列中的信息以 JSON 格式映射到每个项目的“特定数据”部分。单击所需项目的“查看详细信息”以查看该项目：
约一个月前更新