Freigeben über


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

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.

Diagram example of the MedTech service device message normalization stage.

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:

und/oder

Diagram showing MedTech service device mapping templates architecture.

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.

Nächste Schritte

Verwenden von CalculatedContent-Vorlagen für Gerätezuordnungen mit dem Medizintechnikdienst

Verwenden von IotJsonPathContent-Vorlagen für Gerätezuordnungen mit dem Medizintechnikdienst

Verwenden benutzerdefinierter Funktionen für Gerätezuordnung mit dem Medizintechnikdienst

Übersicht über die FHIR-Zielzuordnungen des Medizintechnikdiensts

Übersicht über Beispiele für szenariobasierte Zuordnungen im Medizintechnikdienst

Hinweis

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.