将数据转换为 FHIR 用于 Azure API for FHIR

FHIR® 服务中的 $convert-data 自定义终结点用于将数据从不同的数据类型转换为 FHIR。 它使用 Liquid 模板引擎和来自 FHIR 转换器项目的模板作为默认模板。 可根据需要自定义这些转换模板。

目前，$convert-data 自定义终结点支持四种类型的数据转换：

使用 $convert-data 终结点

该 $convert-data 操作已集成到 FHIR 服务中，以作为服务的一部分运行。 在服务器中启用 $convert-data 后，可以使用 https://<<FHIR service base URL>>/$convert-data 对服务器进行 API 调用，将数据转换为 FHIR。

参数资源

$convert-data 会在请求正文中采用参数资源，如下表所述。 在 API 调用请求正文中，将包含以下参数：

示例请求

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

示例响应

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
      "resource": {
        "resourceType": "Patient",
        "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
        ...
        ...
      "request": {
        "method": "PUT",
        "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
      }
    }
  ]
}

自定义模板

可使用 Visual Studio Code 的 FHIR 转换器扩展根据需要自定义模板。 此扩展提供交互式编辑体验，让你能够轻松地下载 Microsoft 发布的模板和示例数据。 有关更多详细信息，请参阅扩展中的文档。

托管并使用模板

建议在 ACR 上托管自己的模板副本。 托管自己的模板副本以及在 $convert-data 操作中使用这些模板涉及四个步骤：

1. 向 Azure 容器注册表推送模板。
2. 在 Azure API for FHIR 实例上启用托管标识。
3. 提供 ACR 对 Azure API for FHIR 托管标识的访问权限。
4. 在 Azure API for FHIR 中注册 ACR 服务器。
5. （可选）配置 ACR 防火墙以进行安全访问。

向 Azure 容器注册表推送模板

创建 ACR 实例后，可以使用 FHIR 转换器扩展 中的“FHIR 转换器：推送模板”命令将自定义模板推送到 ACR。 另外，还可使用模板管理 CLI 工具。

在 Azure API for FHIR 上启用托管标识

在 Azure 门户中浏览到 Azure API for FHIR 服务的实例，然后选择“标识”边栏选项卡。 将状态更改为“开”，以在 Azure API for FHIR 中启用托管标识。

提供 ACR 对 Azure API for FHIR 的访问权限

1. 浏览到“访问控制 (IAM)”边栏选项卡。

2. 依次选择“添加”和“添加角色分配”，以打开“添加角色分配”页。

3. 分配 AcrPull 角色。

   

若要详细了解如何在 Azure 门户中分配角色，请参阅 Azure 内置角色。

在 Azure API for FHIR 中注册 ACR 服务器

可以使用 Azure 门户或使用 CLI 注册 ACR 服务器。

使用 Azure 门户注册 ACR 服务器

浏览到 Azure API for FHIR 实例中“数据转换”下的“项目”边栏选项卡。 你会看到当前已注册的 ACR 服务器的列表。 选择“添加”，然后从下拉菜单中选择注册表服务器。 需要选择“保存”才能使注册生效。 应用更改并重启实例可能需要几分钟时间。

使用 CLI 注册 ACR 服务器

最多可在 Azure API for FHIR 中注册 20 台 ACR 服务器。

如果需要，请从 Azure PowerShell 安装 Azure Health Data Services CLI：

az extension add -n healthcareapis

按照以下示例，将 ACR 服务器注册到 Azure API for FHIR：

注册一个 ACR 服务器

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

注册多个 ACR 服务器

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

配置 ACR 防火墙

在门户中为 Azure 存储帐户选择“网络”。

选择“所选网络”。

在“防火墙”部分下面的“地址范围”框中指定 IP 地址。 添加 IP 范围，以允许从 Internet 或本地网络进行访问。

你会在下表中找到预配了 Azure API for FHIR 服务的 Azure 区域的 IP 地址。

验证

调用 $convert-data API，在 templateCollectionReference 参数中指定模板引用。

<RegistryServer>/<imageName>@<imageDigest>

后续步骤

在本文中，你已了解 Azure API for FHIR 的数据转换。 有关适用于 Azure API for FHIR 的相关 GitHub 项目的详细信息，请参阅