在后台导出网格

概述

Orchestrator 对象显示在其专用页面上的网格中，其中包含有助于描述该对象状态的各种列。

您可以导出这些网格，以获取一批数据，以便日后用于创建仪表板或报告。导出操作在后台进行，这意味着您可以继续与 Orchestrator 交互，而无需等待导出完成，因为系统会在下载准备就绪时通知您。

下载格式为 .csv，这使其符合数据分析要求，您可以从“我的报告”页面访问相关数据。

可导出的 Orchestrator 对象

您可以导出以下 Orchestrator 对象的网格：

• 在租户级别
  • 审核日志
  • 测试自动化审核日志
• 在文件夹级别
  • 队列事务
  • 日志
  • 作业

备注：

对于审核日志、队列事务、日志和作业，每个租户每天最多只能导出 100 次。

一旦超过该限制，系统将显示 #4502 错误，指出已达到每个租户的每日限制。

此限制将在 00:00 UTC 重置。

导出的报告

单击“导出”按钮会在“我的报告”页面中创建网格的副本。导出开始以及完成或是否完成时，系统会弹出一个窗口通知您。

导出完成后，您会收到一条警示，告知您数据已导出。如果您具有“查看警示”权限，则系统会在后台自动将报告下载到浏览器的默认下载位置。但是，您也可以在方便时访问“我的报告”页面并下载报告。

“我的报告”页面仅显示您在过去 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 导出审核日志。

    • 就频率和检索数据量而言，生成的导出量可能会影响租户的性能。如果性能受到影响，我们可能会限制或阻止此类请求，以确保您的自动化不受此行为的影响。

    • 应用筛选条件以减少导出的数据量。

要将数据下载到您的设备，请单击所需报告的“下载”按钮。此操作使用设备上的默认下载位置。报告将作为存档下载，其中包含网格筛选数据的 .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 字段	导出的报告中的相应列	允许筛选
QueueDefinitionId	不适用
Status	状态
ReviewStatus	修订
Reference	参考
ProcessingExceptionType	异常
DueDate	不适用
DueDateAbs	截止日期 (绝对值)
Priority	优先级
RobotName	机器人
DeferDate	不适用
DeferDateAbs	延期 (绝对值)
StartProcessing	不适用
StartProcessingAbs	已开始 (绝对值)
EndProcessing	不适用
EndProcessingAbs	已结束 (绝对值)
SecondsInPreviousAttempts	事务执行时间
AncestorId	上级 ID
AncestorUniqueKey	AncestorUniqueKey
RetryNumber	重试次数
ManualAncestorId	手动上级 ID
ManualAncestorUniqueKey	手动上级唯一密钥
ManualRetryNumber	手动重试次数
UniqueKey	UniqueKey
SpecificData	特定数据
Key	密钥
ReviewerName	审核人姓名
ProcessingExceptionReason	异常原因
Output	输出
RobotId	不适用
ReviewerUserId	不适用
Analytics	分析数据
CreationTime	不适用
CreationTimeAbs	已创建 (绝对值)
Progress	进度
Id	ID

审核日志 API 导出支持的字段

下表列出了通过 API 导出审核日志生成报告中的可用字段，并指明是否允许对这些字段进行筛选。

API 字段	导出的报告中的相应列	允许筛选
Parameter	不适用
DisplayName	不适用
Action	操作
Component	组件
UserId	不适用
ExecutionTime	不适用
OperationText	操作
ExecutionTimeAbs	时间 (绝对值)
ServiceName	不适用
MethodName	不适用
EntityId	不适用
UserType	不适用
UserIsDeleted	不适用
ExternalClientId	不适用
UserName	用户

支持机器人日志 API 导出的字段

下表列出了通过用 API 导出机器人日志而生成的报告中的可用字段，并指明是否允许对这些字段进行筛选。

API 字段	导出的报告中的相应列	允许筛选
JobKey	不适用
TimeStamp	时间 (绝对值)
Level	级别
ProcessName	流程
HostMachineName	主机名
WindowsIdentity	主机身份
Message	消息
RawMessage	不适用
RobotName	机器人名称
MachineId	不适用
MachineKey	不适用
RuntimeType	不适用

支持作业 API 导出的字段

API 字段	导出的报告中的相应列	允许筛选
CreationTime	不适用
SourceType	不适用
State	状态
SpecificPriorityValue	优先级
HostMachineName	主机名
LocalSystemAccount	主机身份
MachineName	计算机
Key	密钥
JobPriority	不适用
ReleaseName	流程
RobotName	机器人
MachineScope	不适用
EnvironmentName	环境
Type	作业类型
RuntimeType	Runtime 类型/许可证
StartTime	不适用
StartTimeAbs	已开始 (绝对值)
EndTime	不适用
EndTimeAbs	已结束 (绝对值)
ProcessType	不适用
Source	来源
CreationTimeAbs	已创建 (绝对值)
ServerlessJobType	不适用
StartingScheduleId	不适用
Release	不适用
Machine	不适用
Robot	不适用