Notifiche Pub/Sub

Questa pagina fornisce una panoramica sull'utilizzo di Pub/Sub per ricevere notifiche quando si verificano eventi clinici in un datastore dell'API Cloud Healthcare. Per informazioni su come configurare e utilizzare i messaggi Pub/Sub, consulta Configurazione delle notifiche Pub/Sub.

Panoramica

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

  • Archivi un'istanza DICOM in un archivio DICOM utilizzando il metodo dicomStores.dicomWeb.studies.storeInstances.
  • Importa un'istanza DICOM in un archivio DICOM utilizzando il metodo dicomStores.import.
  • Una risorsa FHIR viene creata, sottoposta a patch, aggiornata o eliminata in un archivio 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. Quando l'argomento Pub/Sub riceve il messaggio, questo verrà inoltrato a tutti i sottoscrittori dell'argomento.

Notifiche DICOM

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

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 messaggio HL7v2 viene importato o creato:

hl7v2_pubsub

  1. L'API Cloud Healthcare importa un messaggio HL7v2 da un sistema sanitario.
  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 alle sottoscrizioni degli argomenti.
  5. Gli abbonati ricevono una notifica, sotto forma di messaggio Pub/Sub, dal loro abbonamento. 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 possono essere utilizzati 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

Ogni volta che un'istanza DICOM viene memorizzata in un archivio DICOM, il seguente identificatore viene sempre incluso nel campo data del messaggio Pub/Sub:

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