StatusPath Reports使用指南
Jira 工作流报表 Business Calendar 完整指南
Jira 工作流报表日历定义状态或负责人区间的哪些部分计入工作时间。可靠的日历会记录时区、每周工作时段、节假日、特殊工作日、负责人、依赖的 Saved Reports 和验收证据。它是指标定义的一部分：即使 Jira 历史和工作项范围不变，修改日历也可能改变报表时长。如需在 StatusPath 中输入每周工时和节假日的具体操作，请使用如何为 Jira 状态报表配置工作时间和节假日；本 Pillar 聚焦负责人、复用、审批和变更控制。
Business Calendar 是指标约定
“In Review 中有 3 个工作小时”只有在读者能回答以下问题时才可复现：
| 决策 | 必须记录的内容 |
|---|---|
| 用途 | 日历支持的工作流问题 |
| 时区 | 哪个时区决定工作日和例外边界 |
| 每周排班 | 工作日和所有每日时间段 |
| 例外 | 非工作节假日和特殊工作日 |
| 计算范围 | 哪些时长报表和历史窗口使用该日历 |
| 负责人 | 谁审批并维护变更 |
| 基线 | 一个能够验证每周排班的普通区间 |
| 边界验证 | 每种重要例外规则至少一个已知区间 |
| 复用 | 哪些 Saved Reports 依赖该日历 |
| 版本 | 生效日期、审核人和周期比较所使用的定义 |
StatusPath Reports 把选定 Calendar 用于 Time in Status、Average Time in Status 和 Time in Assignee 的工作时间计算。日历和时长文档负责当前控件说明；本指南负责这些控件背后的设计、验证和治理决策。
Jira 中的多种日历不能混为一谈
Atlassian 的配置工作日页面说明了公司管理型 Jira Software 看板设置，该设置用于指定的原生报表和小组件，包括 Sprint Report 和 Control Chart。它可以定义标准工作日、非工作日期和看板时区。
Jira 还有用户和站点时区。Atlassian 说明 Jira 管理员可以设置默认用户时区，登录用户则可以在 Jira 个人设置中覆盖它。这些展示设置不会自动为 StatusPath 选择工作日历。
Jira Service Management SLA 日历为服务空间中的 SLA 目标定义工作日、时间段、时区和节假日。它不是 Jira 全局日历，也不是 StatusPath 日历对象。两种指标需要一致时，应记录并比较两套定义，而不是假设自动继承。
可复现 Jira 场景：治理上海支持团队日历
本例使用可复现 Jira 报表场景中的演示工作项。
团队批准名为 Shanghai Support 09:00-17:00 的日历：
| 规则 | 批准值 |
|---|---|
| 时区 | Asia/Shanghai |
| 标准工作日 | 周一至周五 |
| 标准时间段 | 09:00-17:00 |
| 特殊工作日 | 2026-07-11，星期六，09:00-12:00 |
| 验收格式 | Decimal Hours |
| 负责人 | 支持运营 |
| 复用登记 | 人工维护的依赖 Saved Reports 清单，以及纳入定期运营流程的手工导出报表 |
星期六例外只增加一次工作上午，不会把所有星期六都改成工作日。其他节假日仍属于受治理的例外清单，但具体控件操作由专门的配置指南负责。
验收证据必须验证书面政策
治理审批需要一个正常基线，并为每项重大变更保留一个聚焦边界测试。以下两例验证普通 8 小时工作日和星期六特殊工作时段，不再重复节假日配置流程。
基线：标准工作日等于 8 小时
工作项 SR-3401 在 7 月 6 日星期一 09:00 进入 In Review，在 17:00 离开，时间均为 Asia/Shanghai。
| 区间 | 计入时长 |
|---|---|
| 星期一 09:00-17:00 | 8 小时 |
| 工作时间合计 | 8 小时 |
自然时间和工作时间都是 8 小时。该基线先验证普通工作日排班；它不能单独证明节假日或特殊工作日规则。
变更验收：星期六覆盖等于 3 小时
工作项 SR-3403 在 7 月 10 日星期五 16:00 进入 In Review，在 7 月 11 日星期六 11:00 离开，时间均为 Asia/Shanghai。
| 区间 | 计入时长 |
|---|---|
| 星期五 16:00-17:00 | 1 小时 |
| 星期六 09:00-11:00 | 2 小时 |
| 工作时间合计 | 3 小时 |
自然时间区间为 19 小时。星期六能贡献时长，是因为明确的 09:00-12:00 特殊工作日覆盖了普通星期六的非工作规则。
验收截图还包含 SR-3402 = 2.00。中间这一行是此前已批准节假日规则的未变更回归对照，不属于星期六计算，也不是第三个配置操作示例。它在这里用于确认批准星期六覆盖后，既有例外结果没有受到影响。
在日历全生命周期中实施治理
批准日历前先定义决策
先说明指标代表客户自然等待时间、服务值守时间，还是交付团队计划工作时间。Business Calendar 只适合后两类问题；需要了解总等待时长时，应同时保留自然时间视图。
书面定义还必须分开工作项范围、历史窗口和日历。数据源选择 Jira 工作项；Trim History 限制每个工作项参与计算的历史部分；Calendar 决定符合条件区间中的哪些工作时间计入。日期范围裁剪指南负责历史窗口边界。
分配明确责任
不要把共享日历交给一个没有姓名和职责的“管理员”：
| 角色 | 治理决策 |
|---|---|
| 指标负责人 | 批准业务问题，并决定自然时间还是工作时间能够回答该问题 |
| 日历维护人 | 维护已批准的时区、每周排班和例外清单 |
| Saved Report 负责人 | 人工记录哪些可复用报表定义依赖该日历 |
| 审核人 | 独立核对基线和每个变更边界 |
选择运营排班所属的时区，而不是报表作者觉得方便的时区。多地区服务的指标负责人必须记录比较采用一个地区、接力值守定义，还是分别使用地区日历。
维护人工 Saved Report 复用登记
对每个依赖该日历的 Saved Report，人工记录名称、报表类型、工作项范围、历史窗口政策、日历名称和时区、业务用途、负责人及最近一次通过的基线。团队把报表手工导出纳入定期运营流程，或在决策中使用看板证据时，也应登记相应用途。这份人工治理记录决定日历变更时的审核范围；StatusPath 不会自动发现下游用途，Jira 看板设置、SLA 日历或其他应用也不会自动继承同一定义。
把例外作为指标变更审批
非工作日期从某天移除正常工时；特殊工作日为指定日期添加或替换工时。每项重大例外都需要原因、生效日期、审核人、受影响报表清单，以及一个能在例外错误时明确失败的区间。如果星期六经常工作，应把它纳入每周政策，而不是连续创建一次性记录。
审核跨版本比较
报表周期开始前审核未来节假日，并在排班政策变化生效前记录变更。使用不同日历定义的周期不能直接解释为工作流改善或退化，除非比较结果明确标记并说明版本变化。
日历变更记录
每次重大更新都应保留：
| 字段 | 示例 |
|---|---|
| 日历 | Shanghai Support 09:00-17:00 |
| 负责人 | 支持运营 |
| 上一批准定义 | 周一至周五 09:00-17:00，Asia/Shanghai |
| 变更 | 添加 2026-07-11 星期六 09:00-12:00 |
| 原因 | 批准的一次性运营时段 |
| 生效日期 | 2026-07-11 |
| 基线验收 | 星期一 09:00-17:00 等于 8 工作小时 |
| 变更验收 | 星期五 16:00 至星期六 11:00 等于 3 工作小时 |
| 受影响报表 | 已命名 Saved Reports、定期运营流程中的手工导出报表和评审证据 |
| 审核人 | 负责确认计算的人员 |
| 下次审核 | 下一条例外或跨周期比较之前 |
Atlassian 的 Jira 报表概览表明，原生报表的可用性和范围会随空间及看板而变化。把 StatusPath 结果与原生 Control Chart 比较时，应先对齐 Jira 看板、所选状态、周期、工作日规则和工作项范围。
常见错误
把所有非自然时长都称为工作时间
只有明确给出工作排班和时区的数值，才是可复现的工作时间。
让报表作者时区决定指标
Jira 个人展示时区与所选 StatusPath Calendar 时区用途不同。涉及日期边界或 JQL 时应同时记录。
修改共享日历却没有人工复用登记
没有依赖的 Saved Reports 和证据清单，审核人就无法判断哪些决策需要重新验证。
添加例外却没有验收测试
日期可能使用了错误的时区、方向或年份。应保留一个能在规则错误时明确失败的已知区间。
跨日历变更直接比较周期
排班或例外变化后，同一段 Jira 历史也可能产生不同工作时长。每个周期都应标记所用定义。
常见问题
Jira 看板 Working days 应与 StatusPath 日历一致吗？
只有当两份报表需要表达同一套排班时才应一致。它们是独立配置，必须显式比较并记录。
Jira Service Management SLA 日历可以直接用于 Time in Status 吗？
不会自动复用。SLA 日历属于 Jira Service Management SLA 目标。时长报表需要同一运营时间时，应在 StatusPath 中重建并验证。
团队可以同时保留自然时间和工作时间吗？
可以。两者回答不同问题。应标记各自定义，避免把一个周期的自然时间与另一个周期的工作时间比较。
节假日会影响 Status Count 或 Transition Count 吗？
不会。工作日历影响时长计算；次数报表统计事件，不过 Trim History 仍可能改变纳入哪些事件。
日历多久审核一次？
未来例外生效前、排班规则变化时，以及正式跨周期比较前都应审核。具体频率取决于排班变化速度。
谁应负责共享 Business Calendar？
由指标负责人批准用途，日历维护人维护定义；Saved Report 负责人手工识别下游使用，审核人则确认基线和边界计算。
相关指南
- 如何为 Jira 状态报表配置工作时间和节假日
- 如何在 Jira 状态时间中排除周末和非工作时间
- 时区如何影响 Jira 状态时长和趋势报表
- 如何跨多个地区统计 Jira 工作流时间
- 如何计算 Jira Cloud 中的状态停留时间
- Jira 工作流报表中的夏令时时间边界问题
让日历与指标一起接受审核
受治理的日历能保留每个工作时间数值的含义。可在 Atlassian Marketplace 试用 StatusPath Reports，把已批准的工作日历用于时长报表和 Saved Reports，并在每项决策旁人工维护负责人、下游用途、基线及变更证据。