BlueGrove Labs
帮助中心StatusPath ReportsJira Cloud
联系支持
EN

如何将 Jira Time in Status 导出到 Excel

要把 Jira Time in Status 导出到 Excel,应先在报表中定义 Jira 工作项范围、历史窗口、工作日历、字段和状态列,检查表格后选择 导出 → 导出 XLSX。工作簿会保留当前配置计算出的状态时长列;共享前应把代表性行与报表和 Jira 历史记录对照。

Jira 原生导出与计算时长导出不同

Atlassian 的搜索结果导出文档说明,Jira 搜索可以把全部字段、当前字段或筛选条件字段导出为 CSV,也可以在 Microsoft Excel 中打开结果。这类导出适合 Jira 字段。“在 In Review 中停留多久”则是另一类数据,必须先按明确的历史窗口和工作日历从状态历史计算。

需要每个状态独立时长列时,请使用 Time in Status;只需要 Jira 字段时,原生搜索导出通常已经足够。

无需重写 JQL 导出项目报表

如果所需范围就是整个 Jira 项目,可在 StatusPath 中选择 Project 数据源。如果团队已在 Jira 中维护工作项范围,可选择对应的 Saved Filter。这两种方式都不需要每次把筛选规则重写为内联 JQL。可通过数据源对比指南判断报表范围应由 Project、Filter、JQL、Sprint 还是 Epic 负责。

不要把这描述为“一键导出整个 Jira Backlog”。Board Backlog 可能受 Board Saved Filter、Sprint 状态、Kanban Sub-filter,以及列与状态映射影响,它不一定等于项目里所有未完成工作项。只需当前 Jira 字段快照时,应优先使用 Jira 原生 Basic Search 和 CSV 导出。需要严格复用已维护的 Backlog 范围时,应先核对 Board 规则并复用对应的 Jira 共享筛选器。只有这个范围还需要 Backlog、In Progress 或 Review 等计算时长列时,StatusPath 才是相关方案。

这样可以保持承诺准确:Project 或 Saved Filter 可以避免手写复杂 JQL,但导出文件仍是 StatusPath 报表结果,不是 Jira Board、Backlog、评论、附件、工时或 Changelog 的完整副本。

真实 Jira 场景:20 个发布工作项的工作簿

发布经理需要一个包含 20 个工作项的工作簿,列包括:

  • 工作项 Key、Summary、Current status 和 Assignee
  • In Progress、In Review 和 QA 时长
  • 三个所选状态的总计(Total)

报表使用一条维护好的 JQL:

project = SR AND fixVersion = "July Release"

团队把日历记录为 UTC、周一至周五 09:00-17:00,计算完整历史,并使用小时和分钟格式。这些口径应与工作簿一起进入评审说明。

StatusPath Time in Status 报表显示 project SR 的 July Release 查询、20 个工作项、In Progress、In Review、QA 和总计列,以及导出 CSV 和导出 XLSX 选项
已核查的 20 个 July Release 工作项使用 project = SR AND fixVersion = "July Release",并可选择导出 CSV 或导出 XLSX。

计算与核查示例

共享工作簿前,先核查三行:

工作项 In Progress In Review QA 所选状态合计
SR-2801 4h 2h 1h 7h
SR-2802 5h 3h 2h 10h
SR-2803 6h 4h 3h 13h

SR-2801 的人工加总为:

4h + 2h + 1h = 7h

评审人先在报表中检查四个值,再打开下载的工作簿核对同一行和列标题。随后用 Jira 历史记录检查一条状态区间是否符合已声明的工作日历。

按步骤导出报表

1. 运行报表

选择 Project、Filter(筛选条件)、JQL、Sprint 或 Epic,应用计算设置并运行报表。在这个发布场景中,确认 JQL 完全等于 project = SR AND fixVersion = "July Release",并确认结果包含 20 个工作项。

2. 配置 Columns(列)

打开 Columns。保留评审所需的工作项字段,显示 In Progress、In Review 和 QA,并包含这三个状态的总计。当前表格视图文档说明了动态列和列管理。

