如何保存和恢复可复用的 Jira 工作流报表

Saved Report 预设是一份命名的可复用报表配置，不是已保存的 Jira 结果。先评审它的工作项总体、历史窗口、Calendar、Format、字段、指标列、筛选和排序，再选择另存为。定期评审时选择使用，检查依赖并再次运行报表。此次运行会根据当前可访问的 Jira 数据计算当前结果；评审者需要时间点文件时，应使用带日期的 CSV 或 XLSX 导出。

可复用定义不等于已保存结果

本文回答：团队如何治理并重复运行同一份 Jira 工作流报表，既不用每次重建，又不会把预设误当成带日期的快照？

使用 Jira 工作流报表完整指南把保存的定义与问题、工作项范围、指标、历史窗口、核查证据和输出关联起来。

当前控件见 Saved Reports 文档。另存为会创建命名预设，保存会把经过评审的修改写入所选预设。预设操作用于打开预设命令；管理预设...把活动行标为当前，为另一个预设提供使用，并提供重命名、复制和删除。本文负责这些控件周围的运行方法：命名、人工责任、验收、依赖检查、重跑对比，以及实时预设与导出文件之间的边界。

预设会持久化报表类型和数据源、Work item date range、Trim History、Calendar ID、Format、Table/Chart 模式、工作项字段选择与顺序、所选状态/Assignee/Transition 列及顺序、列组展开状态、Status Group 或 Assignee Group 定义、工作项与时长排序/筛选模型、Average Group By 与每周起始日、Time Between 指标端点，以及受支持的图表设置。

它不会存储结果行、Jira 工作项或 Changelog 副本、CSV/XLSX/图表导出文件、所引用 Saved Filter 在保存时的 JQL 定义、Jira 权限快照、冻结的 Calendar 定义、已打开的菜单或进度，也不会存储表格运行时布局。由于持久化的只有 Calendar ID，之后修改该 Calendar 可能改变后续结果。

请区分以下三个概念：

• 命名的 Saved Report 预设：通过使用选择的可复用配置。
• 当前结果：报表按当前适用权限和所引用依赖查询当前 Jira 数据后生成的行与计算结果。
• CSV/XLSX 导出：下载时点的文件；Jira 变化后，它不会自动更新。

Atlassian 说明 Jira 搜索可以保存为带 Owner 和共享规则的可复用 Filter。当 StatusPath 预设引用这种 Filter 时，Filter 仍是实时 Jira 依赖，不会在预设内变成冻结的查询快照。

真实 Jira 场景：一个月度 Review 定义，两次不同结果

交付团队批准以下配置：

团队在 7 月 1 日运行并导出带日期的 XLSX。7 月 8 日，它对同一个预设选择使用，并针对当前可访问的 Jira 数据再次运行报表：

7 月 1 日总计 = 2h + 4h + 6h = 12h
7 月 8 日总计 = 2h + 4h + 10h + 3h = 19h
变化 = 19h - 12h = 7h
     = 区间结束前新增 4h 可计时间 + 新匹配工作项 3h

这 4h 归因成立，是因为 SR-6103 在 7 月 1 日运行时仍处于 In Review，之后又经历了所选 Calendar 可计的 4 小时才结束；Trim History 没有固定结束时间，而且 7 月 8 日确实重新查询 Jira 并运行了报表。若 Trim History 结束时间固定，或 Calendar 排除了其中部分时段，增量就会不同。

在这个受控示例中，7h 差异是实时重跑的证据，并不能证明使用改变了算法。应先比较保存的定义，再检查 Jira 数据和权限变化。

保存并治理报表

1. 固定报表定义

运行报表并记录数据源、Work item date range、Trim History、Calendar、Format、可见字段、指标列、分组、筛选、排序和图表设置。使用 Project、Filter、JQL、Sprint 与 Epic 对比指南治理总体选择，并以报表设置与范围文档核对当前控件。

2. 使用可审计名称

名称应标明问题和时间口径，例如 Monthly Review — elapsed hours — v1。不要在预设名称中写入敏感 Jira 数据。

