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
+14-17Lines changed: 14 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,20 +6,20 @@ author: msjasteppe
6
6
ms.service: healthcare-apis
7
7
ms.subservice: iomt
8
8
ms.topic: how-to
9
-
ms.date: 03/01/2023
9
+
ms.date: 03/02/2023
10
10
ms.author: jasteppe
11
11
---
12
12
13
-
# How to use the MedTech service Mapping debugger
13
+
# How to use the Mapping debugger
14
14
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.
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 the 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 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.
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 device and FHIR destination mappings (optional) to view a normalized message 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,36 +58,33 @@ 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
-
> [!IMPORTANT]
62
-
> While the Mapping debugger is saving the mappings, the MedTech service will become non-operational until the mappings are successfully saved. Device messages will continue to arrive in your event hub with no data loss. The MedTech service will resume processing those device messages one it becomes operational again.
61
+
## View a normalized message and FHIR observation
63
62
64
-
## Viewing a normalized message and FHIR observation
65
-
66
-
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 the output of the device mapping (normalized message) and FHIR destination mapping (FHIR observation). Select **Upload** and **Test device message**.
67
64
68
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":::
69
66
70
67
2. The **Select a file** box will open. For this example, we'll select **Enter manually**.
71
68
72
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":::
73
70
74
-
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 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.
75
72
76
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":::
77
74
78
-
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 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.
5. Use the **X** in the corner to close the box for each box.
79
+
5. Use the **X** in the corner to close the **Normalized message** and **FHIR observation** boxes.
83
80
84
81
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-normalized-message.png" alt-text="Screenshot of the normalized message." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-normalized-and-FHIR-selections-available.png":::
85
82
86
-
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-fhir-observation.png" alt-text="Screenshot of the FHIR Observation available." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-fhir-observation.png":::
83
+
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-fhir-observation.png" alt-text="Screenshot of the FHIR observation available." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-fhir-observation.png":::
87
84
88
85
## Next steps
89
86
90
-
In this article, you learned about how to use the Mapping debugger to edit/troubleshoot the device and FHIR destination mappings and a 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.
91
88
92
89
To learn how to troubleshoot MedTech service deployment errors, see
93
90
@@ -99,5 +96,5 @@ To learn how to troubleshoot errors using the MedTech service logs, see
99
96
> [!div class="nextstepaction"]
100
97
> [Troubleshoot errors using the MedTech service logs](troubleshoot-errors-logs.md)
101
98
102
-
(FHIR®) is a registered trademark of Health Level Seven International, registered in the U.S. Trademark Office and is used with their permission.
99
+
FHIR® is a registered trademark of Health Level Seven International, registered in the U.S. Trademark Office and is used with their permission.
0 commit comments