3. 设置支持的筛选和排序

应用文件需要的表格筛选条件和排序,再检查可见列顺序。这些表格设置会成为导出状态的一部分。

4. 点击 Export(导出)

表格加载完成后,打开 Export 菜单。

5. 选择 Export XLSX

选择 Export XLSX 生成 Excel 工作簿。需要轻量交换文件时,改选 Export CSV。当前导出文档说明了两种格式和导出进度。

6. 打开并核查文件

打开下载的文件,确认它包含 20 行、预期列标题,以及上表中的 SR-2801、SR-2802 和 SR-2803 数值。记录导出时间,因为文件生成后 Jira 数据仍可能变化。

导出包含哪些内容

对于这份 Time in Status 报表,导出会针对当前报表配置加载完整结果,不是只导出浏览器当前视口或最初加载的 50 行。支持的表格筛选和排序会应用到完整结果。隐藏列不会导出,可见列顺序会带入文件,派生的总计列会保留在对应指标列之后。当前配置未生成的动态状态列或分组列可能不会出现在文件中。

报表定义仍然重要:工作项日期范围、裁剪历史(Trim History)、工作日历、时区、时长格式,以及所选字段和状态,都应随工作簿一起记录。即使选中同样的 20 个工作项,这些设置也可能改变数值。

电子表格安全与数据处理

当电子表格软件把文本识别为公式时,相关风险称为电子表格公式注入。StatusPath 会在 CSV 下载前,为以 =、+、- 或 @ 开头、可能被识别为公式的文本值添加单引号;单独的字面值 - 保持不变。这是一项有限防护,不能防御所有电子表格或下游转换风险。

  • 只导出评审需要的 Jira 字段,因为其中可能包含敏感信息。
  • 只共享给预期评审人,并谨慎处理转换或再加工后的文件。
  • 除非组织的留存与控制流程明确保证,否则不要把普通导出描述为不可变审计记录。

常见错误

报表口径尚未稳定就导出

导出后再修改工作日历、裁剪历史或状态列,会产生不同的文件。应先定稿并记录口径。

混淆 Jira 原生字段和计算历史列

Jira 搜索导出不会自动为每个工作流状态生成独立时长列,应记录文件由哪个报表生成。

只核查行数

文件可以正确包含 20 行,但仍然使用错误的历史窗口或日历。必须核查具体值。

把已保存报表当作冻结文件

已保存报表(Saved Report)保存可复用配置,并按当前可访问 Jira 数据重新运行;导出才是某次运行的时间点文件。

忽略筛选、排序和隐藏列

导出前检查当前表格状态。支持的筛选、排序、隐藏列和列顺序都会改变评审人收到的内容。

常见问题

Jira 能直接把 Time in Status 导出到 Excel 吗?

Jira 搜索可以导出 Jira 字段并在 Excel 中打开。逐状态计算时长需要历史计算,或预先维护好的自定义字段。

应选择 CSV 还是 XLSX?

评审工作簿使用 XLSX;数据交换或下游处理使用 CSV。两者都应按同一报表口径核查。

Jira 数据变化后工作簿会自动更新吗?

不会。文件只代表一次导出;需要最新数据时,应重新运行报表并再次导出。

应核查哪些记录?

至少检查一条普通记录、一条高时长记录、一条空值或零值记录,以及一条根据 Jira 历史记录人工重建的区间。

Status Entry Date 或事件次数也能导出吗?

可以。StatusPath 表格导出可以包含当前报表类型配置的计算列,包括首次进入日期和次数列。

相关指南

导出有定义的报表,而不是无说明的表格

有用的 Excel 文件会在数字周围保留工作项范围、计算窗口、工作日历、字段、计算列和核查说明。只有工作簿需要计算后的状态时长列时,才前往 Atlassian Marketplace 试用 StatusPath Reports,并在导出已审核的 CSV 或 XLSX 前核查代表性行。

截图预览