导出作业结果
JobResults 类型的导出进程包含所有作业的作业结果概览。
输出可以是 CSV 或 JSON 文件。
Info
已删除的作业结果不会列出。
除了 参数文件 部分中描述的密钥之外,参数文件还可以包含以下专门用于此次导出的密钥。
Common 节
在 [常用] 部分,可以配置以下密钥:
键 | 描述 | 值 |
---|---|---|
Dir | 要导出的 项目树 部分的相对路径。信息:如果为 ComponentID 指定了值,则此键将被忽略。 | - 无值:整个 项目树 将被导出,但不会导出执行用户无访问权限的目录和组件(默认值) - 条目以反斜杠(\)开头。也可以输入包含组件名称的完整路径。 |
过滤器节
在 [过滤器] 节,可以配置以下按键:
键 | 值 |
---|---|
FilterFrom | 根据该时间段的起始时间(UTC 格式时间戳)对条目进行筛选。此日期包含在筛选范围内。如果只想输出与上次导出之间的差异,可以在此处输入值“LastExecution”。上次执行导出的时间戳将记录在 [Result] 节的此键下。 |
FilterTo | 根据该时间段的结束时间(UTC 格式时间戳)对条目进行筛选。此日期不包含在筛选范围内。 |
LastXDays | 导出条目后的期限,以天为单位。 |
调用示例
参数文件 exportJobResults.ini
[Common]
ReportType=JobResults
ExportFile=D:\Test\myJobResults.csv
Dir=\SmartShopFloor
[Filter]
LastXDays=20
[User]
Account={User}
Password={Password}
结果文件中出现的列概览
数据记录根据 JobId 列和 TimestampUTC 列的内容排序。
列 | 描述 |
---|---|
组件 | 组件名称(及其在 项目树 中的路径) |
ComponentID | 组件 ID(GUID 格式) |
ComponentTypeID | 组件类型 ID(GUID 格式) |
ComponentTypeName | 组件类型名称 |
作业 ID | 作业 ID(GUID 格式) |
JobName | 作业名称 |
UploadClass | 作业的上传类型 |
WhoToNotify | 作业执行情况应通知的用户的列表 |
Execution | 作业的执行状态。取值:0:未按计划执行,1:按计划执行,2:通过 BackupClient 执行 |
IpOrComputername | IP 地址或计算机名。值的输出取决于上传类。 |
UploadAgent | 代理的计算机名或 IP 地址。只有为作业分配了上传代理时,才会指定此值。 |
CompareAgent | 代理的计算机名或 IP 地址。只有为作业分配了比较代理时,才会指定此值。 |
TimestampLocal | 作业执行的时间戳(本地时间) |
TimestampUTC | 作业执行的时间戳(UTC) |
TimestampBackupLocal | Backup.zip 文件的时间戳(本地时间) |
TimestampBackupUTC | Backup.zip 文件的时间戳(UTC) |
DirBackup | 保存当前作业备份(Backup.zip 文件)的服务器存档目录的相对路径。 |
ResultVersionVsBackup | 服务器版本与备份版本的比较结果。输出的状态代码列表及其说明可在 AdminClient 文档中找到。本导出进程不显示以下作业执行结果:不存在 和 已停用 |
TimestampVersionLocal | 文件 Archive.zip 的时间戳(本地时间) |
TimestampVersionUTC | 文件 Archive.zip 的时间戳(UTC) |
DirVersion | 保存作业版本(Archive.zip 文件)的服务器存档目录的相对路径 |
VersionNumber | 版本号 |
ErrorVersionVsBackup | 该列仅在 服务器版本 ↔ 备份 比较流程中发生错误时包含值。 |
WarningVersionVsBackup | 该列仅在 服务器版本 ↔ 备份 比较流程中发生警告时包含值。 |
ResultBackupVsPreBackup | 当前备份与前一备份的比较结果。发出的状态代码列表及其说明可在 AdminClient 文档中找到。本导出不显示以下作业执行结果:不存在 和 已停用 |
TimestampPreBackupLocal | Backup.zip 上一个备份文件的时间戳(本地时间) |
TimestampPreBackupUTC | 前一备份的 Backup.zip 文件的时间戳(UTC) |
DirPreBackup | 服务器存档中保存上一个作业备份(Backup.zip 文件)的目录的相对路径 |
ErrorBackupVsPreBackup | 该列仅在 前一备份 ↔ 备份 比较流程中发生错误时包含值。 |
WarningBackupVsPreBackup | 该列仅在 前一备份 ↔ 备份 比较流程中发出警告时包含值。 |
ExecutingServer | 执行作业的服务器 |
TimestampJobStartLocal | 作业开始执行时的时间戳(本地时间) |
TimestampJobStartUTC | 作业开始执行时的时间戳(UTC) |
TimestampUploadStartLocal | 从上传开始的时间戳(本地时间) |
TimestampUploadStartUTC | 上传开始的时间戳(UTC) |
TimestampUploadEndLocal | 上传结束后的时间戳(本地时间) |
TimestampUploadEndUTC | 上传结束时的时间戳(UTC) |
TimestampCompareStartLocal | 比较开始的时间戳(本地时间) |
TimestampCompareStartUTC | 比较开始的时间戳(UTC) |
TimestampCompareEndLocal | 比较结束时的时间戳(本地时间) |
TimestampCompareEndUTC | 比较结束时的时间戳(UTC) |
TimestampJobEndLocal | 作业执行结束时的时间戳(本地时间) |
TimestampJobEndUTC | 作业执行结束时的时间戳(UTC) |
来源 | 来源,即备份的来源。这里最常输出的是 MainServer 和 BackupClient 的值。 |
WhoToNotifyNames | 要收到作业执行通知的用户名。多个名称之间用逗号分隔。只有配置了发送作业执行情况电子邮件时,才会显示此列。 |
WhoToNotifyEMails | 通知作业执行情况的用户电子邮件地址。多个电子邮件地址之间用逗号分隔。只有配置了为作业执行发送电子邮件时,才会显示此列。 |
WhoToNotifyAdditional | 没有versiondog 账户但仍应接收作业执行通知的用户的电子邮件地址。多个电子邮件地址之间用逗号分隔。仅在已配置作业执行的邮件通知功能时,才会显示此列。 |