Notificaciones de Pub/Sub

En esta página, se proporciona una descripción general del uso de Pub/Sub para recibir notificaciones cuando ocurren eventos clínicos en un almacén de datos de la API de Cloud Healthcare. Si deseas obtener más información para configurar y usar los mensajes de Pub/Sub, consulta Configura las notificaciones de Pub/Sub.

Descripción general

Puedes recibir notificaciones mediante Pub/Sub cuando ocurre alguno de los siguientes eventos clínicos:

  • Almacena una instancia de DICOM en un almacén de DICOM con el método dicomStores.dicomWeb.studies.storeInstances.
  • Importas una instancia de DICOM a un almacén de DICOM con el método dicomStores.import.
  • Se crea, se le aplican parches, se actualiza o se borra un recurso de FHIR en un almacén de FHIR. Sin embargo, las notificaciones no se envían cuando el recurso de FHIR se importa desde Cloud Storage.
  • Un mensaje HL7v2 se transfiere o se crea en un almacén HL7v2.

La información sobre cada evento se agrega al tema de Pub/Sub del almacén de datos correspondiente en forma de un mensaje.

Puedes publicar mensajes en cualquier tema de Pub/Sub, en cualquier proyecto para el que tengas los permisos requeridos. Después de que el tema de Pub/Sub recibe el mensaje, el mensaje se reenviará a cualquier cantidad de suscriptores del tema.

Notificaciones de DICOM

Para obtener información sobre el uso de las notificaciones de Pub/Sub con datos de DICOM, consulta Notificaciones de Pub/Sub de DICOM.

Notificaciones de FHIR

Si deseas obtener información para usar las notificaciones de Pub/Sub con datos de FHIR, consulta Notificaciones de Pub/Sub de FHIR.

Notificaciones de HL7v2

En el siguiente diagrama, se muestra el flujo de notificaciones que se generan cuando se transfiere o se crea un mensaje de HL7v2:

hl7v2_pubsub

  1. La API de Cloud Healthcare transfiere un mensaje HL7v2 desde un sistema de asistencia sanitaria.
  2. El mensaje se almacena en un almacén de HL7v2.
  3. El almacén de 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.
  4. Pub/Sub reenvía el mensaje de Pub/Sub a las suscripciones de los temas.
  5. Los suscriptores reciben una notificación en forma de mensaje de Pub/Sub, desde su suscripción. Cada suscripción puede tener uno o más suscriptores para aumentar el paralelismo.

Formato de las notificaciones

Las notificaciones enviadas al 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 los mensajes de una suscripción.
  • Datos: una string que contiene un identificador para el recurso de FHIR relevante, una instancia de DICOM o el mensaje HL7v2.

Datos de instancia de DICOM

Cuando una instancia de DICOM se almacena en un almacén de 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 para una instancia de DICOM almacenada no contienen ningún valor attribute.

Datos y atributos de mensajes de HL7v2

Cuando se crea o transfiere un mensaje HL7v2 a 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 del atributo Valores posibles Ejemplo Descripción
msgType Cualquier tipo de mensaje de HL7v2 ADT El tipo de mensaje de HL7v2 que se creó o transfirió.

¿Qué sigue?