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:
- L'API Cloud Healthcare importa un messaggio HL7v2 da un sistema di assistenza sanitaria.
- 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 dispongono di un filtro che corrisponde al messaggio HL7v2.
- Pub/Sub inoltra il messaggio Pub/Sub alle sottoscrizioni degli argomenti.
- 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
- Leggi la documentazione di Pub/Sub.
- Per una spiegazione approfondita di Pub/Sub, consulta Che cos'è Cloud Pub/Sub?