Übersicht über die Zuordnung der Geräte für den Medizintechnikdienst

Artikel
11/22/2023

In diesem Artikel finden Sie eine Übersicht über die Zuordnung der Geräte für den Medizintechnikdienst.

Der Medizintechnikdienst erfordert zwei JSON-Zuordnungstypen, die Ihrem Medizintechnikdienst über das Azure-Portal oder die ARM-API (Azure Resource Manager) hinzugefügt werden. Beim ersten Typ handelt es sich um die Gerätezuordnung. Diese steuert die Zuordnungswerte in den Gerätedaten, die an ein internes, normalisiertes Datenobjekt im Medizintechnikdienst gesendet werden. Die Gerätezuordnung enthält Ausdrücke, die der Medizintechnikdienst verwendet, um Typen, Geräte-IDs, Messdatumszeit und Messwerte zu extrahieren. Beim zweiten Typ handelt es sich um die FHIR®-Zielzuordnung, die die Zuordnung für FHIR-Beobachtungen steuern.

Hinweis

Die Geräte- und FHIR-Zielzuordnungen werden beim Verarbeiten einer Gerätemeldung jedes Mal neu ausgewertet. Aktualisierungen an jeglichen Zuordnungen werden sofort wirksam.

Grundlagen der Gerätezuordnung

Die Gerätezuordnung enthält Ausdrucksvorlagensammlungen, die verwendet werden, um Gerätemeldungsdaten zur weiteren Auswertung in ein internes, normalisiertes Format zu extrahieren. Jede empfangene Gerätemeldung wird für alle Ausdrucksvorlagen in der Sammlung ausgewertet. Durch diese Auswertung kann eine einzelne Gerätemeldung in mehrere ausgehende Meldungen unterteilt werden, die mehreren FHIR-Beobachtungen im FHIR-Dienst zugeordnet werden können.

Tipp

Weitere Informationen dazu, wie der Medizintechnikdienst Gerätemeldungsdaten zur Persistenz im FHIR-Dienst verarbeitet, finden Sie unter Übersicht über die Datenverarbeitungsphasen der Geräte für den Medizintechnikdienst.

In diesem Diagramm werden die Vorgänge während der Normalisierungsphase innerhalb des Medizintechnikdiensts dargestellt.

Prüfung der Gerätezuordnung

Der Normalisierungsprozess überprüft die Gerätezuordnung, bevor sie zur Verwendung gespeichert werden kann. Diese Elemente sind in den Gerätezuordnungsvorlagen erforderlich.

Gerätezuordnung

Element	Erforderlich in CalculatedContent	Erforderlich in IotJsonPathContent
typeName	True	True
typeMatchExpression	True	True
deviceIdExpression	True	FALSE und vollständig ignoriert
timestampExpression	True	FALSE und vollständig ignoriert
patientIdExpression	TRUE, wenn der Auflösungstyp des Medizintechnikdiensts auf Create festgelegt ist, und FALSE, wenn der Auflösungstyp des Medizintechnikdiensts auf Lookup festgelegt ist	TRUE, wenn der Auflösungstyp des Medizintechnikdiensts auf Create festgelegt ist, und FALSE, wenn der Auflösungstyp des Medizintechnikdiensts auf Lookup festgelegt ist
encounterIdExpression	False	False
correlationIdExpression	False	False
values[].valueName	True	True
values[].valueExpression	True	True
values[].required	True	True

Wichtig

Der Auflösungstyp gibt an, wie der Medizintechnikdienst Gerätedaten mit Geräteressourcen und Patientenressourcen verknüpft. Der Medizintechnikdienst liest Geräte- und Patientenressourcen aus dem FHIR-Dienst mithilfe von Geräte-IDs und Patienten-IDs. Wenn ein Untersuchungsbezeichner angegeben und aus den Gerätenutzdaten extrahiert wird, wird dieser mit der Beobachtung verknüpft, sofern eine Untersuchung im FHIR-Dienst mit diesem Bezeichner vorhanden ist. Wenn der Untersuchungsbezeichner erfolgreich normalisiert wird, jedoch keine FHIR-Untersuchung mit diesem Bezeichner vorhanden ist, wird die Ausnahme FhirResourceNotFound ausgelöst. Weitere Informationen zum Konfigurieren des Auflösungstyps für den Medizintechnikdienst finden Sie unter Konfigurieren der Registerkarte „Ziel“.

