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 scoprire come impostare 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:

  • Puoi archiviare un'istanza DICOM in un archivio DICOM utilizzando il metodo dicomStores.dicomWeb.studies.storeInstances.
  • Puoi importare 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 in qualsiasi progetto per il quale disponi di autorizzazioni sufficienti. Dopo che l'argomento Pub/Sub riceve il messaggio, questo verrà inoltrato a un numero qualsiasi di sottoscrittori all'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 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 dispongono di un filtro che corrisponde al messaggio HL7v2.
  4. Pub/Sub inoltra il messaggio Pub/Sub alle sottoscrizioni degli argomenti.
  5. I sottoscrittori ricevono una notifica, sotto forma di messaggio Pub/Sub, dalla loro 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 possono essere utilizzati per filtrare gli eventi ricevuti da un client filtrando i messaggi di una sottoscrizione.
  • 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 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 è sempre incluso nel campo attributes del messaggio Pub/Sub:

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

Passaggi successivi