Notificações do Pub/Sub

Esta página oferece uma vista geral da utilização do Pub/Sub para receber notificações quando ocorrem eventos clínicos num arquivo de dados da Cloud Healthcare API. Para saber como configurar e usar mensagens do Pub/Sub, consulte o artigo Configurar notificações do Pub/Sub.

Vista geral

Pode receber notificações através do Pub/Sub quando ocorre qualquer um dos seguintes eventos clínicos:

  • Armazena uma instância DICOM num arquivo DICOM através do método dicomStores.dicomWeb.studies.storeInstances.
  • Importa uma instância DICOM para um arquivo DICOM através do método dicomStores.import.
  • Um recurso FHIR é criado, corrigido, atualizado ou eliminado numa loja FHIR. No entanto, não são enviadas notificações quando um recurso FHIR é importado do Cloud Storage.
  • Uma mensagem HL7v2 é carregada ou criada num armazenamento de HL7v2.

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

Pode publicar mensagens em qualquer tópico do Pub/Sub em qualquer projeto para o qual tenha autorizações suficientes. Depois de o tópico do Pub/Sub receber a mensagem, esta é encaminhada para qualquer número de subscritores do tópico.

Notificações DICOM

Para obter informações sobre a utilização de notificações do Pub/Sub com dados DICOM, consulte o artigo Notificações do DICOM Pub/Sub.

Notificações FHIR

Para obter informações sobre a utilização de notificações do Pub/Sub com dados FHIR, consulte o artigo Notificações do FHIR Pub/Sub.

Notificações HL7v2

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

hl7v2_pubsub

  1. A Cloud Healthcare API carrega uma mensagem de HL7v2 de um sistema de cuidados.
  2. A mensagem é armazenada num armazenamento de HL7v2.
  3. O arquivo HL7v2 cria e envia uma mensagem Pub/Sub para os tópicos Pub/Sub do arquivo que têm um filtro que corresponde à mensagem HL7v2.
  4. O Pub/Sub encaminha a mensagem do Pub/Sub para as subscrições dos tópicos.
  5. Os subscritores recebem uma notificação, sob a forma de uma mensagem Pub/Sub, da respetiva subscrição. Cada subscrição pode ter um ou mais subscritores para aumentar o paralelismo.

Formato de notificação

As notificações enviadas para um tópico do Pub/Sub são compostas por duas partes:

  • Atributos: um conjunto de pares chave:valor que descrevem o evento. Estes valores podem ser usados para filtrar os eventos que um cliente recebe filtrando mensagens de uma subscrição.
  • Data: uma string que contém um identificador para o recurso FHIR relevante, a instância DICOM ou a mensagem HL7v2.

Dados de instâncias DICOM

Quando uma instância DICOM é armazenada num arquivo DICOM, o seguinte identificador é sempre incluído no campo data da mensagem 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 DICOM armazenada não contêm valores attribute.

Dados e atributos de mensagens HL7v2

Quando uma mensagem HL7v2 é criada ou carregada para uma loja 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 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 carregada.

O que se segue?