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

FHIR 服务入门

本文概述了在 Azure Health Data Services 中 开始使用 FHIR 服务的基本步骤。

作为先决条件,需要一个 Azure 订阅,并已获得适当的权限来创建 Azure 资源组并部署 Azure 资源。 可以执行所有步骤,或者如果已有环境,可以跳过某些步骤。 此外,可以组合所有步骤并在 PowerShell、Azure CLI 和 REST API 脚本中完成这些步骤。

Get started with the FHIR service flow diagram.

在 Azure 订阅中创建工作区

可以从Azure 门户或使用 PowerShell、Azure CLI 和 REST API 创建工作区。 可以从 Azure Health Data Services 示例中找到脚本

注意

可以在每个 Azure 订阅中创建的工作区数和 FHIR 服务实例数有限制。

在工作区中创建 FHIR 服务

可以从Azure 门户或使用 PowerShell、Azure CLI 和 REST API 创建 FHIR 服务实例。 可以从 Azure Health Data Services 示例中找到脚本

(可选)可以在工作区中创建 DICOM 服务和MedTech 服务

访问 FHIR 服务

FHIR 服务受无法禁用的 Microsoft Entra ID 保护。 若要访问服务 API,必须创建一个客户端应用程序,该应用程序也称为 Microsoft Entra ID 中的服务主体,并向其授予适当的权限。

注册客户端应用程序

可以从Azure 门户或使用 PowerShell 和 Azure CLI 脚本创建或注册客户端应用程序。 此客户端应用程序可用于一个或多个 FHIR 服务实例。 它还可用于 Azure Health Data Services 中的其他服务。

如果客户端应用程序是使用证书或客户端密码创建的,请确保在过期之前续订证书或客户端密码,并替换应用程序中的客户端凭据。

可以删除客户端应用程序。 在删除客户端应用程序之前,请确保它不在生产、开发、测试或质量保证(QA)环境中使用。

授予访问权限

可以从Azure 门户或使用 PowerShell 和 Azure CLI 脚本授予访问权限或分配角色

执行创建、读取、更新和删除 (CRUD) 事务

可以对应用程序中的 FHIR 服务执行创建、读取(搜索)、更新和删除(CRUD)事务或使用 Postman、REST 客户端和 cURL 等工具。 由于 FHIR 服务默认受到保护,因此必须获取访问令牌并将其包含在事务请求中。

获取访问令牌

可以使用 PowerShell、Azure CLI、REST CCI 或 .NET SDK 获取 Microsoft Entra 访问令牌。 有关详细信息,请参阅 “获取访问令牌”。

使用现有工具进行访问

加载数据

可以直接使用 POST 或 PUT 方法对 FHIR 服务加载数据。 若要批量加载数据,可以使用下面列出的开源工具之一。

  • FHIR 加载程序 这是一个 .NET 控制台应用,并将存储在 Azure 存储中的数据加载到 FHIR 服务。 它是单个线程应用,但可以在本地或 Docker 容器中运行多个副本。
  • FHIR 大容量加载程序 此工具是一个 Azure 函数应用(微服务),在并行线程中运行。
  • 批量导入 此工具仅适用于开源 FHIR 服务器。 但是,它将来将可用于 Azure Health Data Services。

CMS、搜索、配置文件验证和重新编制索引

可以在 FHIR 服务文档中找到有关互操作性和患者访问、搜索、配置文件验证和重新编制索引的更多详细信息。

导出数据

(可选)可以将($export)数据导出到Azure 存储并在分析或机器学习项目中使用它。 可以按格式导出数据“原样”或 de-idndjson

还可以使用开源项目将数据导出到 Synapse 。 将来,此功能将集成到托管服务。

转换数据

(可选)可以将 HL7 v2 和其他格式数据转换为 FHIR。

在 Power BI 仪表板中使用 FHIR 数据

(可选)可以使用 FHIR 数据创建 Power BI 仪表板报表。

后续步骤

本文介绍了开始使用 FHIR 服务的基本步骤。 有关在 Azure Health Data Services 工作区中部署 FHIR 服务的信息,请参阅

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