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

Megjegyzés

A Fast Healthcare Interoperability Resources (FHIR®) egy nyílt egészségügyi specifikáció.

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 a Azure Portal vagy az Azure Resource Manager (ARM) API-val adnak hozzá a MedTech szolgáltatáshoz. Az eszközleképezés az első típus, és szabályozza a MedTech szolgáltatásnak egy belső, normalizált adatobjektumnak küldött eszközadatok leképezési értékeit. 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, amely az FHIR-megfigyelések leképezését szabályozza.

Megjegyzés

Az eszköz- és az FHIR-célleképezéseket minden alkalommal újra kiértékeli a rendszer, amikor az eszközüzenetek 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 kifejezéssablonok gyűjteményeit tartalmazza, amelyeket az eszközüzenetek adatainak belső, normalizált formátumba való kinyeréséhez használnak további kiértékeléshez. A rendszer minden fogadott eszközüzenetet kiértékel a gyűjtemény összes kifejezéssablonja alapján. Ez a kiértékelés azt jelenti, hogy egyetlen eszközüzenet több kimenő üzenetre is szétválasztható, amelyek több FHIR-megfigyelésre is leképezhetők az FHIR szolgáltatásban.

Tipp

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

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

Példa a MedTech szolgáltatás eszközüzeneteinek normalizálási fázisára.

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

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

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 hagyja.
timestampExpression Igaz Hamis, és teljesen figyelmen kívül hagyja.
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 Hamis Hamis
correlationIdExpression Hamis Hamis
values[].valueName Igaz Igaz
values[].valueExpression Igaz Igaz
értékek[].kötelező Igaz Igaz

Fontos

A Megoldás típusa azt határozza meg, hogy a MedTech szolgáltatás hogyan társítja az eszközadatokat az eszközerőforrásokhoz és a betegerőforrásokhoz. A MedTech szolgáltatás eszközazonosítók és betegazonosítók használatával olvassa be az eszköz- és betegerőforrásokat az FHIR szolgáltatásból. Ha a rendszer megad egy találkozásazonosítót , és kinyeri az eszközadatok hasznos adataiból, akkor a rendszer társítja a megfigyeléshez, ha az FHIR szolgáltatásban ilyen azonosítóval találkozik. Ha a találkozásazonosító sikeresen normalizálva van, de ezzel a találkozási azonosítóval nem létezik FHIR-találkozás, a rendszer kivételt ad a FhirResourceNotFound függvényhez. A MedTech szolgáltatásfeloldási típus konfigurálásával kapcsolatos további információkért lásd : Célhely konfigurálása lap.

Megjegyzés

A values[].valueName, values[].valueExpression, és values[].required elem csak akkor szükséges, 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.

Egyes forgatókönyvek például megkövetelik egy FHIR-megfigyelés létrehozását 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. Definiálhat egy vagy több sablont a CollectionContenten belül, és a MedTech szolgáltatás által fogadott eszközüzenetek kiértékelése az összes sablon alapján történik.

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

és/vagy

Diagram a MedTech szolgáltatás eszközleképezési sablonjainak architektúrájáról.

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és hibakeresővel egyszerűen megtekintheti és elvégezheti a beágyazott módosításokat valós időben anélkül, hogy el kellene hagynia a Azure Portal. A leképezési hibakereső teszteszköz-üzenetek feltöltésére is használható, hogy lássa, hogyan fognak kinézni, miután normalizált üzenetekké dolgozták fel őket, és FHIR-megfigyelésekké alakítják át őket.

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 használjuk a normalizálási fázishoz:

{
  "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ényül kapott normalizált üzenet így fog kinézni a normalizálási fázis után:

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

Amikor a MedTech szolgáltatás feldolgozja 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ára az eszközüzenetből. Ha a typeMatchExpression kiértékelés igaz, akkor a deviceIdExpression, timestampExpressionés valueExpression az értékekkel megkeresheti és kinyerheti a JSON-értékeket 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ést meg kell írni. 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 lásd: A MedTech szolgáltatás üzembehelyezési hibáinak elhárítása.

Ha segítségre van szüksége a MedTech szolgáltatás hibáinak elhárításához, olvassa el a Hibák elhárítása a MedTech szolgáltatásnaplókkal című témakört.

Következő lépések

Ebben a cikkben áttekintést kapott a MedTech szolgáltatás eszközleképezéséről.

Ha meg szeretné tudni, hogyan használhatja a CalculatedContentet a MedTech szolgáltatás eszközleképezésével, tekintse meg a

Az IotJsonPathContent és a MedTech szolgáltatás eszközleképezésével kapcsolatos további információkért lásd:

Az egyéni függvények MedTech szolgáltatásbeli eszközleképezéssel való használatával kapcsolatos további információkért lásd:

A MedTech szolgáltatás FHIR-célleképezésének áttekintését lásd:

A MedTech szolgáltatás forgatókönyvalapú leképezési mintáinak áttekintéséért lásd:

Az FHIR® a Health Level Seven International bejegyzett védjegye, amely az Amerikai Egyesült Államok védjegyhivatalában van regisztrálva, és az engedélyükkel használják.