3. 保存命名预设

选择另存为，输入批准的名称，并确认它成为当前预设。之后，保存会把经过评审的修改写入该预设。

用户返回时，StatusPath 可能恢复最近一个未命名的未保存预设。它是可变的工作状态，不是管理预设...中的命名行，并可能被后续草稿修改替换；它不是稳定、带版本的评审定义。

4. 执行验收

在依赖预设之前检查：

1. 预期的数据源类型和精确值；
2. Work item date range 与 Trim History 边界；
3. Calendar 名称、时区、工作时间、节假日和例外；
4. 可见指标列、分组定义、筛选和排序；
5. 一个普通行和一个边界或高时长行，并与 Jira History 核对。

5. 需要时间点文件时再导出

验收后使用 CSV 或 XLSX 导出。随文件记录导出时间和预设版本。Jira 变化后，导出文件不会自动更新。

6. 恢复、检查依赖，然后重跑

打开预设操作 → 管理预设...，对目标预设选择使用，并确认其行变为当前。比较新结果和带日期的导出前，检查 Jira Saved Filter、状态、字段、Calendar 或适用权限是否变化。

7. 对重大定义变化做版本控制

当报表问题发生重大变化时复制并重命名预设，例如新的 JQL 总体、历史边界、Calendar 政策、Status Group 映射或分母。只有当评审者希望以后所有运行都采用修订定义时，才直接更新 v1。

恢复后哪些内容仍会变化？

恢复默认会把报表条件恢复为一个未命名的未保存预设。它不会选择命名的 Saved Report 预设，也不会把命名预设标为默认项。

常见错误

把 Saved Report 预设称为快照

预设保存设置，并重新运行当前可访问的 Jira 数据。评审需要时间点文件时应使用带日期的导出。

只给名称加版本

只有同时记录数据源、边界、Calendar、指标映射和验收证据时，v2 才真正有意义。

忽略 Calendar 修改

预设保存 Calendar ID。管理员修改该 Calendar 后，同一个预设可以得到不同的工作时长。

把恢复后的行当成权限基线

当用户能够运行某个配置时，会在此次运行中应用 Jira 浏览权限。预设既不会授予权限，本文也不假定它提供共享机制。如果不同租户用户需要重跑，应分别使用每个目标账号验证预设可见性和使用权限，不能从创建者会话推断共享范围。

把未保存草稿当成已治理定义

恢复的未保存预设可能被后续草稿修改替换，也不是管理预设...中的命名行。工作状态准备成为定期评审定义后，再选择另存为。

常见问题

Saved Report 预设会冻结 Jira 数据吗？

不会。它保存报表配置，并在重跑时查询当前可访问的 Jira 数据。

为什么恢复后返回了不同工作项？

JQL、Saved Filter、Sprint/Epic 成员关系、Jira 字段、权限或 Work item date filter 可能已经产生不同总体。

为什么预设名称未变，时长却变化了？

开放区间、修正后的 Jira History、不同计算终点或所选 Calendar 的修改都会改变时长。

应该更新还是复制预设？

如果批准的定义本身需要针对所有未来运行修正，则更新。如果评审者需要区分旧定义和新定义，则复制并设置新版本。

恢复默认会做什么？

恢复默认会把报表条件恢复为一个未命名的未保存预设。它不会把所选命名预设设为默认项。

相关指南

• Jira 工作流报表完整指南：从数据范围到导出
• Saved Reports 文档
• 面向管理层的 Jira 每周工作流报告示例
• Jira 工作流评审清单
• 如何将 Jira Time in Status 导出到 Excel

保留问题定义，再比较实时证据

经过治理的 Saved Report 预设让同一个评审定义可以复用。把版本化配置与验收检查放在一起；需要冻结证据时使用带日期导出。Jira 数据或依赖变化后，稍后的重跑结果可以变化，也经常应该变化。

在 Atlassian Marketplace 试用 StatusPath Reports，把经过评审的工作流报表保存为命名预设，在下一次评审中通过使用选择它，并在需要时间点工件时导出带日期的结果。