データを Azure API for FHIR 用の FHIR に変換する

FHIR® サービスの $convert-data カスタム エンドポイントは、さまざまなデータ型から FHIR へのデータ変換を目的としています。 既定のテンプレートとして FHIR Converter プロジェクトのテンプレートと Liquid テンプレート エンジンが使用されます。 これらの変換テンプレートは必要に応じてカスタマイズすることができます。

現在、$convert-data カスタム エンドポイントでは、次の 4 種類のデータ変換がサポートされています。

$convert-data エンドポイントを使用する

$convert-data 操作は FHIR サービスに統合され、サービスの一部として実行されます。 サーバーで $convert-data を有効にすると、サーバーに対して API 呼び出しを行い、https://<<FHIR service base URL>>/$convert-data を使用してデータを FHIR に変換できます。

パラメーター リソース

$convert-data は、以下の表で説明されているように、要求本文で Parameter リソースを受け取ります。 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 Converter 拡張機能を使用して、必要に応じてカスタマイズすることができます。 この拡張機能は、対話型の編集エクスペリエンスを提供するものであり、Microsoft が公開しているテンプレートやサンプル データを簡単にダウンロードできるようになっています。 詳細については、拡張機能のドキュメントを参照してください。

テンプレートをホストして使用する

独自のテンプレートのコピーを ACR でホストすることをお勧めします。 独自のテンプレートのコピーをホストし、それらを $convert-data 操作で使用するには、次の 4 つの手順が必要です。

1. Azure Container Registry にテンプレートをプッシュします。
2. Azure API for FHIR インスタンスでマネージド ID を有効にします。
3. Azure API for FHIR マネージド ID に ACR のアクセス権を付与します。
4. Azure API for FHIR に ACR サーバーを登録します。
5. 必要に応じて、セキュリティで保護されたアクセス用に ACR ファイアウォールを構成します。

Azure Container Registry にテンプレートをプッシュする

ACR インスタンスを作成した後、FHIR Converter 拡張機能の FHIR Converter: Push Templates コマンドを使用して、カスタマイズされたテンプレートを ACR にプッシュします。 または、Template Management CLI ツールを使用できます。

Azure API for FHIR でマネージド ID を有効にする

Azure portal で Azure API for FHIR サービスのインスタンスにアクセスし、次に [ID] ブレードを選びます。 Azure API for FHIR でマネージド ID を有効にするには、状態を [オン] に変更します。

Azure API for FHIR に ACR のアクセス権を付与する

1. [アクセス制御 (IAM)] ブレードを参照します。

2. [追加] を選び、次に [ロールの割り当ての追加] を選び、[ロールの割り当ての追加] ページを開きます。

3. AcrPull ロールを割り当てます。

   

Azure portal でロールに割り当てる方法の詳細については Azure 組み込みロールに関するページを参照してください。

Azure API for FHIR に ACR サーバーを登録する

ACR サーバーは、Azure portal または CLI を使用して登録できます。

Azure portal を使用した ACR サーバーの登録

Azure API for FHIR インスタンスの [データ変換] の下にある [Artifacts] ブレードを参照します。 現在登録されている ACR サーバーの一覧が表示されます。 [追加] を選び、次にドロップダウン メニューからレジストリ サーバーを選びます。 登録を有効にするには、[保存] を選択する必要があります。 変更を適用してインスタンスを再起動するには、数分かかる場合があります。

CLI を使用した ACR サーバーの登録

Azure API for FHIR には、最大 20 台の ACR サーバーを登録することができます。

必要に応じて、Azure PowerShell から Azure Health Data Services CLI をインストールします。

az extension add -n healthcareapis

以下の例に従って、Azure API for FHIR に ACR サーバーを登録します。

1 台の 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 範囲を追加します。

以下の表には、Azure API for FHIR サービスがプロビジョニングされている Azure リージョンの IP アドレスが示されています。

確認

templateCollectionReference パラメーターにテンプレート参照を指定して $convert-data API を呼び出します。

<RegistryServer>/<imageName>@<imageDigest>

次のステップ

この記事では、Azure API for FHIR のデータ変換について説明しました。 Azure API for FHIR に関連する GitHub プロジェクトの詳細については、次を参照してください