A MedTech szolgáltatás eszközleképezésének áttekintése

Cikk
11/08/2023

Ez a cikk áttekintést nyújt a MedTech szolgáltatás eszközleképezéséről.

A MedTech szolgáltatáshoz kétféle JSON-leképezés szükséges, amelyeket az Azure Portalon vagy az Azure Resource Manager (ARM) API-n keresztül ad hozzá a MedTech szolgáltatáshoz. Az eszközleképezés az első típus, amely a MedTech szolgáltatásnak egy belső, normalizált adatobjektumnak küldött eszközadatok leképezési értékeit szabályozza. 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. Az FHIR® célleképezés a második típus, és szabályozza az FHIR-megfigyelések leképezését.

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.

Az eszközleképezés alapjai

Az eszközleképezés olyan kifejezéssablonokat tartalmaz, amelyeket az eszközüzenetek adatainak belső, normalizált formátumba való kinyerésére használnak a további kiértékeléshez. Minden fogadott eszközüzenet kiértékelése a gyűjtemény összes kifejezéssablonja alapján történik. Ez a kiértékelés azt jelenti, hogy egyetlen eszközüzenet több kimenő üzenetre is szétválasztható, amelyek az FHIR szolgáltatásban több FHIR-megfigyelésre is leképezhetők.

Tipp.

További információ arról, hogy a MedTech szolgáltatás hogyan dolgozza fel az eszközüzenetek adatait az FHIR-szolgáltatásban való adatmegőrzés érdekében, tekintse meg a MedTech szolgáltatás eszköz adatfeldolgozási szakaszainak áttekintését.

Ez az ábra bemutatja, hogy mi történik a MedTech szolgáltatás normalizálási szakaszában.

Eszközleképezés érvényesítése

A normalizálási folyamat ellenőrzi az eszközleképezést, mielőtt lehetővé tenné a mentést használatra. Ezekre az elemekre szükség van az eszközleképezési sablonokban.

Eszközleképezés

Elem	Kötelező a CalculatedContentben	Kötelező az IotJsonPathContentben
typeName	Igaz	Igaz
typeMatchExpression	Igaz	Igaz
deviceIdExpression	Igaz	Hamis és teljesen figyelmen kívül hagyva.
timestampExpression	Igaz	Hamis és teljesen figyelmen kívül hagyva.
patientIdExpression	Igaz, ha a MedTech-szolgáltatások Felbontás típusa Létrehozás értékre van állítva; Hamis, ha a MedTech szolgáltatás Felbontás típusa Keresési értékre van állítva.	Igaz, ha a MedTech szolgáltatás Felbontás típusa Létrehozás értékre van állítva; Hamis, ha a MedTech szolgáltatás Felbontás típusa Keresési értékre van állítva.
encounterIdExpression	Hamis	Hamis
correlationIdExpression	Hamis	Hamis
values[].valueName	Igaz	Igaz
értékek[].valueExpression	Igaz	Igaz
értékek[].kötelezőek	Igaz	Igaz

Fontos

A Felbontás típus azt 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. Ha a rendszer megad egy találkozási azonosítót , és kinyeri az eszközadatok hasznos adatait, akkor a rendszer a megfigyeléshez csatolja, ha az FHIR szolgáltatásban ilyen azonosítóval rendelkezik. Ha a találkozás azonosítója sikeresen normalizálva van, de nem létezik FHIR-találkozás ezzel a találkozási azonosítóval, a rendszer kivételt hoz létre a FhirResourceNotFound kivétellel. A MedTech szolgáltatásfeloldási típus konfigurálásáról további információt a Cél lap konfigurálása című témakörben talál.

Megjegyzés:

A values[].valueName, values[].valueExpression. és values[].required az elemek csak akkor szükségesek, ha a tömbben van értékbejegyzés. Érvényes, hogy nincsenek leképezve értékek. Ezeket az elemeket akkor használja a rendszer, ha az elküldött telemetria esemény.

Előfordulhat például, hogy egyes forgatókönyvek esetében olyan FHIR-megfigyelést kell létrehozni az FHIR szolgáltatásban, amely nem tartalmaz értéket.

CollectionContent

A CollectionContent a MedTech szolgáltatás eszközleképezése által használt gyökérsablon-típus. A CollectionContent a normalizálási szakaszban használt összes sablon listája. A CollectionContenten belül definiálhat egy vagy több sablont, és a MedTech szolgáltatás által fogadott minden eszközüzenet kiértékelve lesz az összes sablonnal.

Ezeket a sablontípusokat a CollectionContentben használhatja a használati esettől függően:

A Közvetlenül a MedTech szolgáltatás eseményközpontjának küldött eszközüzenetekhez tartozó CalculatedContent . A CalculatedContent támogatja a JSONPath, a JMESPath, a JMESPath függvényeket és a MedTech szolgáltatás egyéni függvényeket.

Illetve

IotJsonPathContent az azure IoT Hubon keresztül a MedTech szolgáltatás eseményközpontjához irányítandó eszközüzenetekhez. Az IotJsonPathContent támogatja a JSONPathot.

Példa

Tipp.

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 olyan eszközüzenetet használunk, amely adatokat rögzít heartRate :

{
  "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"
      }
    ]
  }
]

Amikor a MedTech szolgáltatás feldolgozta az eszközüzenetet, a CollectionContent sablonjaival értékeli ki az üzenetet. Ez 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. Ha a typeMatchExpression kiértékelés igaz, akkor a rendszer az deviceIdExpression, timestampExpressionés valueExpression az értékeket használja a JSON-értékek megkereséséhez és kinyeréséhez az eszközüzenetből, és létrehoz egy normalizált üzenetet. Ebben a példában az összes kifejezés JSONPath nyelven van megírva, de a JMESPath-ban minden kifejezés írása érvényes lenne. A sablon szerzője határozza meg, hogy melyik kifejezés nyelve a legmegfelelőbb.

Tipp.

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 hibaelhárításával kapcsolatos 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, tekintse meg a MedTech szolgáltatásnaplókkal kapcsolatos hibák elhárítását.