你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

适用于 Azure API for FHIR 的 Da Vinci Plan Net

重要

Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略在该日期之前转换到 Azure Health Data Services FHIR® 服务。 由于 Azure API for FHIR 停用,在 2025 年 4 月 1 日开始前不会允许新的部署。 Azure Health Data Services FHIR 服务是 Azure API for FHIR 的演化版本,可让客户管理 FHIR、DICOM 和医疗技术服务,并集成到其他 Azure 服务。

在本教程中,我们将演练如何在 Azure API for FHIR 中设置 FHIR® 服务,以通过 Da Vinci PDEX Payer Network (Plan-Net) 实施指南 (IG) 的 Touchstone 测试。

Touchstone 功能语句

我们将重点介绍的第一个测试是针对 Da Vinci Plan-Net 功能语句测试 Azure API for FHIR。 如果在没有任何更新的情况下运行此测试,测试将因缺少搜索参数和配置文件而失败。

定义搜索参数

作为 Da Vinci Plan-Net IG 的一部分,你需要为医疗保健服务、保险计划、从业者角色、组织和组织附属资源定义六个新的搜索参数。 所有六个参数都在功能语句中测试。

注意

在这些搜索参数的原始 JSON 中,名称设置为 Plannet_sp_<Resource Name>_<SearchParameter Name>。 Touchstone 测试预计这些参数的名称将仅为 SearchParameter Name(覆盖区域、计划类型或网络)。

Da Vinci Plan-Net IG 所需的其余搜索参数由基本规范定义,并且已在 Azure API for FHIR 中提供,而无需任何其他更新。

存储配置文件

在定义搜索参数之外,需要加载所需的配置文件和扩展才能通过此测试。 Da Vinci Plan-Net IG 使用了九个配置文件。

示例 rest 文件

为了帮助创建这些搜索参数和配置文件,我们在开放源代码网站上提供了示例 http 文件,它在单个文件中包含了上述所有步骤。 上传所有必要的配置文件和搜索参数后,可以在 Touchstone 中运行功能语句测试。

Da Vinci plan net 示例 rest 测试执行脚本通过

Touchstone 错误处理测试

我们将演练的第二个测试是测试错误处理。 唯一必须执行的步骤是从数据库中删除 HealthcareService 资源,并在测试中使用已删除的 HealthcareService 资源的 ID。 开源站点中的示例 DaVinci_PlanNet.http 文件提供了针对此步骤进行发布和删除的示例 HealthcareService。

Da Vinci plan net touchstone 错误测试执行脚本通过

Touchstone 查询测试

我们将演练的下一个测试是查询功能测试。 这会测试你在第一次测试中加载的配置文件的一致性。 你需要加载与配置文件一致的资源。 建议针对数据库中已有的资源进行测试。 我们还有一个 DaVinci_PlanNet_Sample_Resources.http 文件,其中包含从 IG 的示例中提取的示例资源,可用于创建资源并针对其进行测试。

Da Vinci plan net 查询测试失败

注意

使用提供的示例资源,查询测试的成功率预计为 98%。 存在一个针对 FHIR 服务器的未结 GitHub 问题,这将导致其中一个测试失败。

如果资源同时满足基本条件和 _include 条件,则会返回多次。 有关详细信息,请参阅问题 #2037

后续步骤

在本教程中,我们演练了如何设置 Azure API for FHIR,以通过《Da Vinci PDEX Payer Network (Plan-Net) 实施指南》的 Touchstone 测试。 有关 Azure API for FHIR 中支持的功能的详细信息,请参阅

注意

FHIR® 是 HL7 的注册商标,经 HL7 许可使用。