如何在Azure DevOps的OData查询中汇总剩余工作量适配Power BI？

问题背景 #

构建基于Azure DevOps的Power BI管理仪表盘时，使用OData查询获取工作项数据，未关联任务的工作项会返回空的Descendants数组，导致Power BI因架构不一致报错。尝试添加$compute处理空值时触发Azure DevOps内部错误（VS403483/TF400898）。

原查询问题分析 #

原查询通过$expand=Descendants($apply=...)聚合子任务的剩余工作量，但无任务的工作项返回空Descendants数组，Power BI无法识别动态变化的字段结构。而后续添加的$compute尝试直接引用Descendants/RemainingWorkSum和Descendants/@odata.count，因Azure DevOps OData预览版对集合类型导航属性的嵌套引用支持有限，触发内部解析错误。

解决方案 #

方案1：调整OData查询，在WorkItems层面计算总剩余工作量 #

使用$apply在工作项级别直接聚合子任务的剩余工作量，并用coalesce处理空值为0，确保所有返回结果都包含RemainingWorkTotal字段：

https://analytics.dev.azure.com/{organisation}/{project}/_odata/v3.0-preview/WorkItems?
  $filter=State ne 'Removed' and State ne 'Done'
  &$expand=Iteration($select=IterationPath),Area($select=AreaPath)
  &$apply=compute(
    coalesce(
      aggregate(Descendants/$filter(WorkItemType eq 'Task')/RemainingWork, sum), 
      0
    ) as RemainingWorkTotal
  )
  &$select=WorkItemId,Title,WorkItemType,State,CreatedDate,Custom_CostSaving,Iteration,Area,RemainingWork,RemainingWorkTotal
  &$orderby=CreatedDate desc

该查询通过aggregate直接计算符合条件的子任务剩余工作量总和，coalesce确保无任务时返回0，避免空字段导致的架构问题。

方案2：在Power BI端处理空值（更简单可靠） #

如果OData查询调整遇到限制，可直接在Power Query编辑器中处理空数组：

• 导入OData数据后，进入Power Query编辑器
• 找到Descendants列，点击展开按钮，选择RemainingWorkSum字段（若提示"没有要展开的列"，可先确认数据类型）
• 展开后，选中RemainingWorkSum列，点击转换->替换值，将空值替换为0
• 重命名该列为RemainingWorkTotal，加载数据到Power BI
  此方法绕过OData查询的限制，直接在Power BI内部统一字段结构，避免架构变化报错。

补充说明 #

Azure DevOps Analytics的OData v3.0-preview仍处于预览阶段，对复杂嵌套聚合和$compute的支持存在局限性，优先选择Power BI端处理可减少查询层面的兼容性问题。

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