You need to enable JavaScript to run this app. Excel Power Query自定义函数适配:实现NPI值API查询无结果的错误捕获
优惠活动
大模型
产品
解决方案
定价
更多

Excel Power Query自定义函数适配:实现NPI值API查询无结果的错误捕获

Power Query NPI查询函数错误捕获优化

原有代码的报错触发逻辑

现有自定义函数在三类场景下会直接抛出全局错误,中断全量批量执行:

  • NPPES接口返回的结果集为空(待查NPI无匹配注册记录)
  • 接口调用出现网络超时、服务端临时故障
  • 返回的Json层级不符合预设的字段取值逻辑
    这类场景下直接索引空数组的results{0}步骤会触发索引越界,导致整个批量流程终止,无法跑完2000条NPI的查询任务。

优化实现规则

所有易触发报错的关键计算步骤统一用Power Query内置的try异常捕获逻辑包裹,遇到错误时不中断流程,返回与正常输出结构完全一致的结果表,在对应行标记错误信息,保障全量任务完整执行。

优化后可直接使用的自定义函数代码

let
    NPI查询函数 = (待查询NPI as text) =>
    let
        执行查询 = try
            let
                接口响应 = Json.Document(Web.Contents("https://npiregistry.cms.hhs.gov/api/?version=2.1&number=" & 待查询NPI)),
                结果列表 = 接口响应[results],
                匹配结果首条 = 结果列表{0},
                地址集合 = 匹配结果首条[addresses],
                首条地址 = 地址集合{0},
                地址转表 = Record.ToTable(首条地址),
                移除名称列 = Table.RemoveColumns(地址转表, {"Name"}),
                跳过前4行 = Table.Skip(移除名称列, 4),
                过滤空行 = Table.SelectRows(跳过前4行, each not List.IsEmpty(List.RemoveMatchingItems(Record.FieldValues(_), {"", null})))
            in
                过滤空行
        otherwise
            // 异常场景返回与正常输出结构完全一致的表,避免展开时的结构不匹配错误
            Table.FromRecords({[Value = "查询失败:无匹配NPI记录/接口调用异常"]})
    in
        执行查询
in
    NPI查询函数

批量使用注意事项

  • 调用函数前建议把待查询的NPI编号统一转为文本格式,避免数字格式带科学计数法导致接口匹配失效
  • 全量执行2000条NPI查询时,单条记录的查询异常不会中断整体流程:有有效匹配的行会返回对应地址信息,无匹配的行会直接在对应位置显示错误提示
  • 无需调整原有主查询的列展开逻辑,因为异常返回的表列结构与正常输出完全对齐

内容的提问来源于stack exchange,提问作者Jad Driggers

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 22:36:04