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:
- L'API Cloud Healthcare importa un messaggio HL7v2 da un sistema sanitario.
- Il messaggio viene archiviato in un archivio HL7v2.
- L'archivio HL7v2 crea e invia un messaggio Pub/Sub agli argomenti Pub/Sub dell'archivio che hanno un filtro corrispondente al messaggio HL7v2.
- Pub/Sub inoltra il messaggio Pub/Sub alle sottoscrizioni degli argomenti.
- 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
- Leggi la documentazione di Pub/Sub.
- Per una spiegazione approfondita di Pub/Sub, consulta Che cos'è Cloud Pub/Sub?