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

Fontos

A MedTech szolgáltatás elavulását 2025. május 3-ával kezdeményezték. Ha a MedTech szolgáltatás használata már nem prioritás, bontsa ki a példányt, amely itt található. Az aktív példányok támogatása a következő régiókban 2028. május 3-ával fejeződik be: USA 2. nyugati régiója, Egyesült Királyság déli régiója, Nyugat-Európa, USA keleti régiója, USA 2. keleti régiója, Közép-India, Észak-Európa. A MedTech szolgáltatás nyílt forráskódú verziója itt található.

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.

Jótanács

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

Element	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ípusaLétrehozás értékre van állítva; Hamis, ha a MedTech szolgáltatás Felbontás típusaKeresési értékre van állítva.	Igaz, ha a MedTech szolgáltatás Felbontás típusaLétrehozás értékre van állítva; Hamis, ha a MedTech szolgáltatás Felbontás típusaKeresési értékre van állítva.
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. 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á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:

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.

és/vagy

• 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.

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

Amikor a MedTech szolgáltatás feldolgozta az eszközüzenetet, a CollectionContent sablonjaival értékeli ki az üzenetet. 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. 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.

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.

Következő lépések

A CalculatedContent-sablonok használata a MedTech szolgáltatás eszközleképezésével

IotJsonPathContent-sablonok használata a MedTech szolgáltatás eszközleképezésével

Egyéni függvények használata a MedTech szolgáltatás eszközleképezésével

A MedTech szolgáltatás FHIR célleképezésének áttekintése

A MedTech szolgáltatás forgatókönyvalapú leképezési mintáinak áttekintése

Megjegyzés:

Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.