MedTech サービスの FHIR 変換先マッピングの概要

[アーティクル]
11/18/2023

この記事では、MedTech サービスの FHIR® 変換先マッピングの概要について説明します。

MedTech サービスでは、Azure portal または Azure Resource Manager API を通じて MedTech サービスに追加される、2 種類の JSON マッピングが必要です。デバイスマッピングが 1 つ目の種類で、MedTech サービスに送信されたデバイスデータの値の、内部の正規化されたデータオブジェクトへのマッピングを制御します。デバイスマッピングには、種類、デバイス識別子、測定日時、測定値を抽出するために MedTech サービスによって使われる式が含まれます。 FHIR 変換先マッピングが 2 つ目の種類であり、正規化されたデータを FHIR 観察記録にマップする方法を制御します。

Note

デバイスと FHIR 変換先マッピングは、デバイスメッセージが処理されるたびに再評価されます。いずれのマッピングの更新もすべて即座に反映されます。

FHIR 変換先マッピングの基本

FHIR 変換先マッピングは、デバイスメッセージから抽出されて正規化されたデータを FHIR 観察記録にマップする方法を制御します。

特定の時点または 1 時間という期間にわたって観察を作成する必要がありますか。
観察にどのようなコードを追加する必要がありますか。
値を SampledData または Quantity として表す必要があるか?

これらのデータの種類はすべて、FHIR 変換先マッピングの構成で制御するオプションです。

デバイスデータが正規化されたデータモデルに変換された後、正規化されたデータが FHIR 観察記録への変換のために収集されます。観察記録の種類が SampledData の場合、データはデバイス識別子、測定の種類、期間 (期間は 1 時間または 24 時間) に従ってグループ化されます。このグループ化の出力は、そのデータの種類に対する期間を表す単一の FHIR 観察記録に変換するために送信されます。その他の観察記録の種類 (Quantity、CodeableConcept、String) のデータはグループ化されず、代わりに各測定値が特定の時点を表す単一の観察記録に変換されます。

ヒント

MedTech サービスが FHIR サービスに保存するためにデバイスメッセージデータを FHIR 観察記録に処理する方法について詳しくは、MedTech サービスでのデバイスメッセージの処理ステージの概要に関する記事をご覧ください。

次の図は、MedTech サービス内で変換ステージの間に行われることを示したものです。

Note

この図の FHIR 観察記録は、完全なリソースではありません。 FHIR 観察記録全体については、この概要の「例」をご覧ください。

CollectionFhir

CollectionFhir は、MedTech サービスの FHIR 変換先マッピングで使われるルートテンプレートの種類です。 CollectionFhir は、変換ステージで使われるすべてのテンプレートの一覧です。 CollectionFhir 内で 1 つ以上のテンプレートを定義し、正規化された各メッセージをすべてのテンプレートに対して評価できます。

CodeValueFhir

現在、FHIR 変換先マッピングでサポートされているテンプレートは CodeValueFhir だけです。これを使用すると、コード、有効期間、観察の値を定義できます。複数の値の種類 (SampledData、CodeableConcept、Quantity、String) がサポートされています。これらの構成可能な値と共に、Observation リソースの識別子と、適切な Device および Patient リソースへのリンクが自動的に処理されます。

重要

[Resolution type] (解決の種類) は、MedTech サービスがデバイスデータをデバイスリソースおよび患者リソースと関連付ける方法を指定します。 MedTech サービスは、デバイス識別子と患者識別子を使用して、FHIR サービスからデバイスと患者リソースを読み込みます。エンカウンター識別子が指定されており、デバイスデータのペイロードから抽出された場合、その識別子を持つエンカウンターが FHIR サービスに存在すると、それは観察記録にリンクされます。エンカウンター識別子は正常に正規化されたけれども、そのエンカウンター識別子を持つ FHIR エンカウンターが存在しない場合は、FhirResourceNotFound 例外がスローされます。 MedTech サービスの解決の種類の構成について詳しくは、「[宛先] タブを構成する」をご覧ください。

要素	説明	必須
typeName	このテンプレートのバインド先となる測定の種類。注: この同じ `typeName` を持つデバイスマッピングテンプレートが、少なくとも 1 つ存在する必要があります。 `typeName` 要素は、FHIR 変換先マッピングテンプレートを 1 つ以上のデバイスマッピングテンプレートにリンクするために使われます。同じ `typeName` 要素があるデバイスマッピングテンプレートによって、同じ `typeName` を持つ FHIR 変換先マッピングテンプレートで評価される正規化されたデータが生成されます。	正しい
periodInterval	作成された観察が表す期間。サポートされている値は、0 (1 インスタンス)、60 (1 時間)、1440 (1 日) です。	観察記録の種類が SampledData の場合は True。他の観察記録の種類では無視されます。
category	作成される観察の種類を分類する任意の数の CodeableConcepts。	いいえ
codes	作成された観察に適用する 1 つ以上の Codings。	正しい
codes[].code	`codes` 要素内の Coding に対するコード。	正しい
codes[].system	`codes` 要素内の Coding に対するシステム。	いいえ
codes[].display	`codes` 要素内の Coding に対する表示。	いいえ
value	観察で抽出して表す値。 `value` 要素に含まれる要素について詳しくは、「値の種類」をご覧ください。	`components` 要素が使われていない場合は true (観察記録の種類が CodebleConcept ではない場合。CodebleConcept である場合は、この要素は "必須ではない" だけでなく無視されます)。
components	観察に対して作成する 1 つ以上のコンポーネント。	`value` 要素が代わりに使われていない場合は true。
components[].codes	コンポーネントに適用する 1 つ以上の Codings。	いいえ
components[].value	コンポーネントで抽出して表す値。 `components[].value` 要素に含まれる要素について詳しくは、「値の種類」をご覧ください。	`components` 要素が使われている場合は true (観察記録の種類が CodebleConcept ではない場合。CodebleConcept である場合は、この要素は "必須ではない" だけでなく無視されます)。

