Pub/Sub-Benachrichtigungen

Diese Seite bietet einen Überblick über die Verwendung von Pub/Sub für den Empfang von Benachrichtigungen, wenn klinische Ereignisse in einem Cloud Healthcare API-Datenspeicher auftreten. Informationen zum Einrichten und Verwenden von Pub/Sub-Nachrichten finden Sie unter Pub/Sub-Benachrichtigungen konfigurieren.

Übersicht

Sie können über Pub/Sub Benachrichtigungen erhalten, wenn eines der folgenden Ereignisse auftritt:

  • Sie speichern eine DICOM-Instanz mit der Methode dicomStores.dicomWeb.studies.storeInstances in einem DICOM-Speicher.
  • Sie importieren eine DICOM-Instanz mit der Methode dicomStores.import in einen DICOM-Speicher.
  • Eine FHIR-Ressource wird in einem FHIR-Speicher erstellt, gepatcht, aktualisiert oder gelöscht. Allerdings werden keine Benachrichtigungen gesendet, wenn eine FHIR-Ressource aus Cloud Storage importiert wird.
  • Eine HL7v2-Nachricht wird in einen HL7v2-Speicher aufgenommen oder darin erstellt.

Informationen zu jedem Ereignis werden dem Pub/Sub-Thema des entsprechenden Datenspeichers in Form einer Nachricht hinzugefügt.

Sie können Nachrichten für jedes Pub/Sub-Thema in jedem Projekt veröffentlichen, für das Sie ausreichende Berechtigungen haben. Nach dem Eingang der Nachricht beim Pub/Sub-Thema wird die Nachricht an eine beliebige Anzahl von Abonnenten des Themas weitergeleitet.

DICOM-Benachrichtigungen

Informationen zur Verwendung von Pub/Sub-Benachrichtigungen mit DICOM-Daten finden Sie unter DICOM Pub/Sub-Benachrichtigungen.

FHIR-Benachrichtigungen

Informationen zur Verwendung von Pub/Sub-Benachrichtigungen mit FHIR-Daten finden Sie unter FHIR Pub/Sub-Benachrichtigungen.

HL7v2-Benachrichtigungen

Das folgende Diagramm zeigt den Fluss von Benachrichtigungen, die auftreten, wenn eine HL7v2-Nachricht aufgenommen oder erstellt wird:

hl7v2_pubsub

  1. Die Cloud Healthcare API nicht eine HL7v2-Nachricht aus einem Caret-System auf.
  2. Die Nachricht wird in einem HL7v2-Speicher gespeichert.
  3. Der HL7v2-Speicher erstellt und sendet eine Pub/Sub-Nachricht an die Pub/Sub-Themen des Speichers, deren Filter mit der HL7v2-Nachricht übereinstimmen.
  4. Pub/Sub leitet die Pub/Sub-Nachricht an die Abos des Themas weiter.
  5. Die Abonnenten erhalten von ihrem Abo eine Benachrichtigung in Form einer Pub/Sub-Nachricht. Jedes Abo kann einen oder mehrere Abonnenten haben, um die Parallelität zu erhöhen.

Benachrichtigungsformat

Benachrichtigungen, die an ein Pub/Sub-Thema gesendet werden, bestehen aus zwei Teilen:

  • Attribute: Eine Reihe von Schlüssel/Wert-Paaren, die das Ereignis beschreiben Mit diesen Werten können Sie filtern, welche Ereignisse ein Client erhält. Dazu können Sie Nachrichten aus einem Abo filtern.
  • Daten: ein String, der eine Kennzeichnung für die entsprechende FHIR-Ressource, DICOM-Instanz oder HL7v2-Nachricht enthält

DICOM-Instanzdaten

Wenn eine DICOM-Instanz in einem DICOM-Speicher gespeichert wird, ist im Feld data der Pub/Sub-Nachricht immer die folgende Kennzeichnung enthalten:

projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID

Benachrichtigungen für eine gespeicherte DICOM-Instanz enthalten keine attribute-Werte.

HL7v2-Nachrichtendaten und -Attribute

Wenn eine HL7v2-Nachricht erstellt oder in einen HL7v2-Speicher aufgenommen wird, ist die folgende Kennzeichnung immer im Feld data der Pub/Sub-Nachricht enthalten:

projects/PROJECT_ID/locations/us-central1/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID

Die folgenden Schlüssel/Wert-Paare sind immer im Feld attributes der Pub/Sub-Nachricht enthalten:

Attributname Mögliche Werte Beispiel Beschreibung
msgType Ein beliebiger HL7v2-Nachrichtentyp ADT Der erstellte oder aufgenommene HL7v2-Nachrichtentyp

Nächste Schritte