共用方式為


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

重要

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

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

提示

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

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

對應偵錯工具概觀

  1. 若要存取醫療技術服務的對應偵錯工具,請選取 Azure 入口網站上醫療技術服務內的對應偵錯工具。 針對此文章,我們使用名為 mt-azuredocsdemo 的醫療技術服務。 選取您自己的醫療技術服務。 在此畫面中,我們可以看到對應偵錯工具呈現與此醫療技術服務相關聯的裝置和 FHIR 目的地對應,並提供這些對應的驗證

    Screenshot of the Mapping debugger main screen.

  2. 對應偵錯工具提供方便的功能,可協助更輕鬆地管理、編輯和疑難排解裝置和 FHIR 目的地對應。

    Screenshot of the Mapping debugger main screen with Upload and Download buttons highlighted.

    上傳 - 使用此選項,您可以上傳:

    • 裝置對應:可以編輯和儲存至醫療技術服務 (選用)。
    • FHIR 目的地對應:可以編輯和儲存至醫療技術服務 (選用)。
    • 測試裝置訊息:由驗證服務根據提供的對應產生樣本正規化測量和 FHIR 觀察。

    下載 - 使用此選項,您可以下載下列複本:

    • 裝置對應:醫療技術服務目前使用的裝置對應。
    • FHIR 目的地對應:醫療技術服務目前使用的 FHIR 目的地對應。
    • 對應:醫療技術服務目前兩個對應皆可使用

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

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

  1. 如果裝置或 FHIR 目的地對應發生錯誤,對應偵錯工具會顯示問題。 在此範例中,我們可以看到裝置對應第 12 行以及 FHIR 目的地對應第 20 行的錯誤警告

    Screenshot of the Mapping debugger with device and FHIR destination mappings warnings.

  2. 如果您將滑鼠游標放在錯誤警告上方,對應偵錯工具會提供更多錯誤資訊。

    Screenshot of the Mapping debugger with error details for the device mappings warning.

  3. 我們使用對應偵錯工具所提供的建議,現在已修正錯誤警告。 我們已準備好選取儲存,以認可更新的裝置和 FHIR 目的地對應至醫療技術服務。

    Screenshot of the Mapping debugger and the Save button.

    注意

    醫療技術服務只會儲存已變更/更新的對應。 例如:如果您只對裝置對應進行變更,則只有這些變更會儲存至您的醫療技術服務,而且不會將任何變更儲存至 FHIR 目的地對應。 這是設計及協助醫療技術服務的效能。

  4. 成功儲存裝置和 FHIR 目的地對應之後,就會在 Azure 入口網站內建立來自通知的確認。

    Screenshot of the Mapping debugger and a successful the save of the device and FHIR destination mappings.

檢視標準化訊息和 FHIR 觀察

  1. 對應偵錯工具可讓您藉由提供測試裝置訊息來檢視正規化和 FHIR 轉換階段的範例輸出。 選取上傳測試裝置訊息

    Screenshot of the Mapping debugger and test device message box.

  2. 選取檔案方塊隨即開啟。 在此範例中,請選取手動輸入

    Screenshot of the Mapping debugger and Select a file box.

  3. 將測試裝置訊息複製/貼上或輸入到上傳測試裝置訊息方塊。 如果任一對應有錯誤/警告,則 驗證方塊仍為紅色。 只要沒有錯誤則為綠色,測試裝置訊息與提供的裝置和 FHIR 目的地對應有效。

    注意

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

    Screenshot of the Enter manually box with a validated test device message in the box.

    選取右上角的 X,以關閉上傳測試裝置訊息方塊。

  4. 上傳有效的測試裝置訊息之後,可使用檢視正規化訊息檢視 FHIR 觀察按鈕,以便檢視正規化和 FHIR 轉換階段的範例輸出。 這些範例輸出可用來驗證您的裝置,且已正確設定 FHIR 目的地對應,以根據您的需求處理裝置訊息。

    Screenshot View normalized message and View FHIR observation available.

  5. 使用角落中的 X,關閉正規化訊息FHIR 觀察方塊。

    Screenshot of the normalized message.

    Screenshot of the FHIR observation available.

下一步

醫療技術服務裝置資料對應概觀

醫療技術服務服務 FHIR 目的地對應概觀

醫療技術服務案例型對應範例概觀

注意

(FHIR®) 是 HL7 的註冊商標,在 HL7 的許可下使用。