MedTech サービスマッピングデバッガーを使用する方法

[アーティクル]
08/02/2023

重要

現在、この機能はパブリックプレビュー段階にあります。「Microsoft Azure プレビューの追加使用条件」を参照してください。

注意

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

この記事では、MedTech サービスマッピングデバッガーを使用する方法について説明します。マッピングデバッガーは、MedTech サービスデバイスと FHIR 宛先マッピングの作成、更新、トラブルシューティングに使用されるセルフサービスツールです。マッピングデバッガーを使用すると、Azure portalを離れることなく、リアルタイムで簡単にインライン調整を表示および行うことができます。マッピングデバッガーは、テストデバイスメッセージをアップロードするためにも使用して、正規化されたメッセージに処理され、FHIR Observations に変換された後にどのように見えるかを確認できます。

ヒント

MedTech サービスがデバイスメッセージデータを FHIR サービスに変換して永続化する方法については、「 MedTech サービスのデバイスデータ処理ステージの概要」を参照してください。

次のビデオでは、マッピングデバッガーの概要を示します。

マッピングデバッガーの概要

MedTech サービスのマッピングデバッガーにアクセスするには、Azure portalの MedTech サービス内で [マッピングデバッガー] を選択します。この記事では、 mt-azuredocsdemo という名前の MedTech サービスを使用しています。独自の MedTech サービスを選択します。この画面から、マッピングデバッガーで、この MedTech サービスに関連付けられているデバイスと FHIR の宛先マッピングが表示され、それらのマッピングの検証が提供されていることがわかります。
マッピングデバッガーには、デバイスと FHIR の宛先マッピングの管理、編集、トラブルシューティングを容易にするのに役立つ便利な機能が用意されています。

[アップロード] - この選択を使用して、次の内容をアップロードできます。
- デバイスマッピング: MedTech サービスに編集および保存 (省略可能) できます。
- FHIR 変換先マッピング: MedTech サービスに編集および保存 (省略可能) できます。
- テストデバイスメッセージ: 検証サービスによって使用され、指定されたマッピングに基づいて正規化された測定と FHIR 観測のサンプルを生成します。
ダウンロード - この選択により、次のコピーをダウンロードできます。
- デバイスマッピング: MedTech サービスで現在使用されているデバイスマッピング。
- FHIR 変換先マッピング: MedTech サービスで現在使用されている FHIR 変換先マッピング。
- マッピング: MedTech サービスで現在使用されている両方のマッピング

マッピングデバッガーを使用してデバイスと FHIR の宛先マッピングのトラブルシューティングを行う方法

このトラブルシューティングの例では、IotJsonPathContent テンプレートを使用するAzure IoT Hubとデバイスマッピングを介してルーティングされるメッセージであるテストデバイスメッセージを使用しています。

デバイスまたは FHIR の宛先マッピングにエラーがある場合は、マッピングデバッガーに問題が表示されます。この例では、デバイスマッピングの 12 行目と FHIR 宛先マッピングの 20 行目にエラー警告があることがわかります。
エラー警告の上にマウスカーソルを置くと、マッピングデバッガーにさらに多くのエラー情報が表示されます。
マッピングデバッガーによって提供される提案を使用しましたが、エラー警告は修正されています。 [保存] を選択して、更新されたデバイスと FHIR 宛先マッピングを MedTech サービスにコミットする準備ができました。

注意

MedTech サービスは、変更/更新されたマッピングのみを保存します。たとえば、 デバイスマッピングのみを変更した場合、それらの変更のみが MedTech サービスに保存され、 FHIR 変換先マッピングに変更は保存されません。これは仕様であり、MedTech サービスのパフォーマンスに役立ちます。
デバイスと FHIR の宛先マッピングが正常に保存されると、通知からの確認がAzure portal内に作成されます。

正規化されたメッセージと FHIR の監視を表示する

マッピングデバッガーを使用すると、テストデバイスメッセージを指定することで、正規化および FHIR 変換ステージのサンプル出力を表示できます。 [Upload and Test device message]\(デバイス メッセージのアップロードとテスト\) を選択します。
[ ファイルの選択 ] ボックスが開きます。この例では、[ 手動で入力] を選択します。
[テストデバイスの アップロード ] メッセージボックスにテストデバイスメッセージをコピー/貼り付けまたは入力します。いずれかのマッピングにエラー/警告がある場合は、[ 検証 ] ボックスが赤のままになることがあります。 エラーが緑色である限り、テストデバイスメッセージは、指定されたデバイスと FHIR の宛先マッピングで有効です。

注意

マッピングデバッガーでは、テストデバイスメッセージに対して実行されたエンリッチメントも表示されます (たとえば、Body、Properties、SystemProperties 要素の追加など)、Azure IoT Hubからルーティングされたメッセージが表示されます。

右上隅にある [X ] を選択して、[ テストデバイスのアップロード] メッセージ ボックスを閉じます。
有効なテストデバイスメッセージがアップロードされると、[ 正規化されたメッセージの表示 ] ボタンと [FHIR 監視の表示 ] ボタンが使用できるようになり、正規化と FHIR 変換ステージのサンプル出力を表示できるようになります。これらのサンプル出力を使用して、デバイスを検証し、FHIR 宛先マッピングが要件に従ってデバイスメッセージを処理するように適切に構成されていることを検証できます。
角の X を使用して、[ 正規化されたメッセージ ] ボックスと [FHIR] 観察 ボックスを閉じます。