StatusPath Reports使用指南
如何为 Jira 负责人时间报表创建自定义负责人分组
Assignee Group 是 StatusPath 的自定义报表配置。它不会把工作项分配给 Jira group，不会继承历史组织成员关系，也不会自动镜像 Atlassian group 的变化。创建本文的互斥分组视图时，应先写清一个工作流问题，再选择需要汇总历史时长的 Jira 用户列，把每位用户一次性映射到 Product、Engineering 或 QA，并把 Unassigned 作为独立的 Time in Assignee 列保留。
负责人分组在这份报表中的含义
StatusPath Assignee Group 会在 Time in Assignee 报表中合并已选择的 Jira 用户时长列。它回答的是“这批工作项在 Product、Engineering 和 QA 名下分别累计了多少记录中的归属时间”之类的工作流问题，不能证明实际投入、个人效率或组织绩效。
Time in Assignee 指南负责底层区间计算：每位用户的列汇总 Jira Assignee 字段保持为该用户的各段时间。本 Guide 从这些逐人列已经存在的位置开始，聚焦如何设计可复用的报表视图。当前发布的 Columns 和分组文档说明 Columns Manager 与 Assignee Group 控件。
需要区分以下三种对象：
| 对象 | 用途 | 边界 |
|---|---|---|
| Jira Assignee 字段及历史 | 记录工作项当前和过去的负责人 | 不定义 StatusPath 报表分组 |
| Atlassian group 或 team 成员关系 | 帮助 Jira 与 Atlassian 管理员管理用户、访问权限或查询成员 | 不会自动同步 StatusPath Assignee Group |
| StatusPath Assignee Group | 在一份报表配置中合并已选择的 Jira 用户时长列 | 重新分类可见用户列，不会重建每个历史时点所属的团队 |
真实 Jira 场景：按工作流职能审阅归属时间
某发布项目有 6 个 Jira 工作项，依次经过 Product、Engineering 和 QA 负责。报表使用 Time in Assignee、同一组 6 个工作项、UTC 时区周一至周五 09:00-17:00 的工作日历，以及 Decimal Hours。需要回答的问题是：
在本次发布范围内，各工作流职能累计了多少工作时间口径的记录归属时间，还有多少时间处于未分配状态？
选择的 Jira 用户与人工记录的分组映射如下：
| 已选择的 Jira 用户 | 报表分组 | 6 个工作项的 Time in Assignee |
|---|---|---|
| Ana Ruiz | Product | 12h |
| Maya Patel | Product | 12h |
| Ben Lee | Engineering | 24h |
| Noah Kim | Engineering | 24h |
| Priya Shah | QA | 9h |
| Sofia Chen | QA | 9h |
| Unassigned | 保留为独立列 | 12h |
分组结果可以直接验算：
Product = Ana 12h + Maya 12h = 24h
Engineering = Ben 24h + Noah 24h = 48h
QA = Priya 9h + Sofia 9h = 18h
Unassigned = 独立的归属状态 = 12h
总计 = 24h + 48h + 18h + 12h = 102h
这份视图让较长的逐人表格更容易审阅，但这些标签属于分析映射。用户清单、Calendar、数据范围和生效日期都应与结果一起保存。
配置可复用的负责人分组报表
1. 写出一个分组层级的问题
问题应聚焦工作流责任或路由，而不是个人绩效。例如“发布工作主要在哪个职能下累计归属时间”或“进入分流前有多少归属时间处于未分配状态”。
2. 固定 Jira 工作项范围
本例使用一份明确的 JQL 范围：
project = SR
AND key in (SR-4801, SR-4802, SR-4803, SR-4804, SR-4805, SR-4806)
ORDER BY key ASC
JQL 决定哪些工作项进入报表，不负责计算 Time in Assignee 或创建分组列。如果周期性报表需要维护型数据源，应在Jira 工作流报表完整指南定义中记录 saved filter 或 JQL 的负责人。
3. 先计算 Time in Assignee，再分组
选择 Time in Assignee，确保每次运行使用相同的 Calendar 和 Format，并先审阅逐人结果。确认 Ana 和 Maya 各为 12h，Ben 和 Noah 各为 24h，Priya 和 Sofia 各为 9h，同时保持 Unassigned 时长可见。
4. 只创建三个用户分组
打开 Columns，创建 Product、Engineering 和 QA 三个 Assignee Group，并为每组选择已经映射的 Jira 用户。当前成员选择器使用 Jira 用户搜索结果。真正的 Unassigned 没有可选择的用户账号，因此应作为独立列保留，而不是写成用户分组。
5. 验算后再保存
先相加底层用户值，确认每个分组总数正确；对于本文的互斥映射，再确认三个分组加 Unassigned 仍为 102h。如果分组视图悄悄遗漏用户、隐藏 Unassigned、改变 Calendar 或改变工作项范围，就不能通过验收。
6. 把配置和维护信息一起保存
需要重复运行时，可以保存已经核查的列与分组配置。在相邻的 runbook 或报表说明中记录分组负责人、用户映射、数据源、Calendar 和时区、生效日期，以及下次复查条件。Saved Reports恢复的是配置；它不会冻结 Jira 数据，也不会把报表映射变成 Atlassian 目录规则。
测试成员换组
假设 Maya 从 Product 调整到 Engineering。编辑当前报表映射并重新运行后，视图变为：
| 报表列 | Version 1 | Maya 换组后的 Version 2 | 变化 |
|---|---|---|---|
| Product | 24h | 12h | -12h |
| Engineering | 48h | 60h | +12h |
| QA | 18h | 18h | 0h |
| Unassigned | 12h | 12h | 0h |
| 总计 | 102h | 102h | 0h |
第二份配置会把 Maya 已计算出的全部 12 小时历史归属时间放入 Engineering：
Product V2 = Ana 12h = 12h
Engineering V2 = Ben 24h + Noah 24h + Maya 12h = 60h
QA V2 = Priya 9h + Sofia 9h = 18h
验算 = 12h + 60h + 18h + 12h Unassigned = 102h
这属于配置视图的重新分类，不是对 Maya 历史团队成员关系的重建。如果评审必须保留过去某个时期的组织结构，应分别保留带日期的 Version 1 配置或导出，以及 Version 2 配置。不要覆盖定义后，再把新分组结果描述成历史组织事实。
明确决定是否允许成员重叠
StatusPath 当前允许同一个 Jira 用户出现在多个 Assignee Group 中。每个分组都会独立纳入该用户的全部计算时长。产品不会强制分组互斥，因此不能把重叠分组的总数相加后当成同一总体的拆分结果。
例如，如果 Maya 留在 Product，同时又加入 Engineering，她的 12h 会进入两个分组：
Product = 24h
Engineering = 60h
QA = 18h
Unassigned = 12h
分组相加 = 114h
底层唯一 Time in Assignee 总量 = 102h
重叠部分 = 114h - 102h = Maya 的 12h
本文示例刻意使用互斥映射：每位已选择用户只能属于 Product、Engineering、QA 中的一组，Unassigned 单独保留。只有在遵守该规则、覆盖全部用户，并保持相同工作项范围、Calendar、历史边界和计算时间时，三个分组加 Unassigned 才能验算回 102h。
可复用的分组模板与边界
以下是可编辑的起点，不是产品内置分组：
| 模式 | 示例标签 | 适合回答的问题 | 边界 |
|---|---|---|---|
| 工作流职能 | Product、Engineering、QA | 交付流程中的记录归属时间累计在哪里？ | 只映射在当前评审范围内承担这些职能的已选用户。 |
| 运营角色 | Triage、Resolution、Review | 各运营角色分别持有工作多长时间？ | 不要根据职位或当前目录成员关系推断，必须记录用户清单。 |
| 地区或班次 | AMER、EMEA、APAC | 明确定义的运营模型中，队列归属如何分布？ | 保持 Calendar 和时区可见，避免人口属性解释。 |
| 交付边界 | Internal、Vendor | 受管理的交付边界两侧分别累计多少归属时间？ | 记录合同或运营定义，不做个人排名。 |
| 无负责人 | Unassigned | 没有 Jira Assignee 的时间有多少？ | 保留为独立列；它不是可选择的 Jira 用户分组。 |
在同一次比较中，每位已选用户都应只有一个有文档记录的分析归属。如果第二个视图需要另一种映射，例如按地区而不是按工作流职能，应另存一份不同名称的配置。不要把两个重叠分析视图的合计相加后当成同一总体。
Atlassian 官方资料可以核查什么
Atlassian 的 JQL 字段参考记录了 Assignee 字段，以及 =、IN、WAS、CHANGED 等受支持的运算符。这些运算符可用于选择或核查工作项，但不会计算负责人归属时长。
Atlassian 的 JQL 函数参考说明了用于匹配 group 用户的 membersOf()，以及 team 使用的 id:<teamId> 形式。例如管理员可以在范围查询中使用一项已经维护的 group：
project = SR AND assignee in membersOf("your-group-name")
这条查询根据 Assignee 字段选择工作项。它不能证明同一成员关系会自动创建或更新 StatusPath Assignee Group，也不会按历史成员关系分类过去的归属区间。
Atlassian 的 group 管理文档介绍如何创建和维护 Atlassian 用户组。目录对象与 StatusPath 报表分组应作为两个独立定义管理。当前 StatusPath Marketplace 页面把 Time in Assignee 和分组列入产品报表范围。
常见错误
假设报表分组会自动跟随 Jira group 或 team
报表映射使用已选择的 Jira 用户列。运营模型变化时应主动复查和更新；没有发布产品证据时，不应声称会自动同步。
成员换组时改写历史
在当前配置中把 Maya 移到 Engineering，会重新分类当前视图中的全部 12h，但不能确定她何时加入 Engineering。需要历史组织上下文时，应保留带日期的定义。
把 Unassigned 当成人或直接隐藏
Unassigned 在当前选择器中没有 Jira 用户账号。应把 12h 保留为独立归属列，使没有记录负责人的时长保持可见，并让底层唯一总量能够验算。
未核查逐人值就直接分组
看起来整齐的 Product 24h，仍可能隐藏用户遗漏或 Calendar 错误。先核对成员列，再核对分组和总计。
比较不同范围或时间口径的报表
相同分组名称并不能保证两次运行可比。必须固定 Jira 数据范围、Trim History、计算时间、Calendar、时区和 Format。
用归属时长给个人排名
Time in Assignee 包含工作项记录在某人名下时的等待。它是工作流证据，不能证明实际劳动、质量或个人效率。
常见问题
StatusPath Assignee Group 等于 Atlassian group 或 Jira team 吗？
不等于。Atlassian group 或 team 是用户成员对象；StatusPath Assignee Group 是合并已选择 Jira 用户时长列的报表配置，不暗示两者会自动同步。
把一个人移到另一组会保留其旧团队成员关系吗？
不能据此重建历史成员关系。当前映射只会在当前视图中分类该用户已经计算出的归属时长。如果必须审计过去的组织定义，应保留分别带日期的配置或导出。
可以把 Unassigned 加入负责人分组吗？
在当前成员选择器中，Unassigned 没有真实 Jira 用户账号，因此不能作为用户加入。应把它保留为独立的 Time in Assignee 列，并纳入总数验算。
一个人能否同时属于多个 Assignee Group？
可以。StatusPath 当前允许成员重叠，每个分组都会独立纳入该用户的全部计算时长，因此不能相加重叠分组的总数。如果验收规则是“分组总计加 Unassigned 等于底层唯一总量”，就应使用互斥映射。
JQL membersOf() 能创建报表分组吗？
不能。membersOf() 可以帮助选择 Assignee 符合 Atlassian group 或 team 成员规则的工作项，但不会创建 StatusPath 分组列，也不会根据 Assignee 历史计算时长。
可以用负责人分组做个人绩效比较吗？
不可以。分配时长可能包含排队、依赖、客户等待或计划性延迟。应先用分组调查工作流归属模式，再结合 Jira 历史和运营上下文做流程判断。
相关指南
让映射与结果一起留存
可复用的负责人分组报表，是 Time in Assignee 上一层有文档记录的分析视图：明确的用户成员、同一 Jira 数据范围、同一 Calendar、生效日期，以及返回逐人值和 Unassigned 值的验算。人员、范围或运营模型变化时应重新检查映射；过去的组织上下文很重要时，则保留带日期的版本。
前往 Atlassian Marketplace 试用 StatusPath Reports，用所选 Jira 用户创建 Product、Engineering 和 QA 视图，保持 Unassigned 可见，并在保存报表配置前验算 102 小时总计。