En esta página se ofrece una descripción general del uso de Pub/Sub para recibir notificaciones cuando se producen eventos clínicos en un almacén de datos de la API Cloud Healthcare. Para obtener más información sobre cómo configurar y utilizar los mensajes de Pub/Sub, consulta Configurar notificaciones de Pub/Sub.
Información general
Puedes recibir notificaciones con Pub/Sub cuando se produzca cualquiera de los siguientes eventos clínicos:
- Para almacenar una instancia DICOM en un almacén DICOM, usa el método
dicomStores.dicomWeb.studies.storeInstances. - Para importar una instancia DICOM a un almacén DICOM, usa el método
dicomStores.import. - Se crea, se le aplica un parche, se actualiza o se elimina un recurso FHIR en un almacén FHIR. Sin embargo, no se envían notificaciones cuando se importa un recurso FHIR desde Cloud Storage.
- Un mensaje HL7v2 se ingiere o se crea en un almacén HL7v2.
La información de cada evento se añade al tema de Pub/Sub del almacén de datos correspondiente en forma de mensaje.
Puedes publicar mensajes en cualquier tema de Pub/Sub de cualquier proyecto para el que tengas permisos suficientes. Una vez que el tema de Pub/Sub reciba el mensaje, se reenviará a todos los suscriptores del tema que quieras.
Notificaciones de DICOM
Para obtener información sobre cómo usar las notificaciones de Pub/Sub con datos DICOM, consulta Notificaciones de Pub/Sub de DICOM.
Notificaciones de FHIR
Para obtener información sobre cómo usar las notificaciones de Pub/Sub con datos de FHIR, consulta Notificaciones de Pub/Sub de FHIR.
Notificaciones HL7v2
En el siguiente diagrama se muestra el flujo de notificaciones que se produce cuando se ingiere o se crea un mensaje HL7v2:
- La API Cloud Healthcare ingiere un mensaje HL7v2 de un sistema de atención sanitaria.
- El mensaje se almacena en un almacén HL7v2.
- El almacén HL7v2 crea y envía un mensaje de Pub/Sub a los temas de Pub/Sub del almacén que tienen un filtro que coincide con el mensaje HL7v2.
- Pub/Sub reenvía el mensaje de Pub/Sub a las suscripciones de los temas.
- Los suscriptores reciben una notificación en forma de mensaje de Pub/Sub de su suscripción. Cada suscripción puede tener uno o varios suscriptores para aumentar el paralelismo.
Formato de las notificaciones
Las notificaciones enviadas a un tema de Pub/Sub constan de dos partes:
- Atributos: un conjunto de pares clave/valor que describen el evento. Estos valores se pueden usar para filtrar los eventos que recibe un cliente filtrando mensajes de una suscripción.
- Datos: una cadena que contiene un identificador del recurso FHIR, la instancia DICOM o el mensaje HL7v2 correspondientes.
Datos de una instancia DICOM
Cuando una instancia DICOM se almacena en un almacén DICOM, el siguiente identificador siempre se incluye en el campo data del mensaje de Pub/Sub:
projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID
Las notificaciones de una instancia DICOM almacenada no contienen ningún valor attribute.
Datos y atributos de un mensaje HL7v2
Cuando un mensaje HL7v2 se crea o se ingiere en un almacén HL7v2, el siguiente identificador siempre se incluye en el campo data del mensaje de Pub/Sub:
projects/PROJECT_ID/locations/us-central1/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID
El siguiente conjunto de pares clave/valor siempre se incluye en el campo attributes del mensaje de Pub/Sub:
| Nombre de atributo | Posibles valores | Ejemplo | Descripción |
|---|---|---|---|
msgType |
Cualquier tipo de mensaje HL7v2 | ADT |
El tipo de mensaje HL7v2 que se ha creado o ingerido |
Siguientes pasos
- Consulta la documentación de Pub/Sub.
- Para obtener una explicación detallada de Pub/Sub, consulta ¿Qué es Cloud Pub/Sub?.