Skip to content

Commit 6ace492

Browse files
committed
Updating docset for consistency
1 parent 001c6e5 commit 6ace492

17 files changed

+72
-62
lines changed

.openpublishing.redirection.healthcare-apis.json

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -586,15 +586,19 @@
586586
"redirect_document_id": false
587587
},
588588
{ "source_path_from_root": "/articles/healthcare-apis/iot/iot-data-flow.md",
589-
"redirect_url": "/azure/healthcare-apis/iot/understand-service",
589+
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-data-processing-stages",
590590
"redirect_document_id": false
591591
},
592592
{ "source_path_from_root": "/articles/healthcare-apis/iot/data-flow.md",
593-
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-message-processing-stages",
593+
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-data-processing-stages",
594594
"redirect_document_id": false
595595
},
596596
{ "source_path_from_root": "/articles/healthcare-apis/iot/understand-service.md",
597-
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-message-processing-stages",
597+
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-data-processing-stages",
598+
"redirect_document_id": false
599+
},
600+
{ "source_path_from_root": "/articles/healthcare-apis/iot/overview-of-device-message-processing-stages.md",
601+
"redirect_url": "/azure/healthcare-apis/iot/overview-of-device-data-processing-stages",
598602
"redirect_document_id": false
599603
},
600604
{ "source_path_from_root": "/articles/healthcare-apis/iot/how-to-use-device-mappings.md",

articles/healthcare-apis/iot/device-messages-through-iot-hub.md

Lines changed: 2 additions & 2 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: tutorial
9-
ms.date: 04/07/2023
9+
ms.date: 04/14/2023
1010
ms.custom: devx-track-arm-template
1111
ms.author: jasteppe
1212
---
@@ -21,7 +21,7 @@ For enhanced workflows and ease of use, you can use the MedTech service to recei
2121
:::image type="content" source="media\device-messages-through-iot-hub\data-flow-diagram.png" border="false" alt-text="Diagram of the IoT device message flow through an IoT hub and event hub, and then into the MedTech service." lightbox="media\device-messages-through-iot-hub\data-flow-diagram.png":::
2222

2323
> [!TIP]
24-
> To learn how the MedTech service transforms and persists device message data into the FHIR service as FHIR Observations, see [Overview of the MedTech service device message processing stages](overview-of-device-message-processing-stages.md).
24+
> To learn how the MedTech service transforms and persists device message data into the FHIR service as FHIR Observations, see [Overview of the MedTech service device data processing stages](overview-of-device-data-processing-stages.md).
2525
2626
In this tutorial, you learn how to:
2727

articles/healthcare-apis/iot/frequently-asked-questions.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: msjasteppe
66
ms.custom: references_regions
77
ms.service: healthcare-apis
88
ms.topic: reference
9-
ms.date: 04/04/2023
9+
ms.date: 04/14/2023
1010
ms.author: jasteppe
1111
---
1212

@@ -23,7 +23,7 @@ The MedTech service is available in these Azure regions: [Products available by
2323

2424
### Can I use the MedTech service with a different FHIR service other than the Azure Health Data Services FHIR service?
2525

26-
No. The MedTech service currently only supports the Azure Health Data Services FHIR service for the persistence of transformed device message data. The open-source version of the MedTech service supports the use of different FHIR services.
26+
No. The MedTech service currently only supports the Azure Health Data Services FHIR service for the persistence of transformed device data. The open-source version of the MedTech service supports the use of different FHIR services.
2727

2828
To learn more about the MedTech service open-source projects, see [Open-source projects](git-projects.md).
2929

@@ -33,15 +33,15 @@ The MedTech service supports the [HL7 FHIR® R4](https://www.hl7.org/impleme
3333

3434
### Why do I have to provide device and FHIR destination mappings to the MedTech service?
3535

36-
The MedTech service requires device and FHIR destination mappings to perform normalization and transformation processes on device message data. To learn how the MedTech service transforms device message data into [FHIR Observations](https://www.hl7.org/fhir/observation.html), see [Overview of the MedTech service device message processing stages](overview-of-device-message-processing-stages.md).
36+
The MedTech service requires device and FHIR destination mappings to perform normalization and transformation processes on device message data. To learn how the MedTech service transforms device data into [FHIR Observations](https://www.hl7.org/fhir/observation.html), see [Overview of the MedTech service device data processing stages](overview-of-device-data-processing-stages.md).
3737

3838
### Is JsonPathContent still supported by the MedTech service device mapping?
3939

4040
Yes. JsonPathContent can be used as a template type within [CollectionContent](overview-of-device-mapping.md#collectioncontent). It's recommended that [CalculatedContent](how-to-use-calculatedcontent-mappings.md) is used as it supports all of the features of JsonPathContent with extra support for more advanced features.
4141

42-
### How long does it take for device message data to show up in the FHIR service?
42+
### How long does it take for device data to show up in the FHIR service?
4343

44-
The MedTech service buffers [FHIR Observations](https://www.hl7.org/fhir/observation.html) created during the transformation stage and provides near real-time processing. However, this buffer can potentially delay the persistence of FHIR Observations to the FHIR service up to ~five minutes. To learn how the MedTech service transforms device message data into FHIR Observations, see [Overview of the MedTech service device message processing stages](overview-of-device-message-processing-stages.md).
44+
The MedTech service buffers [FHIR Observations](https://www.hl7.org/fhir/observation.html) created during the transformation stage and provides near real-time processing. However, this buffer can potentially delay the persistence of FHIR Observations to the FHIR service up to ~five minutes. To learn how the MedTech service transforms device data into FHIR Observations, see [Overview of the MedTech service device data processing stages](overview-of-device-data-processing-stages.md).
4545

4646
### Why are the device messages added to the event hub not showing up as FHIR Observations in the FHIR service?
4747

articles/healthcare-apis/iot/get-started.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -112,25 +112,25 @@ For more information about assigning roles to the FHIR services, see [Configure
112112

113113
For more information about application roles, see [Authentication and Authorization for Azure Health Data Services](../authentication-authorization.md).
114114

115-
## Step 5: Send the data for processing
115+
## Step 5: Send the device data for processing
116116

117-
When the MedTech service is deployed and connected to the Event Hubs and FHIR services, it's ready to process data from a device and translate it into a FHIR service Observation. There are three parts of the sending process.
117+
When the MedTech service is deployed and connected to the Event Hubs and FHIR services, it's ready to process device data and transform it into FHIR Observations. There are three parts of the sending process.
118118

119-
### Data sent from Device to Event Hubs
119+
### Device data sent to Event Hubs
120120

121-
The data is sent to an Event Hubs instance so that it can wait until the MedTech service is ready to receive it. The data transfer needs to be asynchronous because it's sent over the Internet and delivery times can't be precisely measured. Normally the data won't sit on an event hub longer than 24 hours.
121+
The device data is sent to an Event Hubs instance so that it can wait until the MedTech service is ready to receive it. The device data transfer needs to be asynchronous because it's sent over the Internet and delivery times can't be precisely measured. Normally the data won't sit on an event hub longer than 24 hours.
122122

123123
For more information about Event Hubs, see [Event Hubs](../../event-hubs/event-hubs-about.md).
124124

125125
For more information on Event Hubs data retention, see [Event Hubs quotas](../../event-hubs/event-hubs-quotas.md)
126126

127-
### Data Sent from Event Hubs to the MedTech service
127+
### Device data sent from Event Hubs to the MedTech service
128128

129-
MedTech requests the data from the Event Hubs instance and the data is sent from the event hub to the MedTech service. This procedure is called ingestion.
129+
MedTech requests the device data from the Event Hubs instance and the device data is sent from the event hub to the MedTech service. This procedure is called ingestion.
130130

131-
### The MedTech service processes the data
131+
### The MedTech service processes the device data
132132

133-
The MedTech service processes the data in five steps:
133+
The MedTech service processes the device data in five steps:
134134

135135
- Ingest
136136
- Normalize
@@ -140,15 +140,15 @@ The MedTech service processes the data in five steps:
140140

141141
If the processing was successful and you didn't get any error messages, your device data is now a FHIR service [Observation](http://hl7.org/fhir/observation.html) resource.
142142

143-
For more information on the MedTech service device message data transformation, see [Overview of the MedTech service device message processing stages](overview-of-device-message-processing-stages.md).
143+
For more information on the MedTech service device data transformation, see [Overview of the MedTech service device data processing stages](overview-of-device-data-processing-stages.md).
144144

145-
## Step 6: Verify the processed data
145+
## Step 6: Verify the processed device data
146146

147-
You can verify that the data was processed correctly by checking to see if there's now a new Observation resource in the FHIR service. If the data isn't mapped or if the mapping isn't authored properly, the data will be skipped. If there are any problems, check the [device mapping](overview-of-device-mapping.md) or the [FHIR destination mapping](how-to-configure-fhir-mappings.md).
147+
You can verify that the device data was processed correctly by checking to see if there's now a new Observation resource in the FHIR service. If the device data isn't mapped or if the mapping isn't authored properly, the device data will be skipped. If there are any problems, check the [device mapping](overview-of-device-mapping.md) or the [FHIR destination mapping](how-to-configure-fhir-mappings.md).
148148

149149
### Metrics
150150

151-
You can verify that the data is correctly persisted into the FHIR service by using the [MedTech service metrics](how-to-configure-metrics.md) in the Azure portal.
151+
You can verify that the device data is correctly persisted in the FHIR service by using the [MedTech service metrics](how-to-configure-metrics.md) in the Azure portal.
152152

153153
## Next steps
154154

articles/healthcare-apis/iot/how-to-configure-metrics.md

Lines changed: 6 additions & 6 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: 04/04/2023
9+
ms.date: 04/14/2023
1010
ms.author: jasteppe
1111
---
1212

@@ -27,11 +27,11 @@ Metric category|Metric name|Metric description|
2727
|--------------|-----------|--------------|
2828
|Availability|IotConnector Health Status|The overall health of the MedTech service.|
2929
|Errors|Total Error Count|The total number of errors.|
30-
|Latency|Average Group Stage Latency|The average latency of the group stage. The [group stage](overview-of-device-message-processing-stages.md#group---optional) performs buffering, aggregating, and grouping on normalized messages.|
31-
|Latency|Average Normalize Stage Latency|The average latency of the normalized stage. The [normalized stage](overview-of-device-message-processing-stages.md#normalize) performs normalization on raw incoming messages.|
32-
|Traffic|Number of Fhir resources saved|The total number of FHIR resources [updated or persisted](overview-of-device-message-processing-stages.md#persist) by the MedTech service.|
33-
|Traffic|Number of Incoming Messages|The number of received raw [incoming messages](overview-of-device-message-processing-stages.md#ingest) (for example, the device events) from the configured source event hub.|
34-
|Traffic|Number of Measurements|The number of normalized value readings received by the FHIR [transformation stage](overview-of-device-message-processing-stages.md#transform) of the MedTech service.|
30+
|Latency|Average Group Stage Latency|The average latency of the group stage. The [group stage](overview-of-device-data-processing-stages.md#group---optional) performs buffering, aggregating, and grouping on normalized messages.|
31+
|Latency|Average Normalize Stage Latency|The average latency of the normalized stage. The [normalized stage](overview-of-device-data-processing-stages.md#normalize) performs normalization on raw incoming messages.|
32+
|Traffic|Number of Fhir resources saved|The total number of FHIR resources [updated or persisted](overview-of-device-data-processing-stages.md#persist) by the MedTech service.|
33+
|Traffic|Number of Incoming Messages|The number of received raw [incoming messages](overview-of-device-data-processing-stages.md#ingest) (for example, the device events) from the configured source event hub.|
34+
|Traffic|Number of Measurements|The number of normalized value readings received by the FHIR [transformation stage](overview-of-device-data-processing-stages.md#transform) of the MedTech service.|
3535
|Traffic|Number of Message Groups|The number of groups that have messages aggregated in the designated time window.|
3636
|Traffic|Number of Normalized Messages|The number of normalized messages.|
3737

articles/healthcare-apis/iot/how-to-use-calculatedcontent-mappings.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,15 @@ author: msjasteppe
55
ms.service: healthcare-apis
66
ms.subservice: fhir
77
ms.topic: how-to
8-
ms.date: 02/09/2023
8+
ms.date: 04/14/2023
99
ms.author: jasteppe
1010
---
1111

1212
# How to use CalculatedContent mappings
1313

14+
> [!NOTE]
15+
> [Fast Healthcare Interoperability Resources (FHIR®)](https://www.hl7.org/fhir/) is an open healthcare specification.
16+
1417
This article describes how to use CalculatedContent mappings with MedTech service device mappings in Azure Health Data Services.
1518

1619
## Overview of CalculatedContent mappings

articles/healthcare-apis/iot/how-to-use-custom-functions.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,15 @@ author: msjasteppe
55
ms.service: healthcare-apis
66
ms.subservice: fhir
77
ms.topic: how-to
8-
ms.date: 1/18/2023
8+
ms.date: 04/14/2023
99
ms.author: jasteppe
1010
---
1111

1212
# How to use custom functions with device mappings
1313

14+
> [!NOTE]
15+
> [Fast Healthcare Interoperability Resources (FHIR®)](https://www.hl7.org/fhir/) is an open healthcare specification.
16+
1417
Many functions are available when using **JMESPath** as the expression language. Besides the functions available as part of the JMESPath specification, many more custom functions may also be used. This article describes the MedTech service-specific custom functions for use with the MedTech service [device mapping](how-to-configure-device-mappings.md) during the device message [normalization](understand-service.md#normalize) process.
1518

1619
> [!TIP]

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

Lines changed: 2 additions & 2 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: 04/10/2023
9+
ms.date: 04/14/2023
1010
ms.author: jasteppe
1111
---
1212

@@ -21,7 +21,7 @@ ms.author: jasteppe
2121
In this article, learn how to use the MedTech service Mapping debugger. The Mapping debugger is a self-service tool that is used for creating, updating, and troubleshooting the MedTech service device and FHIR destination mappings. The Mapping debugger enables you to easily view and make inline adjustments in real-time, without ever having to leave the Azure portal. 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.
2222

2323
> [!TIP]
24-
> To learn about how the MedTech service transforms and persists device message data into the FHIR service see, [Overview of the MedTech service device data processing stages](overview-of-device-message-processing-stages.md).
24+
> To learn about how the MedTech service transforms and persists device message data into the FHIR service see, [Overview of the MedTech service device data processing stages](overview-of-device-data-processing-stages.md).
2525
2626
The following video presents an overview of the Mapping debugger:
2727
>

articles/healthcare-apis/iot/how-to-use-monitoring-and-health-checks-tabs.md

Lines changed: 6 additions & 6 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: 04/04/2023
9+
ms.date: 04/14/2023
1010
ms.author: jasteppe
1111
---
1212

@@ -51,11 +51,11 @@ Metric category|Metric name|Metric description|
5151
|--------------|-----------|--------------|
5252
|Availability|IotConnector Health Status|The overall health of the MedTech service.|
5353
|Errors|**Total Error Count**|The total number of errors.|
54-
|Latency|**Average Group Stage Latency**|The average latency of the group stage. The [group stage](overview-of-device-message-processing-stages.md#group---optional) performs buffering, aggregating, and grouping on normalized messages.|
55-
|Latency|**Average Normalize Stage Latency**|The average latency of the normalized stage. The [normalized stage](overview-of-device-message-processing-stages.md#normalize) performs normalization on raw incoming messages.|
56-
|Traffic|Number of Fhir resources saved|The total number of FHIR resources [updated or persisted](overview-of-device-message-processing-stages.md#persist) by the MedTech service.|
57-
|Traffic|**Number of Incoming Messages**|The number of received raw [incoming messages](overview-of-device-message-processing-stages.md#ingest) (for example, the device events) from the configured source event hub.|
58-
|Traffic|**Number of Measurements**|The number of normalized value readings received by the FHIR [transformation stage](overview-of-device-message-processing-stages.md#transform) of the MedTech service.|
54+
|Latency|**Average Group Stage Latency**|The average latency of the group stage. The [group stage](overview-of-device-data-processing-stages.md#group---optional) performs buffering, aggregating, and grouping on normalized messages.|
55+
|Latency|**Average Normalize Stage Latency**|The average latency of the normalized stage. The [normalized stage](overview-of-device-data-processing-stages.md#normalize) performs normalization on raw incoming messages.|
56+
|Traffic|Number of Fhir resources saved|The total number of FHIR resources [updated or persisted](overview-of-device-data-processing-stages.md#persist) by the MedTech service.|
57+
|Traffic|**Number of Incoming Messages**|The number of received raw [incoming messages](overview-of-device-data-processing-stages.md#ingest) (for example, the device events) from the configured source event hub.|
58+
|Traffic|**Number of Measurements**|The number of normalized value readings received by the FHIR [transformation stage](overview-of-device-data-processing-stages.md#transform) of the MedTech service.|
5959
|Traffic|**Number of Message Groups**|The number of groups that have messages aggregated in the designated time window.|
6060
|Traffic|**Number of Normalized Messages**|The number of normalized messages.|
6161

articles/healthcare-apis/iot/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ metadata:
1313
ms.collection: collection
1414
author: msjasteppe
1515
ms.author: jasteppe
16-
ms.date: 04/04/2023
16+
ms.date: 04/14/2023
1717

1818
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
1919

@@ -25,8 +25,8 @@ landingContent:
2525
links:
2626
- text: What is the MedTech service?
2727
url: overview.md
28-
- text: Overview of the MedTech service device message processing stages
29-
url: overview-of-device-message-processing-stages.md
28+
- text: Overview of the MedTech service device data processing stages
29+
url: overview-of-device-data-processing-stages.md
3030
- linkListType: quickstart
3131
links:
3232
- text: Get started with the MedTech service
@@ -64,7 +64,7 @@ landingContent:
6464
- text: CalculatedContent
6565
url: how-to-use-calculatedcontent-mappings.md
6666
- text: IotJsonPathContent
67-
url: how-to-use-iotjsonpathcontenttemplate-mappings.md
67+
url: how-to-use-iotjsonpathcontent-mappings.md
6868
- text: Custom functions
6969
url: how-to-use-custom-functions.md
7070

0 commit comments

Comments
 (0)