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

针对 Azure API for FHIR 的适用于 Blue Button® 的 CARIN 实现指南

重要

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®，以通过适用于 Blue Button 的 CARIN 实现指南 (C4BB IG) 的 Touchstone 测试。

Touchstone 功能语句

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

定义搜索参数

作为 C4BB IG 的一部分，你需要为 ExplanationOfBenefit 资源定义三个新的搜索参数。 其中两个（type 和 service-date）在功能声明中进行测试，另一个 (insurer) 是 _include 搜索所需的。

• type
• service-date
• insurer

注意

在这些搜索参数的原始 JSON 中，名称设置为 ExplanationOfBenefit_<SearchParameter Name>。 Touchstone 测试预期这些参数的名称为 type、service-date、insurer。

C4BB IG 所需的其余搜索参数由基本规范定义，并且已在 Azure API for FHIR 中提供，无需其他更新。

存储配置文件

在定义搜索参数之外，通过此测试需要进行的另一项更新是加载所需的配置文件。 C4BB IG 中定义了八个配置文件。

• C4BB Coverage
• C4BB ExplanationOfBenefit Inpatient Institutional
• C4BB ExplanationOfBenefit Outpatient Institutional
• C4BB ExplanationOfBenefit Pharmacy
• C4BB ExplanationOfBenefit Professional NonClinician
• C4BB Organization
• C4BB Patient
• C4BB Practitioner

示例 rest 文件

为了帮助创建这些搜索参数和配置文件，我们提供了一个示例 http 文件，它在一个文件中包含了此教程中所述的所有步骤。 上传所有必要的配置文件和搜索参数后，可以在 Touchstone 中运行功能语句测试。

Touchstone 读取测试

测试了功能声明后，针对 C4BB IG 测试 Azure API for FHIR 中的读取功能。 这是针对你在第一次测试中加载的八个配置文件的一致性测试。 你需要加载符合配置文件的资源。 建议针对数据库中已有的资源进行测试，但我们也提供了一个 http 文件，其中包含从 IG 的示例中提取的示例资源，可用于创建资源并对其进行测试。

Touchstone EOB 查询测试

我们将探讨的下一个测试是 EOB 查询测试。 如果你已完成读取测试，则你已加载你需要的所有数据。 此测试会验证你是否可以使用各种参数搜索特定的 Patient 和 ExplanationOfBenefit 资源。

Touchstone 错误处理测试

我们演练的最后一个测试是测试错误处理。 唯一需要执行的步骤是从数据库中删除 ExplanationOfBenefit 资源，并在测试中使用已删除的 ExplanationOfBenefit 资源的 ID。

后续步骤

在本教程中，我们演练了如何在 Touchstone 中通过适用于 Blue Button 的 CARIN IG 测试。 接下来，你可以查看如何测试 Da Vinci 药物清单测试。

DaVinci 药物清单

注意

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