如何使用醫療技術服務對應偵錯工具 (預覽版)

文章
05/16/2024

重要

這項功能目前可供公開預覽使用，而且可能會變更。如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

在本文中，瞭解如何使用醫療技術服務對應偵錯工具。對應偵錯工具是一項自助式工具，用於建立、更新及疑難排解醫療技術服務裝置和 FHIR® 目的地對應。對應偵錯工具可讓您輕鬆即時檢視和進行內嵌調整，無需離開 Azure 入口網站。對應偵錯工具也可用來上傳測試裝置訊息，以查看處理為規範訊息並轉換成 FHIR 觀察之後看起來的樣子。

提示

若要瞭解醫療技術服務如何將訊息資料轉換和保存為 FHIR 服務，請參閱醫療技術服務裝置資料處理階段的概觀。

以下影片介紹對應偵錯工具的概觀：

對應偵錯工具概觀

若要存取醫療技術服務的對應偵錯工具，請選取 Azure 入口網站上醫療技術服務內的對應偵錯工具。針對此文章，我們使用名為 mt-azuredocsdemo 的醫療技術服務。選取您自己的醫療技術服務。在此畫面中，我們可以看到對應偵錯工具呈現與此醫療技術服務相關聯的裝置和 FHIR 目的地對應，並提供這些對應的驗證。
對應偵錯工具提供方便的功能，可協助更輕鬆地管理、編輯和疑難排解裝置和 FHIR 目的地對應。

上傳 - 使用此選項，您可以上傳：
- 裝置對應：可以編輯和儲存至醫療技術服務 (選用)。
- FHIR 目的地對應：可以編輯和儲存至醫療技術服務 (選用)。
- 測試裝置訊息：由驗證服務根據提供的對應產生樣本正規化測量和 FHIR 觀察。
下載 - 使用此選項，您可以下載下列複本：
- 裝置對應：醫療技術服務目前使用的裝置對應。
- FHIR 目的地對應：醫療技術服務目前使用的 FHIR 目的地對應。
- 對應：醫療技術服務目前兩個對應皆可使用

如何使用對應偵錯工具針對醫療技術服務和 FHIR 目的地對應進行疑難排解

針對此疑難解答範例，我們會使用透過 Azure IoT 中樞路由傳送訊息的測試裝置訊息，以及使用IotJsonPathContent 範本的裝置對應。

如果裝置或 FHIR 目的地對應發生錯誤，對應偵錯工具會顯示問題。在此範例中，我們可以看到裝置對應中第 12 行以及 FHIR 目的地對應中第 20 行的錯誤警告。
如果您將滑鼠游標放在錯誤警告上方，對應偵錯工具會提供更多錯誤資訊。
我們使用對應偵錯工具所提供的建議，現在已修正錯誤警告。我們已準備好選取儲存，以認可更新的裝置和 FHIR 目的地對應至醫療技術服務。

注意

醫療技術服務只會儲存已變更/更新的對應。例如：如果您只對裝置對應進行變更，則只有這些變更會儲存至您的醫療技術服務，而且不會將任何變更儲存至 FHIR 目的地對應。這是設計及協助醫療技術服務的效能。
成功儲存裝置和 FHIR 目的地對應之後，就會在 Azure 入口網站內建立來自通知的確認。

檢視標準化訊息和 FHIR 觀察

對應偵錯工具可讓您藉由提供測試裝置訊息來檢視正規化和 FHIR 轉換階段的範例輸出。選取上傳並測試裝置訊息。
選取檔案方塊隨即開啟。在此範例中，請選取手動輸入。
將測試裝置訊息複製/貼上或輸入到上傳測試裝置訊息方塊。如果任一對應有錯誤/警告，則驗證方塊仍為紅色。只要沒有錯誤則為綠色，測試裝置訊息與提供的裝置和 FHIR 目的地對應有效。

注意

如果已從 Azure IoT 中樞路由傳送訊息，則對應偵錯工具也會顯示擴充在測試裝置訊息上執行的擴充 (例如：新增 Body、 Properties、和 SystemProperties 元素)。

選取右上角的 X，以關閉上傳測試裝置訊息方塊。
上傳有效的測試裝置訊息之後，可使用檢視正規化訊息 並檢視 FHIR 觀察按鈕，以便檢視正規化和 FHIR 轉換階段的範例輸出。這些範例輸出可用來驗證您的裝置，且已正確設定 FHIR 目的地對應，以根據您的需求處理裝置訊息。
使用角落中的 X，關閉正規化訊息和 FHIR 觀察方塊。