A MedTech szolgáltatás eszközleképezésének áttekintése
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.
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.