Skip to content

Commit 3713502

Browse files
committed
More edits
1 parent e5018a7 commit 3713502

File tree

1 file changed

+14
-17
lines changed

1 file changed

+14
-17
lines changed

articles/healthcare-apis/iot/how-to-use-mapping-debugger.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,20 @@ author: msjasteppe
66
ms.service: healthcare-apis
77
ms.subservice: iomt
88
ms.topic: how-to
9-
ms.date: 03/01/2023
9+
ms.date: 03/02/2023
1010
ms.author: jasteppe
1111
---
1212

13-
# How to use the MedTech service Mapping debugger
13+
# How to use the Mapping debugger
1414

1515
> [!NOTE]
1616
> [Fast Healthcare Interoperability Resources (FHIR®)](https://www.hl7.org/fhir/) is an open healthcare specification.
1717
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.
1919

2020
## Overview of the Mapping debugger
2121

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.
2323

2424
:::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":::
2525

@@ -30,7 +30,7 @@ In this article, you'll learn how to use the MedTech service Mapping debugger in
3030
**Upload** - With this selection, you can upload:
3131
- **Device mapping**: Can be edited and saved (optional) to the MedTech service.
3232
- **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.
3434

3535
**Download** - With this selection you can download copies of:
3636
- **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
5858

5959
:::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":::
6060

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
6362

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**.
6764

6865
:::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":::
6966

7067
2. The **Select a file** box will open. For this example, we'll select **Enter manually**.
7168

7269
:::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":::
7370

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.
7572

7673
:::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":::
7774

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.
7976

80-
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-normalized-and-FHIR-selections-available.png" alt-text="Screenshot View normalized message and View FHIR Observation available." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-normalized-and-FHIR-selections-available.png":::
77+
:::image type="content" source="media\how-to-use-mapping-debugger\mapping-debugger-normalized-and-FHIR-selections-available.png" alt-text="Screenshot View normalized message and View FHIR observation available." lightbox="media\how-to-use-mapping-debugger\mapping-debugger-normalized-and-FHIR-selections-available.png":::
8178

82-
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.
8380

8481
:::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":::
8582

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":::
8784

8885
## Next steps
8986

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.
9188

9289
To learn how to troubleshoot MedTech service deployment errors, see
9390

@@ -99,5 +96,5 @@ To learn how to troubleshoot errors using the MedTech service logs, see
9996
> [!div class="nextstepaction"]
10097
> [Troubleshoot errors using the MedTech service logs](troubleshoot-errors-logs.md)
10198
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.
103100

0 commit comments

Comments
 (0)