$convertデータの概要

[アーティクル]
09/07/2023

注意

Fast Healthcare Interoperability Resources (FHIR®) は、オープンな医療仕様です。

FHIR サービスで操作を使用 $convert-data すると、正常性データをさまざまな形式から FHIR R4 データに変換できます。この操作では$convert-data、FHIR データ変換のために FHIR Converter プロジェクトの Liquid テンプレートが使用されます。これらの変換テンプレートは必要に応じてカスタマイズすることができます。現在、この操作では $convert-data 、次の 4 種類のデータ変換がサポートされています。

HL7v2 から FHIR R4
C-CDA から FHIR R4
JSON から FHIR R4 (カスタム変換マッピング用)
FHIR STU3 から FHIR R4

注意

エンドポイントを $convert-data ETL (抽出、変換、読み込み) パイプライン内のコンポーネントとして使用して、さまざまな形式 (HL7v2、CCDA、JSON、FHIR STU3 など) から FHIR 形式への正常性データの変換を行うことができます。正常性データを変換するときに、完全なワークフロー用の ETL パイプラインを作成できます。 Azure Logic Apps またはAzure Data Factoryに基づく ETL エンジンを使用することをお勧めします。たとえば、ワークフローには、データインジェスト、操作の実行 $convert-data 、検証、データの事前/後処理、データエンリッチメント、データ重複除去、 FHIR サービスでの永続化のためのデータの読み込みなどがあります。

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

操作は $convert-data 、REST API アクションとして FHIR サービスに統合されます。エンドポイントは $convert-data 次のように呼び出すことができます。

POST {{fhirurl}}/$convert-data

変換の正常性データは、要求の本文で FHIR サービスに $convert-data 配信されます。要求が成功した場合、FHIR サービスは FHIR バンドル応答を返し、データは FHIR R4 に変換されます。

パラメーター

操作呼び出しは $convert-data 、要求の本文内の JSON 形式のパラメーター内で変換のために正常性データをパッケージ化します。パラメーターについては次の表で説明します。

パラメーター名	説明	指定可能な値
inputData	FHIR に変換されるデータペイロード。	の場合 `Hl7v2`: string の場合 `Ccda`: XML の場合 `Json`: JSON の場合 `FHIR STU3`: JSON
inputDataType	データ入力の種類。	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Azure Container Registryの OCI イメージテンプレートコレクションへの参照。参照は、変換に使用する Liquid テンプレートを含む画像です。既定のテンプレートまたは FHIR サービス内に登録されているカスタムテンプレートイメージを参照できます。次のセクションでは、テンプレートのカスタマイズ、Azure Container Registryでのテンプレートのホスト、FHIR サービスへの登録について説明します。	既定/サンプルテンプレートの場合: HL7v2 テンプレート: `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` C-CDA テンプレート: `microsofthealth/ccdatemplates:default` JSON テンプレート: `microsofthealth/jsontemplates:default` FHIR STU3 テンプレート: `microsofthealth/stu3tor4templates:default` カスタムテンプレートの場合: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	データの変換中に使用するルートテンプレート。	HL7v2 の場合: ADT_A01、ADT_A02、ADT_A03、ADT_A04、ADT_A05、ADT_A08、 ADT_A11、ADT_A13、ADT_A14、ADT_A15、ADT_A16、ADT_A25、ADT_A26、ADT_A27、ADT_A28、ADT_A29、ADT_A31、ADT_A47、ADT_A60、OML_O21、ORU_R01、ORM_O01、VXU_V04、SIU_S12、SIU_S13、SIU_S14、SIU_S15、SIU_S16、 SIU_S17、SIU_S26、MDM_T01、MDM_T02 C-CDA の場合: CCD、ConsultationNote、DischargeSummary、HistoryandPhysical、OperativeNote、ProcedureNote、ProgressNote、ReferralNote、TransferSummary JSON の場合: ExamplePatient、Stu3ChargeItem FHIR STU3 の場合: FHIR STU3 リソース名 (例: Patient、Observation、Organization)

注意

FHIR STU3 から FHIR R4 テンプレートは、FHIR STU3 リソースと FHIR R4 仕様の同等のリソースとの間でのみフィールドの違いのマッピングを提供する Liquid テンプレートです。一部の FHIR STU3 リソースの名前が変更されたか、FHIR R4 から削除されます。 FHIR STU3 から FHIR R4 への変換のリソースの違いと制約の詳細については、「 FHIR STU3 から FHIR R4 への変換のリソースの相違点と制約」を参照してください。

注意

JSON テンプレートは、独自の変換マッピングを構築する際に使用するサンプルテンプレートです。これらは、定義済みの正常性データメッセージの種類に準拠する既定のテンプレート ではありません 。 JSON 自体は、HL7v2 や C-CDA とは異なり、正常性データ形式として指定されていません。そのため、既定の JSON テンプレートを提供する代わりに、独自のカスタマイズされたマッピングの開始点として使用できるサンプル JSON テンプレートがいくつか用意されています。

警告

既定のテンプレートは MIT ライセンスでリリースされ、Microsoft サポートではサポートされていません。

既定のテンプレートは、データ変換ワークフローの使用を開始するためにのみ提供されます。これらの既定のテンプレートは運用環境向けではなく、Microsoft が FHIR サービスの更新プログラムをリリースするときに変更される可能性があります。 FHIR サービスの異なるバージョン間で一貫したデータ変換動作を行うには、次の操作を行う必要があります。

Azure Container Registry インスタンスでテンプレートの独自のコピーをホストします。
テンプレートを FHIR サービスに登録します。
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": "batch",
    "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"
            }
        }
    ]
}

FHIR 変換の結果は、バッチとしての FHIR バンドルです。

FHIR バンドルは、FHIR R4 仕様 - バンドル - FHIR v4.0.1 の期待に沿っている必要があります。
特定のプロファイルに対して検証を行う場合は、FHIR $validate 操作を使用して後処理を行う必要があります。

次のステップ

この記事では、Azure Health Data Service の FHIR サービスを使用して、操作と、正常性データを FHIR R4 に変換するためにエンドポイントを使用する方法について $convert-data 説明しました。

Azure portalを使用するための設定を構成する$convert-data方法については、次を参照してください。

Azure portalを使用して$convertデータの設定を構成する

のトラブルシューティング $convert-data方法については、次を参照してください。

$convert データのトラブルシューティング

についてよく寄せられる質問 (FAQ) については、以下を $convert-data参照してください。

$convert データに関してよく寄せられる質問

FHIR®は、米国商標庁に登録されている Health Level Seven International の登録商標であり、その許可を得て使用しています。