Notificações do Pub/Sub

Nesta página, você encontra uma visão geral do uso do Pub/Sub para receber notificações quando ocorrem eventos médicos em um armazenamento de dados da API Cloud Healthcare. Para saber como configurar e usar mensagens do Pub/Sub, consulte Como configurar notificações do Pub/Sub.

Informações gerais

Receba notificações usando o Pub/Sub quando ocorrer um dos seguintes eventos clínicos:

  • É possível armazenar uma instância DICOM em um armazenamento DICOM usando o método dicomStores.dicomWeb.studies.storeInstances.
  • Importe uma instância DICOM para um armazenamento DICOM usando o método dicomStores.import.
  • Um recurso FHIR é criado, corrigido, atualizado ou excluído em um armazenamento FHIR. No entanto, as notificações não são enviadas quando um recurso FHIR é importado do Cloud Storage.
  • Uma mensagem HL7v2 é ingerida ou criada em um armazenamento HL7v2.

As informações sobre cada evento são adicionadas ao tópico do Pub/Sub do armazenamento de dados correspondente na forma de uma mensagem.

É possível publicar mensagens em qualquer tópico do Pub/Sub em qualquer projeto em que você tenha permissões suficientes. Depois que o tópico do Pub/Sub receber a mensagem, ela será encaminhada para qualquer quantidade de assinantes do tópico.

Notificações DICOM

Para mais informações sobre o uso de notificações do Pub/Sub com dados DICOM, consulte Notificações DICOM do Pub/Sub.

Notificações FHIR

Para mais informações sobre como usar as notificações do Pub/Sub com dados FHIR, consulte Notificações FHIR do Pub/Sub.

Notificações do HL7v2

O diagrama a seguir mostra o fluxo de notificações que ocorrem quando uma mensagem HL7v2 é processada ou criada:

hl7v2_pubsub

  1. A API Cloud Healthcare processa uma mensagem HL7v2 de um sistema de saúde.
  2. A mensagem é armazenada em um armazenamento HL7v2.
  3. O armazenamento HL7v2 cria e envia uma mensagem do Pub/Sub para os tópicos do Pub/Sub que tenham um filtro que corresponda à mensagem HL7v2.
  4. O Pub/Sub encaminha a mensagem do Pub/Sub para as assinaturas dos tópicos.
  5. Os assinantes recebem uma notificação da assinatura, na forma de uma mensagem do Pub/Sub. Cada assinatura pode ter um ou mais assinantes para aumentar o paralelismo.

Formato da notificação

As notificações enviadas para um tópico do Pub/Sub consistem em duas partes:

  • Atributos: um conjunto de pares de chave-valor que descreve o evento. Esses valores podem ser usados para filtrar quais eventos um cliente recebe ao filtrar mensagens de uma assinatura.
  • Dados: uma string que contém um identificador para o recurso FHIR, a instância do DICOM ou mensagem HL7v2 relevante.

Dados da instância do DICOM

Quando uma instância do DICOM é armazenada em um armazenamento DICOM, o identificador a seguir é sempre incluído no campo data da mensagem do Pub/Sub:

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

As notificações de uma instância do DICOM armazenada não contêm valores attribute.

Dados e atributos de mensagens HL7v2

Quando uma mensagem HL7v2 é criada ou ingerida em um armazenamento HL7v2, o seguinte identificador é sempre incluído no campo data da mensagem do Pub/Sub:

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

O seguinte conjunto de pares de chave-valor sempre é incluído no campo attributes da mensagem do Pub/Sub:

Nome do atributo Valores possíveis Exemplo Descrição
msgType Qualquer tipo de mensagem HL7v2. ADT O tipo de mensagem HL7v2 que foi criada ou ingerida.

A seguir