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:

  • Une instance DICOM est stockée dans un magasin DICOM.
  • Une ressource FHIR est créé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.

Ces messages ne contiennent aucune information personnelle. Ils ne comprennent que les éléments suivants :

  • Le projet pour lequel le message est généré
  • L'ID du message
  • Dans les messages FHIR, le type resourceType et l'action à l'origine du message
  • Dans les messages HL7v2, le type de message HL7v2

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.

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
  • 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 ressources FHIR

Les modifications apportées aux ressources FHIR contiennent toujours l'identifiant suivant dans le champ data du message Pub/Sub:

projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/resources/RESOURCE_TYPE/RESOURCE_ID

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

Nom de l'attribut Valeurs possibles Exemple Description
action
  • CreateResource
  • UpdateResource
  • DeleteResource
CreateResource Type d'événement qui vient de se produire.
resourceType Tout type de ressource FHIR. Patient Type de ressource qui a été modifié.

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é.

Étape suivante