跳到主要内容

变更报告(增量导出)

大多数导出回答的是*“现在的情况是什么样?”*。而变更报告回答的是人们在状态例会上真正会问的问题:“自上次以来发生了什么变化?”

该功能在 Standard 版中可用于 JQL、看板、冲刺、发布版本与待办列表导出。它最适合作为定时导出使用 —— 每周一早晨送达收件箱的“变化了什么”周报。

它不是什么

它不是 Jira 变更日志的原样导出。那件事变更历史组件已经按事务做到了。

变更报告工作在被导出集合这一层级上:

  • 结果中新出现了哪些事务,
  • 哪些事务已不在结果中
  • 哪些事务发生了变化 —— 状态、经办人、优先级、到期日,以及你自行添加的任何字段,
  • 新增的评论与工作日志。

“已不在结果中”不等于已删除

这是关于该报告最需要理解的一点。

当某个事务出现在已不在结果中下方时,说明它不再属于本次导出的结果集。这并不意味着该事务被删除了。它可能被移动到了其他项目、重新分配、重新打了标签,或只是被编辑过,以致你的过滤器不再匹配它。

在导出的文档中,每一份离开事务的列表都会带有这条说明,所有语言、所有格式皆是如此,且压缩显示时也绝不会移除它。一份报告若声称某项工作已被删除、而实际上只是被重新打了标签,将造成代价高昂的误解。

出于同样的原因,离开的事务仅按事务键列出。Exportelier 并不保存它们的副本,而获取它们当前的状态也无法说明它们为何离开。

如何设置

  1. 在设计器中打开模板。
  2. 开启变更报告并选择一个参照点。
  3. 放置这三个组件:
    • 变更摘要 —— 计数、参照点说明行以及各类提示。
    • 增量事务列表 —— 一个列表,可设为新增已不在结果中。若两者都要,就添加两次。
    • 变更表格 —— 每个发生变化的字段一行。
  4. 保存,然后像使用其他模板一样使用它。

参照点

参照点含义适用场景
上一次导出该模板上一次导出这一范围的时刻临时报告
上一次计划运行该计划任务上一次成功运行周报与月报
固定日期你手动输入的日期“自发布分支切出以来的全部变化”

被跟踪的字段

状态、经办人、优先级与到期日始终会被跟踪。你可以在模板设置中添加自己的字段 —— 故事点、冲刺、某个自定义字段。新增的评论与工作日志同样算作变化,若对你的读者而言是噪音,也可以关闭。

第一次运行

某个模板与范围的第一份报告没有可供比较的对象。它不会因此失败,而是会输出当前集合的完整报告并加以说明:

这是该模板与范围的第一份变更报告,因此它列出了当前的完整集合。之后的报告将只显示发生变化的内容。

从第二次运行开始,你就会得到真正的增量结果。

一个完整示例

某团队每周一 08:00 针对 project = EX AND sprint in openSprints() 运行一次定时导出,使用了全部三个组件以及上一次计划运行这一参照点。

8 月 3 日星期一 —— 第一次运行。 不存在更早的运行,因此报告列出了全部 14 个冲刺事务,并带有首次运行说明。这就是基线。

本周之内。 EX-104 被创建并纳入冲刺。EX-77 被移动到其他项目,因而从过滤器中掉出。EX-42 在五天内经历了 To Do → In Progress → Review → In Progress → Review → Done。EX-51 从 Ada 转派给 Grace,并新增了两条评论。另有十个事务未发生变动。

8 月 10 日星期一 —— 第二次运行。 报告开头是:

自 2026 年 8 月 3 日以来的变化

新增:1 · 已不在结果中:1 · 已变更:2 · 未变更:10

接着是变更表格:

事务键字段变化次数
EX-42statusTo DoDone5
EX-51assigneeAdaGrace1

请注意 EX-42 这一行。该事务的状态变化了五次,而这里只用一行展示了它从哪里开始、到哪里结束以及经历了多少步。若为同一个事务列出五行,反而会淹没真正需要关注的那两个事务。

阅读耗时:约十五秒;相比之下,滚动浏览十四条事务描述来判断有何不同要慢得多。

当历史无法重建时

Jira 并不会为每个字段都记录变更日志条目,而且过长的历史在 Exportelier 获取时会被截断。当可用的历史无法覆盖整个报告周期时,该事务会在摘要中被报告为无法重建,而不是被悄悄计为未变更。

子任务以及更深的层级级别本身不带有变更历史,因此也归入这一类。它们仍会计入总数 —— 增量始终基于被导出事务的扁平集合计算,所以数字是对得上的。

Exportelier 存储哪些内容

为了告诉你哪些事务是新增的、哪些离开了,Exportelier 必须记住上一次导出中包含了哪些事务。它只存储事务键,别无其他

不存储摘要、字段值、描述或评论。变更表格中的前后取值,是在生成报告的那一刻从 Jira 自身的变更历史中读取的,且绝不保留。存储的事务键列表在 180 天后过期。

这是刻意为之:保存字段值会让报告更容易生成,但也会让 Exportelier 变成你 Jira 内容的第二份副本,并连带引发数据保护方面的一切问题。

限制

  • 不适用于单事务导出 —— 请改用变更历史组件。
  • 不适用于按事务生成的 ZIP 归档:一份描述整个集合的报告没有单一文档可以承载。
  • 每个模板与范围最多记住 2,000 个事务键。超过之后,报告会说明新增与离开的数量可能不完整。
  • 变更表格在整份报告中最多 500 行;达到上限时,文档中会予以说明。