You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/healthcare-apis/iot/how-to-use-mapping-debugger.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ author: msjasteppe
6
6
ms.service: healthcare-apis
7
7
ms.subservice: iomt
8
8
ms.topic: how-to
9
-
ms.date: 03/02/2023
9
+
ms.date: 03/03/2023
10
10
ms.author: jasteppe
11
11
---
12
12
@@ -15,11 +15,11 @@ ms.author: jasteppe
15
15
> [!NOTE]
16
16
> [Fast Healthcare Interoperability Resources (FHIR®)](https://www.hl7.org/fhir/) is an open healthcare specification.
17
17
18
-
In this article, you'll learn how to use the MedTech service Mapping debugger in the Azure portal. The Mapping debugger is a tool used for creating, updating, and troubleshooting the MedTech service device and FHIR destination mappings. The Mapping debugger can also be used for uploading test device messages to see how they'll look after being processed into normalized messages and transformed into FHIR observations for persistence in the FHIR service.
18
+
In this article, you'll learn how to use the MedTech service Mapping debugger in the Azure portal. The Mapping debugger is a tool used for creating, updating, and troubleshooting the MedTech service device and FHIR destination mappings. The Mapping debugger can also be used for uploading test device messages to see how they'll look after being processed into normalized messages and transformed into FHIR Observations for persistence in the FHIR service. This new self-service tool allows you to easily view and make inline adjustments in real-time, without ever having to leave the Azure portal.
19
19
20
20
## Overview of the Mapping debugger
21
21
22
-
1. To access the MedTech service's Mapping debugger, select **Mapping debugger** within your MedTech service on the Azure portal. For this article, we'll be using a MedTech service named **mt-azuredocsdemo**. You'll select your own MedTech service. From this screen, we can see that the Mapping debugger is presenting the conforming and valid device and FHIR destination mappings that are associated with this MedTech service, and has provided a **Validation** of those mappings.
22
+
1. To access the MedTech service's Mapping debugger, select **Mapping debugger** within your MedTech service on the Azure portal. For this article, we'll be using a MedTech service named **mt-azuredocsdemo**. You'll select your own MedTech service. From this screen, we can see the Mapping debugger is presenting the device and FHIR destination mappings associated with this MedTech service and has provided a **Validation** of those mappings.
23
23
24
24
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-main-screen.png" alt-text="Screenshot of the Mapping debugger main screen." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-main-screen.png":::
25
25
@@ -30,7 +30,7 @@ In this article, you'll learn how to use the MedTech service Mapping debugger in
30
30
**Upload** - With this selection, you can upload:
31
31
-**Device mapping**: Can be edited and saved (optional) to the MedTech service.
32
32
-**FHIR destination mapping**: Can be edited and saved (optional) to the MedTech service.
33
-
-**Test device message**: Used by the device and FHIR destination mappings (optional) to view a normalized message and FHIR observation based on the supplied mappings.
33
+
-**Test device message**: Used by the validation service to produce a sample normalized measurement and FHIR Observation based on the supplied mappings.
34
34
35
35
**Download** - With this selection you can download copies of:
36
36
-**Device mapping**: The device mapping currently used by your MedTech service.
@@ -58,21 +58,21 @@ In this article, you'll learn how to use the MedTech service Mapping debugger in
58
58
59
59
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-successful-save.png" alt-text="Screenshot of the Mapping debugger and a successful the save of the device and FHIR destination mappings." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-successful-save.png":::
60
60
61
-
## View a normalized message and FHIR observation
61
+
## View a normalized message and FHIR Observation
62
62
63
-
1. The Mapping debugger gives you the ability to view the output of the device mapping (normalized message) and FHIR destination mapping (FHIR observation). Select **Upload** and **Test device message**.
63
+
1. The Mapping debugger gives you the ability to view sample outputs of the normalization and FHIR transformation processes by supplying a test device message. Select **Upload** and **Test device message**.
64
64
65
65
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-select-upload-and-test-device-message.png" alt-text="Screenshot of the Mapping debugger and test device message box." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-select-upload-and-test-device-message.png":::
66
66
67
67
2. The **Select a file** box will open. For this example, we'll select **Enter manually**.
68
68
69
69
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-select-test-device-message-manual.png" alt-text="Screenshot of the Mapping debugger and Select a file box." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-select-test-device-message-manual.png":::
70
70
71
-
3. Copy/paste or type the test device message into the **Upload test device message** box making sure that the **Validation**and **No errors** messages are *green* (meaning that the test device message is conforming and valid). Once confirmed, select the **X** in the right corner to close the **Upload test device message** box.
71
+
3. Copy/paste or type the test device message into the **Upload test device message** box. The **Validation**box may still be *red* if the either of the mappings has an error/warning. As long as **No errors** is green, the test device message is valid. Select the **X** in the right corner to close the **Upload test device message** box.
72
72
73
73
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-input-test-device-message.png" alt-text="Screenshot of the Enter manually box with a validated test device message in the box." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-input-test-device-message.png":::
74
74
75
-
4. Once a conforming and valid test device is uploaded, the **View normalized message** and **View FHIR observation** buttons will become available so that you may view the test device message as a normalized message and FHIR observation. This process can be used to validate and your device and FHIR destination mappings are processing and persisting the test device message according to your requirement.
75
+
4. Once a conforming test device message is uploaded, the **View normalized message** and **View FHIR observation** buttons will become available so that you may view the sample outputs of the normalization and FHIR transformation processes. These sample outputs can be used to validate your device and FHIR destination mappings are properly configured for processing events according to your requirement.
@@ -84,7 +84,7 @@ In this article, you'll learn how to use the MedTech service Mapping debugger in
84
84
85
85
## Next steps
86
86
87
-
In this article, you learned about how to use the Mapping debugger to edit/troubleshoot the MedTech service device and FHIR destination mappings, and view normalized message and FHIR observation from a test device message.
87
+
In this article, you learned about how to use the Mapping debugger to edit/troubleshoot the MedTech service device and FHIR destination mappings, and view normalized message and FHIR Observation from a test device message.
88
88
89
89
To learn how to troubleshoot MedTech service deployment errors, see
0 commit comments