Přehled mapování zařízení služby MedTech

Článek
11/08/2023

Tento článek obsahuje přehled mapování zařízení služby MedTech.

Služba MedTech vyžaduje dva typy mapování JSON , které se přidají do vaší služby MedTech prostřednictvím webu Azure Portal nebo rozhraní API Azure Resource Manageru (ARM). Mapování zařízení je prvním typem a řídí hodnoty mapování v datech zařízení odesílaných do služby MedTech do interního normalizovaného datového objektu. Mapování zařízení obsahuje výrazy, které služba MedTech používá k extrakci typů, identifikátorů zařízení, data měření a hodnot měření. Mapování cíle FHIR je druhým typem a řídí mapování pro pozorování FHIR®.

Poznámka:

Mapování cílů zařízení a FHIR se při každém zpracování zprávy zařízení znovu vyhodnotí. Všechny aktualizace mapování se projeví okamžitě.

Základy mapování zařízení

Mapování zařízení obsahuje kolekce šablon výrazů sloužících k extrakci dat zpráv zařízení do interního normalizovaného formátu pro další vyhodnocení. Každá přijatá zpráva zařízení se vyhodnocuje vůči všem šablonám výrazů v kolekci. Toto vyhodnocení znamená, že jednu zprávu zařízení je možné rozdělit do několika odchozích zpráv, které je možné namapovat na více pozorování FHIR ve službě FHIR.

Tip

Další informace o tom, jak služba MedTech zpracovává data zpráv zařízení do FHIR Observations pro trvalost ve službě FHIR, naleznete v tématu Přehled fází zpracování dat zařízení služby MedTech.

Tento diagram znázorňuje, co se stane během fáze normalizace v rámci služby MedTech.

Ověřování mapování zařízení

Proces normalizace ověří mapování zařízení před povolením jeho uložení pro použití. Tyto prvky jsou vyžadovány v šablonách mapování zařízení.

Mapování zařízení

Element (Prvek)	Požadováno v calculatedContent	Požadováno v IotJsonPathContent
Typename	True	True
typeMatchExpression	True	True
deviceIdExpression	True	Nepravda a zcela ignorováno.
timestampExpression	True	Nepravda a zcela ignorováno.
patientIdExpression	Hodnota True, pokud je typ řešení služby MedTech nastaven na Vytvořit; Nepravda, pokud je typ řešení služby MedTech nastavený na Lookup.	Hodnota True, pokud je typ řešení služby MedTech nastaven na Vytvořit; Nepravda, pokud je typ řešení služby MedTech nastavený na Lookup.
encounterIdExpression	False	False
correlationIdExpression	False	False
values[].valueName	True	True
values[].valueExpression	True	True
values[].required	True	True

Důležité

Typ řešení určuje, jak služba MedTech přidruží data zařízení k prostředkům zařízení a prostředkům pacientů. Služba MedTech čte prostředky zařízení a pacientů ze služby FHIR pomocí identifikátorů zařízení a identifikátorů pacientů. Pokud je zadaný identifikátor výskytu a extrahován z datové části dat zařízení, je propojen s pozorováním, pokud na službě FHIR existuje s tímto identifikátorem. Pokud je identifikátor výskytu úspěšně normalizován, ale s tímto identifikátorem není nalezen žádný záznam FHIR, vyvolá se výjimka FhirResourceNotFound. Další informace o konfiguraci typu řešení služby MedTech naleznete v tématu Konfigurace cílové karty.

Poznámka:

Elementy values[].valueName, values[].valueExpressiona values[].required prvky jsou vyžadovány pouze v případě, že máte v poli položku hodnoty. Je platné, aby nebyly mapovány žádné hodnoty. Tyto prvky se používají při odesílání telemetrie událostí.

Některé scénáře můžou například vyžadovat vytvoření pozorování FHIR ve službě FHIR, která neobsahuje hodnotu.

CollectionContent

CollectionContent je typ kořenové šablony používaný mapováním zařízení služby MedTech. CollectionContent je seznam všech šablon, které se používají během fáze normalizace. V kolekciContent můžete definovat jednu nebo více šablon, přičemž každá zpráva zařízení přijatá službou MedTech se vyhodnocuje proti všem šablonám.

Tyto typy šablon můžete použít v kolekciContent v závislosti na vašem případu použití:

CalculatedContent pro zprávy zařízení odeslané přímo do centra událostí služby MedTech. CalculatedContent podporuje funkce JSONPath, JMESPath, JMESPath a vlastní funkce služby MedTech.

Nebo

IotJsonPathContent pro zprávy zařízení směrované přes Azure IoT Hub do centra událostí služby MedTech. IotJsonPathContent podporuje JSONPath.

Příklad

Tip

Ladicí program mapování služby MedTech můžete použít k pomoci s vytvářením, aktualizací a odstraňováním potíží se zařízením služby MedTech a cílovými mapováními FHIR. Ladicí program mapování umožňuje snadno zobrazit a provádět vložené úpravy v reálném čase, aniž byste museli opustit Azure Portal. Ladicí program mapování lze použít také k nahrání zpráv testovacího zařízení, abyste zjistili, jak budou vypadat po zpracování do normalizovaných zpráv a transformují se na FHIR Observations.

V tomto příkladu používáme zprávu zařízení, která zachycuje heartRate data:

{
  "heartRate": "78",
  "endDate": "2023-03-13T22:46:01.8750000",
  "deviceId": "device01"
}

Toto mapování zařízení používáme pro fázi normalizace:

{
  "templateType": "CollectionContent",
  "template": [
    {
      "templateType": "CalculatedContent",
      "template": {
        "typeName": "heartrate",
        "typeMatchExpression": "$..[?(@heartRate)]",
        "deviceIdExpression": "$.matchedToken.deviceId",
        "timestampExpression": "$.matchedToken.endDate",
        "values": [
          {
            "required": true,
            "valueExpression": "$.matchedToken.heartRate",
            "valueName": "hr"
          }
        ]
      }
    }
  ]
}

Výsledná normalizovaná zpráva bude vypadat takto po fázi normalizace:

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

Při zpracování zprávy zařízení služba MedTech se šablony v kolekciContent používají k vyhodnocení zprávy. Slouží typeMatchExpression k určení, jestli se šablona má použít k vytvoření normalizované zprávy ze zprávy zařízení. Pokud se typeMatchExpression vyhodnotí jako true, pak deviceIdExpressiontimestampExpressionse hodnoty a valueExpression hodnoty použijí k vyhledání a extrahování hodnot JSON ze zprávy zařízení a vytvoření normalizované zprávy. V tomto příkladu se všechny výrazy zapisují do JSONPathu, ale všechny výrazy by byly platné pro zápis všech výrazů v JMESPathu. Je na autorovi šablony, aby určil, který jazyk výrazu je nejvhodnější.

Tip

Pomoc s opravou běžných chyb nasazení služby MedTech najdete v tématu Řešení chyb nasazení služby MedTech.

Pomoc s opravou chyb služby MedTech najdete v tématu Řešení chyb pomocí protokolů služby MedTech.