Skip to content

Commit 1a1900b

Browse files
committed
Updates based on feedback
1 parent 3713502 commit 1a1900b

File tree

4 files changed

+12
-76
lines changed

4 files changed

+12
-76
lines changed

.openpublishing.redirection.healthcare-apis.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -657,8 +657,8 @@
657657
"redirect_url": "/azure/healthcare-apis/iot/troubleshoot-errors",
658658
"redirect_document_id": false
659659
},
660-
{ "source_path_from_root": "/articles/healthcare-apis/iot/device-data-through-iot-hub.md",
661-
"redirect_url": "/azure/healthcare-apis/iot/device-messages-through-iot-hub",
660+
{ "source_path_from_root": "/articles/healthcare-apis/iot/how-to-create-mappings-copies.md",
661+
"redirect_url": "/azure/healthcare-apis/iot/how-to-use-mapping-debugger",
662662
"redirect_document_id": false
663663
},
664664
{ "source_path_from_root": "/articles/healthcare-apis/events/events-display-metrics.md",

articles/healthcare-apis/iot/how-to-create-mappings-copies.md

Lines changed: 0 additions & 62 deletions
This file was deleted.

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

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

@@ -15,11 +15,11 @@ ms.author: jasteppe
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. 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.
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 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.
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 validation service to produce a sample normalized measurement 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,21 +58,21 @@ 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-
## View a normalized message and FHIR observation
61+
## View a normalized message and FHIR Observation
6262

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

6565
:::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":::
6666

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

6969
:::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":::
7070

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

7373
:::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":::
7474

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

7777
:::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":::
7878

@@ -84,7 +84,7 @@ In this article, you'll learn how to use the MedTech service Mapping debugger in
8484

8585
## Next steps
8686

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

8989
To learn how to troubleshoot MedTech service deployment errors, see
9090

articles/healthcare-apis/iot/toc.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,7 @@ items:
5656
- name: Use IotJsonPathContentTemplate mappings
5757
href: how-to-use-iotjsonpathcontenttemplate-mappings.md
5858
- name: Use custom functions
59-
href: how-to-use-custom-functions.md
60-
- name: Create copies of mappings
61-
href: how-to-create-mappings-copies.md
59+
href: how-to-use-custom-functions.md
6260
- name: Destination
6361
expanded: false
6462
items:

0 commit comments

Comments
 (0)