Overzicht van de apparaattoewijzing van de MedTech-service

Artikel
11/08/2023

Dit artikel bevat een overzicht van de apparaattoewijzing van de MedTech-service.

Voor de MedTech-service zijn twee typen JSON-toewijzingen vereist die worden toegevoegd aan uw MedTech-service via de Azure-portal of arm-API (Azure Resource Manager). De apparaattoewijzing is het eerste type en bepaalt de toewijzingswaarden in de apparaatgegevens die naar de MedTech-service worden verzonden naar een intern, genormaliseerd gegevensobject. De apparaattoewijzing bevat expressies die de MedTech-service gebruikt voor het extraheren van typen, apparaat-id's, datum en meetwaarde(s). De FHIR-doeltoewijzing® is het tweede type en bepaalt de toewijzing voor FHIR-waarnemingen.

Notitie

De doeltoewijzingen voor apparaten en FHIR worden telkens wanneer een apparaatbericht wordt verwerkt, opnieuw geëvalueerd. Alle updates voor beide toewijzingen worden onmiddellijk van kracht.

Basisbeginselen van apparaattoewijzing

De apparaattoewijzing bevat verzamelingen expressiesjablonen die worden gebruikt om berichtgegevens van apparaten te extraheren in een interne, genormaliseerde indeling voor verdere evaluatie. Elk ontvangen apparaatbericht wordt geëvalueerd op basis van alle expressiesjablonen in de verzameling. Deze evaluatie betekent dat één apparaatbericht kan worden gescheiden in meerdere uitgaande berichten die kunnen worden toegewezen aan meerdere FHIR-waarnemingen in de FHIR-service.

Fooi

Voor meer informatie over hoe de MedTech-service apparaatberichtgegevens verwerkt in FHIR Observations voor persistentie in de FHIR-service, raadpleegt u Overview of the MedTech service device data processing stages.

Dit diagram geeft een illustratie van wat er gebeurt tijdens de normalisatiefase binnen de MedTech-service.

Validaties voor apparaattoewijzing

Het normalisatieproces valideert de apparaattoewijzing voordat deze kan worden opgeslagen voor gebruik. Deze elementen zijn vereist in de sjablonen voor apparaattoewijzing.

Apparaattoewijzing

Element	Vereist in CalculatedContent	Vereist in IotJsonPathContent
Typename	Waar	Waar
typeMatchExpression	Waar	Waar
deviceIdExpression	Waar	Onwaar en genegeerd.
timestampExpression	Waar	Onwaar en genegeerd.
patientIdExpression	Waar wanneer het resolutietype van de MedTech-services is ingesteld op Maken; Onwaar wanneer het oplossingstype van de MedTech-service is ingesteld op Opzoeken.	Waar wanneer het resolutietype van de MedTech-service is ingesteld op Maken; Onwaar wanneer het oplossingstype van de MedTech-service is ingesteld op Opzoeken.
encounterIdExpression	Onwaar	Onwaar
correlationIdExpression	Onwaar	Onwaar
values[].valueName	Waar	Waar
values[].valueExpression	Waar	Waar
values[].required	Waar	Waar

Belangrijk

Het oplossingstype geeft aan hoe de MedTech-service apparaatgegevens koppelt aan apparaatbronnen en patiëntbronnen. De MedTech-service leest apparaat- en patiëntbronnen uit de FHIR-service met behulp van apparaat-id's en patiënt-id's. Als een ontmoetings-id is opgegeven en geëxtraheerd uit de nettolading van de apparaatgegevens, wordt deze gekoppeld aan de observatie als er een ontmoeting op de FHIR-service met die id bestaat. Als de ontmoetings-id is genormaliseerd, maar er geen FHIR-ontmoeting bestaat met die ontmoetings-id, wordt er een FhirResourceNotFound-uitzondering gegenereerd. Zie Het tabblad Bestemming configureren voor meer informatie over het configureren van het type MedTech-serviceomzetting.

Notitie

De values[].valueName, values[].valueExpressionen values[].required elementen zijn alleen vereist als u een waardevermelding in de matrix hebt. Het is geldig om geen waarden toe te wijzen. Deze elementen worden gebruikt wanneer de telemetrie die wordt verzonden een gebeurtenis is.

Voor sommige scenario's is bijvoorbeeld het maken van een FHIR-observatie in de FHIR-service vereist die geen waarde bevat.

CollectionContent

CollectionContent is het basissjabloontype dat wordt gebruikt door de apparaattoewijzing van de MedTech-service. CollectionContent is een lijst met alle sjablonen die worden gebruikt tijdens de normalisatiefase. U kunt een of meer sjablonen definiëren in CollectionContent, waarbij elk apparaatbericht dat door de MedTech-service wordt ontvangen, wordt geëvalueerd op basis van alle sjablonen.

U kunt deze sjabloontypen in CollectionContent gebruiken, afhankelijk van uw use-case:

CalculatedContent voor apparaatberichten die rechtstreeks naar uw Event Hub van de MedTech-service worden verzonden. CalculatedContent biedt ondersteuning voor JSONPath-, JMESPath-, JMESPath-functies en de aangepaste functies van de MedTech-service.

IotJsonPathContent voor apparaatberichten die worden gerouteerd via een Azure IoT Hub naar uw Event Hub van de MedTech-service. IotJsonPathContent ondersteunt JSONPath.

Voorbeeld

Fooi

U kunt het foutopsporingsprogramma voor de MedTech-servicetoewijzing gebruiken voor hulp bij het maken, bijwerken en oplossen van problemen met het MedTech-serviceapparaat en de FHIR-doeltoewijzingen. Met het foutopsporingsprogramma voor toewijzingen kunt u eenvoudig inline aanpassingen in realtime bekijken en doorvoeren, zonder dat u de Azure-portal hoeft te verlaten. Het foutopsporingsprogramma voor toewijzingen kan ook worden gebruikt voor het uploaden van testapparaatberichten om te zien hoe deze worden verwerkt in genormaliseerde berichten en omgezet in FHIR-waarnemingen.

In dit voorbeeld gebruiken we een apparaatbericht waarin gegevens worden vastgelegd heartRate :

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

We gebruiken deze apparaattoewijzing voor de normalisatiefase:

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

Het resulterende genormaliseerde bericht ziet er als volgt uit na de normalisatiefase:

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

Wanneer de MedTech-service het apparaatbericht verwerkt, worden de sjablonen in de CollectionContent gebruikt om het bericht te evalueren. De typeMatchExpression sjabloon wordt gebruikt om te bepalen of de sjabloon moet worden gebruikt om een genormaliseerd bericht te maken op basis van het apparaatbericht. Als de typeMatchExpression waarde waar oplevert, worden de deviceIdExpression, timestampExpressionen valueExpression waarden gebruikt om de JSON-waarden te zoeken en te extraheren uit het apparaatbericht en een genormaliseerd bericht te maken. In dit voorbeeld zijn alle expressies geschreven in JSONPath. Het is echter wel geldig om alle expressies in JMESPath te schrijven. Het is aan de auteur van de sjabloon om te bepalen welke expressietaal het meest geschikt is.

Fooi

Zie Problemen met de implementatie van medTech-services oplossen voor hulp bij het oplossen van veelvoorkomende fouten bij de implementatie van de MedTech-service.

Zie Problemen oplossen met behulp van de MedTech-servicelogboeken voor hulp bij het oplossen van medtech-servicefouten.