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
相关产品推荐
相关产品推荐

