
Orchestrator 用户指南
Orchestrator 对象显示在其专用页面上的网格中,其中包含有助于描述该对象状态的各种列。
您可以导出这些网格,以获取一批数据,以便日后用于创建仪表板或报告。导出操作在后台进行,这意味着您可以继续与 Orchestrator 交互,而无需等待导出完成,因为系统会在下载准备就绪时通知您。
.csv,这使其符合数据分析要求,您可以从“我的报告”页面访问相关数据。
               单击“导出”按钮会在“我的报告”页面中创建网格的副本。导出开始以及完成或是否完成时,系统会弹出一个窗口通知您。
导出完成后,您会收到一条警示,告知您数据已导出。如果您具有“查看警示”权限,则系统会在后台自动将报告下载到浏览器的默认下载位置。但是,您也可以在方便时访问“我的报告”页面并下载报告。
“我的报告”页面仅显示您在过去 168 小时(7 天 x 24 小时)内创建的导出。超过 168 小时的导出将被永久删除。例如,在第 1 日 00:00 创建的导出文件在第 7 日 23:59 之前可用。
要查看导出的内容,请单击顶部导航栏上的“我的报告”图标。
您可以查看导出的以下属性:
- 导出类型 - 指的是 Orchestrator 对象
- 创建时间 - 创建导出时的相对时间戳
- 创建时间(绝对)- 创建导出时的确切时间戳。绝对时间戳以租户时区呈现。对于触发器,下一次运行时将在触发器时区呈现,该时区可能与租户时区不同。
- 
                     				有效期 - 从列表中删除导出的日期。系统会在指定日期的 00:00 删除报告。
                     这仅在导出报告后显示。 
- 大小 - 导出的大小。这仅在导出报告后显示。
- 
                     				
                     “状态”- 导出操作的状态: - 新建 - 正在执行导出。
- 已完成 - 导出已完成。
- 
                           						
                           失败 - 导出失败。这可能是由于 SQL 超时或存储空间不足。您需要手动重试导出。 解决导出问题的计算时间最长为 15 分钟。 在此时间之后,导出将失败。 在重试导出之前,请对数据应用其他筛选器。 重要提示:为防止包含大量数据的导出操作失败,请执行以下操作: - 您必须使用相应 Orchestrator 对象的 API 端点。例如,使用 /odata/AuditLogs/UiPath.Server.Configuration.OData.Export导出审核日志。
 - 就频率和检索数据量而言,生成的导出量可能会影响租户的性能。如果性能受到影响,我们可能会限制或阻止此类请求,以确保您的自动化不受此行为的影响。
 - 应用筛选条件以减少导出的数据量。
 
- 您必须使用相应 Orchestrator 对象的 API 端点。例如,使用 
 
.csv 文件。
               .zip 和 .csv 文件使用以下命名约定命名:
               | 导出的对象类型 | 下载文件命名约定 | 
|---|---|
| 队列事务 | {queue-name}-items-{export-date}-{export-timestamp}-{export-id} 如果队列名称包含无效字符 ( \ / : * ? " < > |),则将其替换为_。 | 
| 审核日志 | audit-logs-{export-date}-{export-timestamp}-{export-id} | 
| 日志 | robot-logs-{export-date}-{export-timestamp}-{export-id} | 
| 作业 | jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id} | 
其中:
- {queue_name} - 包含已导出队列项目的队列名称
- 
                     				
                     {job_folder_key} - 从中导出作业网格的文件夹 ID 
- {export_date} - 创建导出的日期,采用 yyyy-MM-dd格式
- {export_timestamp} - 创建导出的时间,格式为 HH-mm-ss-fff
- {export-id} - 导出的 ID
audit-logs-2023-01-27-12-29-40-843-24.zip。
               导出的报告中的时间列以租户的时区表示。
API 导出的重要注意事项
- 
                        					
                        不支持我们的导出 API 中的$select、$top、$skip、$orderBy, and关键字,我们强烈建议您避免使用这些关键字。请使用适当的筛选条件。$count
- 
                        					
                        报告条目仅按Id排序,即$orderBy=Id。用于$orderBy关键字的任何其他参数都将被忽略。
- 
                        					
                        如要筛选$filter=结构,则仅允许使用表格中标记为可用的字段。
- 
                        					
                        如下表所述,使用任何不支持的字段将返回 400 错误。 
队列事务 API 导出支持的字段
下表列出了通过 API 导出队列事务生成报告中的可用字段,并指明是否允许对这些字段进行筛选。
| API 字段 | 导出的报告中的相应列 | 允许筛选 | 
|---|---|---|
| 
 | 不适用 |  | 
| 
 | 状态 |  | 
| 
 | 修订 |  | 
| 
 | 参考 |  | 
| 
 | 异常 |  | 
| 
 | 不适用 |  | 
| 
 | 截止日期 (绝对值) |  | 
| 
 | 优先级 |  | 
| 
 | 机器人 |  | 
| 
 | 不适用 |  | 
| 
 | 延期 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 已开始 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 已结束 (绝对值) |  | 
| 
 | 事务执行时间 |  | 
| 
 | 上级 ID |  | 
| 
 | AncestorUniqueKey |  | 
| 
 | 重试次数 |  | 
| 
 | 手动上级 ID |  | 
| 
 | 手动上级唯一密钥 |  | 
| 
 | 手动重试次数 |  | 
| 
 | UniqueKey |  | 
| 
 | 特定数据 |  | 
| 
 | 密钥 |  | 
| 
 | 审核人姓名 |  | 
| 
 | 异常原因 |  | 
| 
 | 输出 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 分析数据 |  | 
| 
 | 不适用 |  | 
| CreationTimeAbs | 已创建 (绝对值) |  | 
| Progress | 进度 |  | 
| 
 | ID |  | 
审核日志 API 导出支持的字段
下表列出了通过 API 导出审核日志生成报告中的可用字段,并指明是否允许对这些字段进行筛选。
| API 字段 | 导出的报告中的相应列 | 允许筛选 | 
|---|---|---|
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 操作 |  | 
| 
 | 组件 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 操作 |  | 
| 
 | 时间 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 用户 |  | 
支持机器人日志 API 导出的字段
下表列出了通过用 API 导出机器人日志而生成的报告中的可用字段,并指明是否允许对这些字段进行筛选。
| API 字段 | 导出的报告中的相应列 | 允许筛选 | 
|---|---|---|
| 
 | 不适用 |  | 
| 
 | 时间 (绝对值) |  | 
| 
 | 级别 |  | 
| 
 | 流程 |  | 
| 
 | 主机名 |  | 
| 
 | 主机身份 |  | 
| 
 | 消息 |  | 
| 
 | 不适用 |  | 
| 
 | 机器人名称 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
支持作业 API 导出的字段
| API 字段 | 导出的报告中的相应列 | 允许筛选 | 
|---|---|---|
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 状态 |  | 
| 
 | 优先级 |  | 
| 
 | 主机名 |  | 
| 
 | 主机身份 |  | 
| 
 | 计算机 |  | 
| 
 | 密钥 |  | 
| 
 | 不适用 |  | 
| 
 | 流程 |  | 
| 
 | 机器人 |  | 
| 
 | 不适用 |  | 
| 
 | 环境 |  | 
| 
 | 作业类型 |  | 
| 
 | Runtime 类型/许可证 |  | 
| 
 | 不适用 |  | 
| 
 | 已开始 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 已结束 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 来源 |  | 
| 
 | 已创建 (绝对值) |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  | 
| 
 | 不适用 |  |