値型

すべての CodeValueFhir テンプレートの value 要素には、次の要素が含まれます。

要素	説明	必須
valueType	値の種類。この値は、値の種類に応じて "SampledData"、"Quantity"、"CodeableConcept"、または "String" になります。	正しい
valueName	値の名前。	`valueType` が CodeableConcept でない場合は true。

MedTech サービスの FHIR 変換先マッピングでは、以下の値の種類がサポートされています。

SampledData

SampledData FHIR データの種類を表します。観察記録の測定値は、ある時点から始まり、定義された期間を使って前方にインクリメントする値ストリームに書き込まれます。値が存在しない場合は、E がデータストリームに書き込まれます。 2 つ以上の値がデータストリーム内の同じ位置を占めている期間の場合は、最新の値が使われます。 SampledData を使用した観察が更新されるときは、同じロジックが適用されます。値の種類が SampledData である CodeValueFhir テンプレートの場合、テンプレートの value 要素には次の要素が含まれます。

要素	説明	必須
defaultPeriod	使用する既定の時間 (ミリ秒単位)。	正しい
ユニット	SampledData の原点に設定する単位。	正しい

品質

FHIR データ型の Quantity を表します。この種類では、単一の特定時点の観察記録が作成されます。同じデバイス識別子、測定の種類、タイムスタンプを含む新しい値が到着すると、前の観察記録が新しい値に更新されます。値の種類が Quantity である CodeValueFhir テンプレートの場合、テンプレートの value 要素には次の要素が含まれます。

要素	説明	必須
ユニット	単位の表記。	いいえ
code	単位のコード化された形式。	いいえ
system	コード化された単位の形式を定義するシステム。	いいえ

CodeableConcept

FHIR データ型 CodeableConcept を表します。正規化されたデータモデルの値は使われず、この種類のデータを受け取ったときは代わりに、観察記録が特定の時点で記録されたことを表す特定のコードを使って観察記録が作成されます。値の種類が CodeableConcept である CodeValueFhir テンプレートの場合、テンプレートの value 要素には次の要素が含まれます。

要素	説明	必須
text	プレーンテキスト表現。	いいえ
codes	作成された観察に適用する 1 つ以上の Codings。	正しい
codes[].code	`codes` 要素内の Coding に対するコード。	正しい
codes[].system	`codes` 要素内の Coding に対するシステム。	いいえ
codes[].display	`codes` 要素内の Coding に対する表示。	いいえ

String

String FHIR データの種類を表します。この種類では、単一の特定時点の観察記録が作成されます。同じデバイス識別子、測定の種類、タイムスタンプを含む新しい値が到着すると、前の観察記録が新しい値に更新されます。他の要素は定義されていません。

例

ヒント

MedTech サービスデバイスと FHIR 変換先マッピングの作成、更新、トラブルシューティングを支援するために、MedTech サービスのマッピングデバッガーを使用できます。マッピングデバッガーにより、Azure portal から離れることなく、インライン調整の確認と実行をリアルタイムで簡単に行えるようになります。マッピングデバッガーは、テストデバイスメッセージをアップロードし、正規化メッセージに処理されて FHIR 観察記録に変換された後の表示を確認するためにも使用できます。

Note

この例と正規化されたメッセージは、「MedTech サービスのデバイスマッピングの概要」のものを引き続き使っています。

この例では、heartRate データをキャプチャする正規化されたメッセージを使っています。

[
  {
    "type": "heartrate",
    "occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
    "deviceId": "device01",
    "properties": [
      {
        "name": "hr",
        "value": "78"
      }
    ]
  }
]

変換ステージには、次の FHIR 変換先マッピングを使っています。

{
  "templateType": "CollectionFhir",
  "template": [
    {
      "templateType": "CodeValueFhir",
      "template": {
        "codes": [
          {
            "code": "8867-4",
            "system": "http://loinc.org",
            "display": "Heart rate"
          }
        ],
        "typeName": "heartrate",
        "value": {
          "system": "http://unitsofmeasure.org",
          "code": "count/min",
          "unit": "count/min",
          "valueName": "hr",
          "valueType": "Quantity"
        }
      }
    }
  ]
}

変換ステージの後の結果の FHIR 観察記録は次のようになります。

[
  {
    "code": {
      "coding": [
        {
          "system": {
            "value": "http://loinc.org"
          },
          "code": {
            "value": "8867-4"
          },
          "display": {
            "value": "Heart rate"
          }
        }
      ],
      "text": {
        "value": "heartrate"
      }
    },
    "effective": {
      "start": {
        "value": "2023-03-13T22:46:01.8750000Z"
      },
      "end": {
        "value": "2023-03-13T22:46:01.8750000Z"
      }
    },
    "issued": {
      "value": "2023-04-05T21:02:59.1650841+00:00"
    },
    "value": {
      "value": {
        "value": 78
      },
      "unit": {
        "value": "count/min"
      },
      "system": {
        "value": "http://unitsofmeasure.org"
      },
      "code": {
        "value": "count/min"
      }
    }
  }
]

ヒント

MedTech サービスの一般的なデプロイエラーの修正については、「MedTech サービスのデプロイエラーのトラブルシューティング」をご覧ください。

MedTech サービスのエラーの修正については、「MedTech サービスログを使用したエラーのトラブルシューティング」をご覧ください。