Hinweis

Die Elemente values[].valueName, values[].valueExpression und values[].required sind nur erforderlich, wenn Sie über einen Werteintrag im Array verfügen. Eine Zuordnung ohne Werte ist gültig. Diese Elemente werden verwendet, wenn es sich bei den gesendeten Telemetriedaten um ein Ereignis handelt.

In einigen Szenarios kann es beispielsweise erforderlich sein, eine FHIR-Beobachtung im FHIR-Dienst zu erstellen, die keinen Wert enthält.

CollectionContent

Bei CollectionContent handelt es sich um den Stammvorlagentyp, der von der Gerätezuordnung des Medizintechnikdiensts verwendet wird. CollectionContent ist eine Liste aller Vorlagen, die während der Normalisierungsphase verwendet werden. Sie können eine oder mehrere Vorlagen innerhalb von CollectionContent definieren, wobei jede vom Medizintechnikdienst empfangene Gerätemeldung für alle Vorlagen ausgewertet wird.

Je nach Anwendungsfall können Sie diese Vorlagentypen in CollectionContent verwenden:

CalculatedContent wird für Gerätemeldungen verwendet, die direkt an den Event Hub Ihres Medizintechnikdiensts gesendet werden. JSONPath, JMESPath, JMESPath-Funktionen und die benutzerdefinierten Funktionen des Medizintechnikdiensts werden von CalculatedContent unterstützt.

und/oder

IotJsonPathContent wird für Gerätemeldungen verwendet, die über Azure IoT Hub an den Event Hub Ihres Medizintechnikdiensts weitergeleitet werden. IotJsonPathContent unterstützt JSONPath.

Beispiel

Tipp

Sie können den Zuordnungsdebugger für den Medizintechnikdienst verwenden, um Unterstützung bei der Erstellung, Aktualisierung und Problembehandlung der Geräte für den Medizintechnikdienst und der FHIR-Zielzuordnungen zu erhalten. Mit dem Zuordnungsdebugger können Sie im Azure-Portal Inlineanpassungen ganz einfach in Echtzeit anzeigen und vornehmen. Der Zuordnungsdebugger kann außerdem verwendet werden, um Testgerätemeldungen hochzuladen, diese nach der Verarbeitung in normalisierten Nachrichten anzuzeigen und in FHIR-Beobachtungen umzuwandeln.

In diesem Beispiel wird eine Gerätemeldung verwendet, die heartRate-Daten erfasst:

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

Diese Gerätezuordnung wird für die Normalisierungsphase verwendet:

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

Die resultierende normalisierte Meldung sieht nach der Normalisierungsphase folgendermaßen aus:

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

Wenn der Medizintechnikdienst die Gerätemeldung verarbeitet, werden die CollectionContent-Vorlagen verwendet, um die Meldung auszuwerten. Um zu bestimmen, ob die Vorlage zur Erstellung einer normalisierten Meldung aus der Gerätemeldung verwendet werden soll, wird typeMatchExpression verwendet. Wenn die Auswertung von typeMatchExpression TRUE ergibt, werden die Werte von deviceIdExpression, timestampExpression und valueExpression zur Suche und Extrahierung von JSON-Werten aus der Gerätemeldung verwendet, um eine normalisierte Meldung zu erstellen. In diesem Beispiel werden alle Ausdrücke in JSONPath geschrieben. Das Schreiben aller Ausdrücke in JMESPath wäre jedoch ebenfalls gültig. Die Auswahl der am besten geeigneten Ausdruckssprache wird durch den oder die Ersteller*in bestimmt.

Tipp

Unterstützung beim Beheben allgemeiner Bereitstellungsfehler des Medizintechnikdiensts finden Sie unter Problembehandlung bei Bereitstellungsfehlern des Medizintechnikdiensts.

Unterstützung beim Beheben von Fehlern beim Medizintechnikdienst finden Sie unter Problembehandlung mithilfe der Medizintechnikdienstprotokolle.