权限和数据访问

StatusPath Reports 在 Jira Cloud 应用上下文中运行，并遵循 Jira 权限。报表结果取决于当前用户和应用可以访问的数据。

Jira 权限如何影响报表

用户只能对自己在 Jira 中有权查看的工作项生成报表。项目权限、Issue security、筛选器共享、看板权限、字段可见性和工作流配置都会影响可用数据。

如果同一份报表在不同用户之间结果不同，通常是因为这些用户在 Jira 中能访问的数据不同。

应用从 Jira 读取的数据

根据报表配置，应用可能读取：

• 工作项 key、summary、status、assignee、project、issue type、priority、reporter、parent、resolution 和日期字段。
• changelog 历史，用于计算状态停留时间、负责人停留时间、状态进入次数和流转次数。
• 项目、筛选器、看板、Sprint、Epic、状态、工作流状态元数据、字段和用户查询数据，用于报表设置控件和报表结果。
• 配置仪表板小程序时使用的 dashboard item properties。

应用保存的数据

StatusPath Reports 可能保存用于恢复和个性化报表流程的配置：

• 已保存报表和默认报表设置。
• 最近使用的设置和用户报表偏好。
• 管理员设置、工作日历和项目设置记录。
• 仪表板小程序配置。

已保存报表保存配置，不保存固化的 Jira 结果行、changelog 快照或下载后的导出文件。

Issue Activity 会读取站点 Calendar 和管理员默认值，并在模块保持挂载期间保留当前选择。它不会在全新页面加载之间持久化一套独立的 Issue Activity 用户偏好。

Issue 下探的数据边界

Average Time in Status 的参与项列表从当前已运行报表的内存快照生成。它继承该报表的范围、分组、Calendar、Format 和 Trim History，但不是持久化的 Jira 结果快照。

从主报表页面的 Average 参与项继续打开单个工作项 Journey 时，应用会为该工作项单独读取当前可访问的详情、完整 changelog 和工作流状态元数据。这个读取遵循当前用户在打开 Journey 时的 Jira 权限，因此：

• 工作项在报表生成后发生变化时，参与项快照与后来读取的详情可能反映不同时间点。
• 用户失去访问权限后，工作项可能仍出现在已经生成的参与项列表中，但 Journey 无法加载。
• Journey 的时间线和历史路径图截至报表生成时刻，并不按 Trim History 裁剪；报表贡献卡和参与项明细仍使用报表计算边界。
• 流转人来自 Jira changelog；初始状态通常没有流转人，身份信息缺失时可能显示 Unknown user 或 —。

流转人表示 Jira 状态变更中记录的用户，不是工作项当前 Assignee。

应用不会因为打开下探而把完整 changelog 或 Journey 结果保存为已保存报表的一部分。具体入口和展示差异见 Issue 下探。

已保存报表可见性

已保存报表的可见性取决于产品当前的保存模型和用户上下文。即使用户能看到某个已保存报表，也只能运行自己有权限访问的 Jira 数据。

模块说明

• 主报表页面适合分析一组工作项。
• Issue Activity 只读取当前 Jira 工作项，并显示单工作项分析报表。
• Dashboard gadget 在 Jira 仪表板中保存自己的小程序配置。

工作项缺失的常见原因

• 当前用户无权查看该工作项。
• 筛选器或 JQL 没有包含该工作项。
• Work item date range 排除了该工作项。
• Trim History 排除了相关历史片段。
• 字段、看板、Sprint 或 Epic 对当前用户不可见。