Overview of the MedTech service device mapping

2025-04-13

Fontos

2025.02.26-ától a MedTech szolgáltatás már nem érhető el a következő régiókban: Egyesült Királyság nyugati régiója, Egyesült Arab Emírségek északi régiója, Észak-Dél-Afrika, Katar középső régiója.

This article provides an overview of the MedTech service device mapping.

The MedTech service requires two types of JSON mappings that are added to your MedTech service through the Azure portal or Azure Resource Manager (ARM) API. The device mapping is the first type and controls mapping values in the device data sent to the MedTech service to an internal, normalized data object. Az eszközleképezés olyan kifejezéseket tartalmaz, amelyeket a MedTech szolgáltatás a típusok, az eszközazonosítók, a mérési dátum és a mérési érték(ek) kinyerésére használ. The FHIR® destination mapping is the second type and controls the mapping for FHIR Observations.

Megjegyzés:

Az eszköz- és FHIR-célleképezéseket a rendszer minden alkalommal újra kiértékeli, amikor egy eszközüzenet feldolgozása történik. A leképezések frissítései azonnal érvénybe lépnek.

Device mapping basics

The device mapping contains collections of expression templates used to extract device message data into an internal, normalized format for further evaluation. Each received device message is evaluated against all expression templates in the collection. This evaluation means that a single device message can be separated into multiple outbound messages that can be mapped to multiple FHIR Observations in the FHIR service.

Jótanács

For more information about how the MedTech service processes device message data into FHIR Observations for persistence in the FHIR service, see Overview of the MedTech service device data processing stages.

This diagram provides an illustration of what happens during the normalization stage within the MedTech service.

Device mapping validations

The normalization process validates the device mapping before allowing it to be saved for use. These elements are required in the device mapping templates.

Device mapping

Element	Required in CalculatedContent	Required in IotJsonPathContent
typeName	Igaz	Igaz
typeMatchExpression	Igaz	Igaz
deviceIdExpression	Igaz	False and ignored completely.
timestampExpression	Igaz	False and ignored completely.
patientIdExpression	True when the MedTech services's Resolution type is set to Create; False when the MedTech service's Resolution type is set to Lookup.	True when the MedTech service's Resolution type is set to Create; False when the MedTech service's Resolution type is set to Lookup.
encounterIdExpression	Téves	Téves
correlationIdExpression	Téves	Téves
values[].valueName	Igaz	Igaz
values[].valueExpression	Igaz	Igaz
values[].required	Igaz	Igaz

Fontos

A Felbontás típusa határozza meg, hogy a MedTech szolgáltatás hogyan társítja az eszközadatokat az eszközerőforrásokhoz és a Patient-erőforrásokhoz. A MedTech szolgáltatás eszköz- és betegerőforrásokat olvas be az FHIR szolgáltatásból eszközazonosítók és betegazonosítók használatával. If an encounter identifier is specified and extracted from the device data payload, it's linked to the observation if an encounter exists on the FHIR service with that identifier. Ha a találkozási azonosító sikeresen normalizálva van, de nem létezik FHIR-találkozás ezzel a találkozási azonosítóval, FhirResourceNotFound kivétel keletkezik. A MedTech szolgáltatás felbontástípusánakkonfigurálásáról további információt a Céllap konfigurálásacímű témakörben talál.

Megjegyzés:

The values[].valueName, values[].valueExpression, and values[].required elements are only required if you have a value entry in the array. It's valid to have no values mapped. These elements are used when the telemetry being sent is an event.

For example, some scenarios may require creating a FHIR Observation in the FHIR service that does not contain a value.

CollectionContent

CollectionContent is the root template type used by the MedTech service device mapping. CollectionContent is a list of all templates that are used during the normalization stage. You can define one or more templates within CollectionContent, with each device message received by the MedTech service being evaluated against all templates.

You can use these template types within CollectionContent depending on your use case:

CalculatedContent for device messages sent directly to your MedTech service event hub. CalculatedContent supports JSONPath, JMESPath, JMESPath functions, and the MedTech service custom functions.

és/vagy

IotJsonPathContent for device messages being routed through an Azure IoT Hub to your MedTech service event hub. IotJsonPathContent supports JSONPath.

Example

Jótanács

A MedTech szolgáltatásleképezés hibakeresőjével segítséget kaphat a MedTech szolgáltatáseszköz és az FHIR-célleképezések létrehozásához, frissítéséhez és hibaelhárításához. A leképezési hibakereső lehetővé teszi a beágyazott beállítások valós idejű megtekintését és módosítását anélkül, hogy el kellene hagynia az Azure Portalt. A leképezési hibakereső a teszteszköz-üzenetek feltöltéséhez is használható, hogy lássa, hogyan fognak kinézni a normalizált üzenetekké való feldolgozás után, és hogyan alakíthatók át FHIR-megfigyelésekké.

Ebben a példában egy eszközüzenetet használunk, amely heartRate adatokat rögzít:

{
  "heartRate": "78",
  "endDate": "2023-03-13T22:46:01.8750000",
  "deviceId": "device01"
}

Ezt az eszközleképezést a normalizálási fázishoz használjuk:

{
  "templateType": "CollectionContent",
  "template": [
    {
      "templateType": "CalculatedContent",
      "template": {
        "typeName": "heartrate",
        "typeMatchExpression": "$..[?(@heartRate)]",
        "deviceIdExpression": "$.matchedToken.deviceId",
        "timestampExpression": "$.matchedToken.endDate",
        "values": [
          {
            "required": true,
            "valueExpression": "$.matchedToken.heartRate",
            "valueName": "hr"
          }
        ]
      }
    }
  ]
}

Az eredményként kapott normalizált üzenet így fog kinézni a normalizálási szakasz után:

[
  {
    "type": "heartrate",
    "occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
    "deviceId": "device01",
    "properties": [
      {
        "name": "hr",
        "value": "78"
      }
    ]
  }
]

When the MedTech service is processing the device message, the templates in the CollectionContent are used to evaluate the message. A typeMatchExpression annak meghatározására szolgál, hogy a sablon használható-e normalizált üzenet létrehozásához az eszközüzenetből. If the typeMatchExpression evaluates to true, then the deviceIdExpression, timestampExpression, and valueExpression values are used to locate and extract the JSON values from the device message and create a normalized message. In this example, all expressions are written in JSONPath, however, it would be valid to write all the expressions in JMESPath. It's up to the template author to determine which expression language is most appropriate.

Jótanács

A MedTech szolgáltatás gyakori üzembehelyezési hibáinak elhárításához a MedTech szolgáltatás üzembe helyezési hibáinak elhárításacímű témakörben talál segítséget.

Ha segítségre van szüksége a MedTech szolgáltatás hibáinak elhárításához, olvassa el A MedTech szolgáltatásnaplókhasználatával kapcsolatos hibák elhárítása.