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-device-mappings.md
+15-12Lines changed: 15 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,25 +5,28 @@ author: msjasteppe
5
5
ms.service: healthcare-apis
6
6
ms.subservice: fhir
7
7
ms.topic: how-to
8
-
ms.date: 07/07/2022
8
+
ms.date: 09/12/2022
9
9
ms.author: jasteppe
10
10
---
11
11
12
-
# How to use Device mappings
12
+
# How to use device mappings
13
13
14
-
> [!TIP]
15
-
> Check out the [IoMT Connector Data Mapper](https://github.com/microsoft/iomt-fhir/tree/master/tools/data-mapper) tool for editing, testing, and troubleshooting the MedTech service Device and FHIR destination mappings. Export mappings for uploading to the MedTech service in the Azure portal or use with the [open-source version](https://github.com/microsoft/iomt-fhir) of the MedTech service.
14
+
This article describes how to configure the MedTech service device mapping.
15
+
16
+
The MedTech service requires two types of JSON-based mappings. The first type, **device mapping**, is responsible for mapping the device payloads sent to the MedTech service device message event hub end point. The device mapping extracts types, device identifiers, measurement date time, and the measurement value(s).
16
17
17
-
This article describes how to configure the MedTech service using Device mappings.
18
+
The second type, **Fast Healthcare Interoperability Resources (FHIR®) destination mapping**, controls the mapping for FHIR resource. The FHIR destination mapping allows configuration of the length of the observation period, FHIR data type used to store the values, and terminology code(s).
18
19
19
-
MedTech service requires two types of JSON-based mappings. The first type, **Device mapping**, is responsible for mapping the device payloads sent to the `devicedata` Azure Event Hubs end point. It extracts types, device identifiers, measurement date time, and the measurement value(s).
20
+
> [!NOTE]
21
+
> Device and FHIR destination mappings are stored in an underlying blob storage and loaded from blob per compute execution. Once updated they should take effect immediately.
20
22
21
-
The second type, **Fast Healthcare Interoperability Resources (FHIR®) destination mapping**, controls the mapping for FHIR resource. It allows configuration of the length of the observation period, FHIR data type used to store the values, and terminology code(s).
23
+
The two types of mappings are composed into a JSON document based on their type. These JSON documents are then added to your MedTech service through the Azure portal. The device mapping is added through the **Device mapping** page and the FHIR destination mapping through the **Destination** page.
22
24
23
-
The two types of mappings are composed into a JSON document based on their type. These JSON documents are then added to your MedTech service through the Azure portal. The Device mapping document is added through the **Device mapping** page and the FHIR destination mapping document through the **Destination** page.
25
+
> [!TIP]
26
+
> Check out the [IoMT Connector Data Mapper](https://github.com/microsoft/iomt-fhir/tree/master/tools/data-mapper) tool for editing, testing, and troubleshooting the MedTech service device and FHIR destination mappings; and export mappings for uploading to the MedTech service in the Azure portal or use with the [open-source version](https://github.com/microsoft/iomt-fhir) of the MedTech service.
24
27
25
28
> [!NOTE]
26
-
> Mappings are stored in an underlying blob storage and loaded from blob per compute execution. Once updated they should take effect immediately.
29
+
> Links to OSS projects on the GitHub website are for informational purposes only and do not constitute an endorsement or guarantee of any kind. You should review the information and licensing terms on the OSS projects on GitHub before using it.
27
30
28
31
## Device mappings overview
29
32
@@ -74,11 +77,11 @@ The content payload itself is an Azure Event Hubs message, which is composed of
74
77
75
78
The five device content-mapping types supported today rely on JSONPath to both match the required mapping and extracted values. More information on JSONPath can be found [here](https://goessner.net/articles/JsonPath/). All five template types use the [JSON .NET implementation](https://www.newtonsoft.com/json/help/html/QueryJsonSelectTokenJsonPath.htm) for resolving JSONPath expressions.
76
79
77
-
You can define one or more templates within the Device mapping template. Each Event Hubs device message received is evaluated against all device mapping templates.
80
+
You can define one or more templates within the MedTech service device mapping. Each event hub device message received is evaluated against all device mapping templates.
78
81
79
82
A single inbound device message can be separated into multiple outbound messages that are later mapped to different observations in the FHIR service.
80
83
81
-
Various template types exist and may be used when building the Device mapping file.
84
+
Various template types exist and may be used when building the MedTech service device mapping.
0 commit comments