你当前正在访问 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 使用了九个配置文件。
- Plan-Net Endpoint
- Plan-Net Healthcare Service
- Plan-Net InsurancePlan
- Plan-Net Location
- Plan-Net Network
- Plan-Net Organization
- Plan-Net OrganizationAffiliation
- Plan-Net Practitioner
- Plan-Net PractitionerRole
示例 rest 文件
为了帮助创建这些搜索参数和配置文件,我们在开放源代码网站上提供了示例 http 文件,它在单个文件中包含了上述所有步骤。 上传所有必要的配置文件和搜索参数后,可以在 Touchstone 中运行功能语句测试。
Touchstone 错误处理测试
我们将演练的第二个测试是测试错误处理。 唯一必须执行的步骤是从数据库中删除 HealthcareService 资源,并在测试中使用已删除的 HealthcareService 资源的 ID。 开源站点中的示例 DaVinci_PlanNet.http 文件提供了针对此步骤进行发布和删除的示例 HealthcareService。
Touchstone 查询测试
我们将演练的下一个测试是查询功能测试。 这会测试你在第一次测试中加载的配置文件的一致性。 你需要加载与配置文件一致的资源。 建议针对数据库中已有的资源进行测试。 我们还有一个 DaVinci_PlanNet_Sample_Resources.http 文件,其中包含从 IG 的示例中提取的示例资源,可用于创建资源并针对其进行测试。
注意
使用提供的示例资源,查询测试的成功率预计为 98%。 存在一个针对 FHIR 服务器的未结 GitHub 问题,这将导致其中一个测试失败。
如果资源同时满足基本条件和 _include
条件,则会返回多次。 有关详细信息,请参阅问题 #2037。
后续步骤
在本教程中,我们演练了如何设置 Azure API for FHIR,以通过《Da Vinci PDEX Payer Network (Plan-Net) 实施指南》的 Touchstone 测试。 有关 Azure API for FHIR 中支持的功能的详细信息,请参阅
注意
FHIR® 是 HL7 的注册商标,经 HL7 许可使用。