MedTech サービスマッピングデバッガーの使用方法 (プレビュー)

2025-04-10

重要

2025 年 2 月 26 日の時点で、MedTech サービスは、英国西部、アラブ首長国連邦北部、南アフリカ北部、カタール中部のリージョンでは利用できなくなります。

重要

この機能は現在パブリックプレビューで使用でき、変更される可能性があります。詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。

この記事では、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 の宛先マッピングのトラブルシューティングを行う方法

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

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

注

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

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

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

注

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

$[Enter manually]$手動で入力$ ボックスのスクリーンショット。検証済みのテストデバイスメッセージがボックスに表示されています。$

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