Notifiche Pub/Sub

Questa pagina fornisce una panoramica sull'uso di Pub/Sub per ricevere Notifiche al verificarsi di eventi clinici nei dati di un'API Cloud Healthcare . Per scoprire come configurare e utilizzare i messaggi Pub/Sub, vedi Configurazione delle notifiche Pub/Sub.

Panoramica

Puoi ricevere notifiche utilizzando Pub/Sub quando si verifica uno dei seguenti eventi clinici:

  • Puoi archiviare un'istanza DICOM in un archivio DICOM utilizzando dicomStores.dicomWeb.studies.storeInstances .
  • Puoi importare un'istanza DICOM in un archivio DICOM utilizzando il metodo dicomStores.import.
  • Una risorsa FHIR viene creata, con patch, aggiornata o eliminata in un datastore FHIR. Tuttavia, Le notifiche non vengono inviate quando una risorsa FHIR viene importata da Cloud Storage.
  • Un messaggio HL7v2 viene importato o creato in un archivio HL7v2.

Le informazioni su ciascun evento vengono aggiunte all'argomento Pub/Sub del datastore corrispondente sotto forma di messaggio.

Puoi pubblicare messaggi in qualsiasi argomento Pub/Sub di tutti i progetti per i quali disponi di autorizzazioni sufficienti. Dopo il lancio di Pub/Sub a ogni argomento riceve il messaggio, quest'ultimo verrà inoltrato a abbonati all'argomento.

Notifiche DICOM

Per informazioni sull'utilizzo delle notifiche Pub/Sub con i dati DICOM, vedi Notifiche DICOM Pub/Sub.

Notifiche FHIR

Per informazioni sull'utilizzo delle notifiche Pub/Sub con i dati FHIR, consulta Notifiche Pub/Sub FHIR.

Notifiche HL7v2

Il seguente diagramma mostra il flusso di notifiche che si verificano quando un HL7v2 in cui il messaggio viene importato o creato:

hl7v2_pubsub

  1. L'API Cloud Healthcare importa un messaggio HL7v2 da un sistema di assistenza sanitaria.
  2. Il messaggio viene archiviato in un archivio HL7v2.
  3. L'archivio HL7v2 crea e invia un messaggio Pub/Sub agli argomenti Pub/Sub dell'archivio che hanno un filtro corrispondente al messaggio HL7v2.
  4. Pub/Sub inoltra il messaggio Pub/Sub alla argomenti abbonamenti.
  5. Gli abbonati ricevono una notifica, sotto forma di messaggio Pub/Sub della sottoscrizione. Ogni abbonamento può avere uno o più abbonati per un maggiore parallelismo.

Formato delle notifiche

Le notifiche inviate a un argomento Pub/Sub sono composte da due parti:

  • Attributi: un set di coppie chiave:valore che descrivono l'evento. Questi valori può essere utilizzata per filtrare gli eventi ricevuti da un client filtrando i messaggi di un abbonamento.
  • Dati: una stringa che contiene un identificatore per la risorsa FHIR, l'istanza DICOM o il messaggio HL7v2 in questione.

Dati delle istanze DICOM

Quando un'istanza DICOM viene archiviata in un archivio DICOM, il seguente identificatore è sempre incluso nel campo data di Pub/Sub messaggio:

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

Le notifiche per un'istanza DICOM archiviata non contengono valori attribute.

Dati e attributi dei messaggi HL7v2

Quando un messaggio HL7v2 viene creato o importato in un archivio HL7v2, il seguente identificatore viene sempre incluso nel campo data del messaggio Pub/Sub:

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

Il seguente set di coppie chiave:valore viene sempre incluso nel campo attributes del messaggio Pub/Sub:

Nome attributo Valori possibili Esempio Descrizione
msgType Qualsiasi tipo di messaggio HL7v2. ADT Il tipo di messaggio HL7v2 che è stato creato o importato.

Passaggi successivi