Notifications Pub/Sub

Cette page présente l'utilisation de Pub/Sub pour recevoir des notifications lorsque des événements médicaux se produisent dans un magasin de données de l'API Cloud Healthcare. Pour apprendre à configurer et utiliser cette fonctionnalité, consultez la section Configurer les notifications Pub/Sub.

Présentation

Vous pouvez recevoir des notifications via Pub/Sub dans les cas suivants:

  • Vous stockez une instance DICOM dans un magasin DICOM à l'aide de la méthode dicomStores.dicomWeb.studies.storeInstances.
  • Vous importez une instance DICOM dans un magasin DICOM à l'aide de la méthode dicomStores.import.
  • Une ressource FHIR est créée, corrigée, mise à jour ou supprimée dans un magasin FHIR. Cependant, les notifications ne sont pas envoyées lorsqu'une ressource FHIR est importée depuis Cloud Storage.
  • Un message HL7v2 est ingéré ou créé dans un magasin HL7v2.

Les informations concernant chaque événement sont ajoutées sous forme de message au sujet Pub/Sub du magasin de données correspondant.

Vous pouvez publier des messages dans n'importe quel sujet Pub/Sub d'un projet pour lequel vous disposez des autorisations suffisantes. Une fois que le sujet Pub/Sub a reçu le message, celui-ci est transmis aux abonnés au sujet, quel que soit leur nombre.

Notifications DICOM

Pour plus d'informations sur l'utilisation des notifications Pub/Sub avec des données DICOM, consultez la section Notifications Pub/Sub DICOM.

Notifications FHIR

Pour en savoir plus sur l'utilisation des notifications Pub/Sub avec des données FHIR, consultez la section Notifications Pub/Sub FHIR.

Notifications HL7v2

Le schéma suivant illustre le flux de notifications qui se produisent lorsqu'un message HL7v2 est ingéré ou créé :

hl7v2_pubsub

  1. L'API Cloud Healthcare ingère un message HL7v2 provenant d'un système de soins.
  2. Le message est stocké dans un magasin HL7v2.
  3. Le magasin HL7v2 crée et envoie un message Pub/Sub aux sujets Pub/Sub du magasin dont le filtre correspond au message HL7v2.
  4. Pub/Sub transmet le message Pub/Sub aux abonnements des sujets.
  5. Les abonnés reçoivent une notification, sous la forme d'un message Pub/Sub, de leur abonnement. Chaque abonnement peut avoir un ou plusieurs abonnés pour accroître le parallélisme.

Format des notifications

Les notifications envoyées à un sujet Pub/Sub se composent de deux parties:

  • Attributs : ensemble de paires valeur/clé décrivant l'événement Ces valeurs peuvent être utilisées pour filtrer les événements qu'un client reçoit en filtrant les messages d'un abonnement.
  • Données : chaîne contenant un identifiant pour la ressource FHIR, l'instance DICOM ou le message HL7v2 concerné

Données de l'instance DICOM

Lorsqu'une instance DICOM est stockée dans un magasin DICOM, l'identifiant suivant est toujours inclus dans le champ data du message Pub/Sub:

projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID

Les notifications concernant une instance DICOM stockée ne contiennent aucune valeur attribute.

Données et attributs de messages HL7v2

Lorsqu'un message HL7v2 est créé ou ingéré dans un magasin HL7v2, l'identifiant suivant est toujours inclus dans le champ data du message Pub/Sub:

projects/PROJECT_ID/locations/us-central1/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID

L'ensemble de paires clé / valeur suivant est toujours inclus dans le champ attributes du message Pub / Sub:

Nom de l'attribut Valeurs possibles Exemple Description
msgType Tout type de message HL7v2. ADT Type de message HL7v2 créé ou ingéré.

Étapes suivantes