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 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.
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 |
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:
- CalculatedContent a MedTech szolgáltatás eseményközpontjának közvetlenül küldött eszközüzenetekhez. 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 eszközüzenetek Azure IoT Hub a MedTech szolgáltatás eseményközpontba való átirányításához. 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é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éhez lásd:
Az FHIR® a Health Level Seven International bejegyzett védjegye, amelyet az Egyesült Államok Védjegyhivatalában regisztráltak, és engedélyükkel használják.