如何使用Version One API获取团队房间计分卡及相关指标详情？

可以通过Version One API获取团队房间计分卡的总故事点、详细估算、容量工时、已完成工时等数据，关键是要关联正确的资产类型并构建精准的查询，以下是具体实现方式：

1. 定位目标团队房间（TeamRoom） #

首先需要获取对应团队房间的ID，使用OData查询TeamRoom资产：

rest-1.v1/Data/TeamRoom?sel=Name,ID&where=Name='你的团队名称'

2. 关联迭代（Timebox）拉取核心计分卡数据 #

团队计分卡的数据通常绑定到特定迭代，通过关联TeamRoom和Timebox，直接获取所需的核心指标：

rest-1.v1/Data/Timebox?sel=Name,ID,TeamRoom,Estimate,Capacity,CompletedEffort&where=TeamRoom='{TeamRoomID}'&sort=BeginDate desc

各字段对应关系：

• Estimate：总故事点/详细估算值
• Capacity：团队容量工时
• CompletedEffort：已完成工时

3. 获取Story层面的明细估算数据 #

如果需要每个用户故事的详细估算和完成情况，可查询对应迭代下的Story资产：

rest-1.v1/Data/Story?sel=Name,Estimate,Actuals&where=Timebox='{TimeboxID}'

• Estimate：单个故事的估算点
• Actuals：该故事已消耗的工时

注意事项 #

• 确保调用API的账号拥有目标TeamRoom和Timebox的读取权限
• 不同Version One版本的字段命名可能存在细微差异，可通过rest-1.v1/Data/[AssetType]/meta接口查看资产的完整字段元数据
• 若计分卡包含跨迭代的汇总数据，需调整Timebox的查询条件（例如指定日期范围where=BeginDate ge '2024-01-01' and EndDate le '2024-01-31'）

内容的提问来源于stack exchange，提问作者Knmh