Consulte os conetores suportados para a solução Application Integration.

Acionador HL7

O acionador HL7 é um acionador de eventos de conector que lhe permite invocar uma integração com base nos eventos HL7 aos quais subscreveu na sua ligação HL7.

Antes de começar

  • Crie um tópico do Pub/Sub.
  • Crie um armazenamento de HL7.

  • Para receber mensagens HL7 através de ligações TCP/IP com o protocolo de camada inferior mínimo (MLLP), tem de configurar um adaptador MLLP. Não precisa de configurar um adaptador MLLP se receber mensagens HL7 através de REST (Google Cloud Healthcare API). Para executar o adaptador, faça o seguinte:

    1. Defina o projeto e a região na CLI gcloud: 
      gcloud config set project PROJECT_ID \
gcloud config set compute/region LOCATION

      Para mais informações, consulte o artigo Defina propriedades.

    2. Crie uma instância de VM. 
         gcloud compute instances create VM_NAME \
       --service-account=SERVICE_ACCOUNT_EMAIL \
       --scopes=https://www.googleapis.com/auth/cloud-platform

      Substitua o seguinte:

      • SERVICE_ACCOUNT_EMAIL: o endereço de email da conta de serviço que criou.
      • VM_NAME: o nome da instância de VM.
    3. Adicione uma etiqueta à instância de VM recém-criada. 
         gcloud compute instances add-tags INSTANCE_NAME \
   --zone ZONE \
   --tags TAGS

      Substitua o seguinte:

      • INSTANCE_NAME: o nome da instância de VM.
      • ZONE: a zona da instância de VM.
      • TAGS: As etiquetas a adicionar à instância de VM.
    4. Adicione uma regra de firewall para expor a porta na qual o adaptador MLLP está a ser executado. 
         gcloud compute firewall-rules create FIREWALL_RULE \
   --action=ALLOW \
   --direction=INGRESS \
   --priority=1000 \
   --rules=tcp:PORT\
   --network=default \
   --source-ranges=0.0.0.0/0

      Substitua o seguinte:

      • FIREWALL_RULE: o nome da regra de firewall.
      • PORT: a porta na qual o adaptador MLLP está em execução.
    5. SSH para a instância de VM. 
         gcloud compute ssh VM_NAME --zone ZONE

      Substitua o seguinte:

      • VM_NAME: o nome da instância de VM.
      • ZONE: a zona da instância de VM.
    6. Instale o Docker na VM através do seguinte comando: 
         sudo apt-get update && sudo apt-get install -y docker.io
    7. Inicie o serviço Docker executando os seguintes comandos: 
         sudo systemctl start docker
   sudo systemctl enable docker
    8. Extraia a imagem do Docker no registo de contentores. 
         docker pull gcr.io/cloud-healthcare-containers/mllp-adapter:latest
    9. Execute o adaptador MLLP na instância de VM. 
         docker run \
   --network=host \
   -v ~/.config:/root/.config \
   gcr.io/cloud-healthcare-containers/mllp-adapter \
   /usr/mllp_adapter/mllp_adapter \
   --hl7_v2_project_id=PROJECT_ID \
   --hl7_v2_location_id=LOCATION \
   --hl7_v2_dataset_id=DATASET_ID \
   --hl7_v2_store_id=HL7V2_STORE_ID \
   --export_stats=false \
   --receiver_ip=0.0.0.0 \
   --port=PORT \
   --api_addr_prefix=https://healthcare.googleapis.com:443/v1 \
   --logtostderr

      Substitua o seguinte:

      • PROJECT_ID: o ID do projeto do Google Cloud.
      • LOCATION: a localização do armazenamento de HL7.
      • DATASET_ID: o ID do conjunto de dados que contém o armazenamento de HL7.
      • HL7V2_STORE_ID: o ID do armazenamento de HL7.
      • PORT: a porta na qual o adaptador MLLP está em execução.
    10. Execute o seguinte comando para garantir que o contentor está em execução: 
         sudo docker ps
    11. Para verificar os registos do contentor, execute o seguinte comando: 
         sudo docker logs CONTAINER_ID

Funções necessárias

Se planeia criar ou configurar uma nova associação para o acionador HL7, certifique-se de que tem a seguinte função de IAM no projeto:

  • Administrador do conetor (roles/connectors.admin)

    • Para informações sobre a concessão de funções, consulte o artigo Faça a gestão do acesso.

Conceda as seguintes funções ou autorizações de IAM à conta de serviço que quer usar para o trigger HL7:

  • Application Integration Invoker (roles/integrations.integrationInvoker)
  • Consumidor de mensagens de HL7v2 da Healthcare (roles/healthcare.hl7V2Consumer)
  • Carregar mensagens de HL7v2 da Healthcare (roles/healthcare.hl7V2Ingest)
  • Autorização (healthcare.hl7V2Stores.update)
  • Editor do Pub/Sub (roles/pubsub.editor)

    • Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Adicione o acionador HL7

Para adicionar um acionador HL7 à sua integração, siga estes passos:

  1. Na Google Cloud consola, aceda à página Application Integration.

    Aceda à solução Application Integration

  2. No menu de navegação, clique em Integrações

    A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

  3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

    Se estiver a criar uma nova integração:

    1. Introduza um nome e uma descrição no painel Criar integração.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar.

    A integração recém-criada é aberta no editor de integração.

  4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
  5. Clique e coloque o elemento Acionador HL7 no editor de integração.

    6. Para configurar o acionador HL7, pode usar uma ligação HL7 existente com REST (API Cloud Healthcare) como o protocolo de destino disponível nos Integration Connectors ou criar uma nova ligação HL7 REST(API Google Cloud Healthcare) através da opção de criação de ligações inline.

Configure o acionador HL7 através de uma associação existente

Pode configurar o acionador HL7 através de uma ligação HL7 existente com REST (Cloud HealthCare API) como protocolo de destino nos Integration Connectors. O acionador HL7 é um acionador de eventos de conetor. Por conseguinte, só pode usar uma ligação REST HL7(API Google Cloud HealthCare) com a subscrição de eventos ativada para configurar o acionador.

Para obter informações sobre como configurar um acionador HL7 através de uma nova ligação HL7 REST(Google Cloud Healthcare API), consulte o artigo Configure o acionador HL7 através de uma nova ligação HL7 REST(Google Cloud Healthcare API).

Para configurar um acionador HL7 através de uma ligação HL7 existente com REST (API Cloud Healthcare) como protocolo de destino, siga estes passos:

  1. Clique no elemento Acionador HL7 no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar acionador.
  3. Forneça os seguintes detalhes de configuração na página Editor do acionador de eventos do conetor:
    1. Região: selecione a região da sua ligação HL7 REST(Google Cloud Healthcare API).
    2. Ligação: selecione a ligação HL7 REST(Google Cloud Healthcare API) que quer usar.

      A integração de aplicações apenas apresenta as ligações HL7 REST(Google Cloud Healthcare API) que estão ativas e têm uma subscrição de eventos ativada.

    3. Selecione Tipo de conteúdo da mensagem HL7: texto ou bytes no menu pendente.
    4. Introduza o tipo de mensagem HL7. Por exemplo, ADT_A01 ou ADT_02.
  4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador HL7 através de uma nova ligação

Para configurar o acionador HL7 através de uma nova ligação HL7 REST(Google Cloud Healthcare API), siga estes passos:

  1. Clique no elemento Acionador HL7 no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar acionador.
  3. Selecione a Região para o acionador HL7.
  4. Clique em Associação e selecione a opção Criar associação no menu pendente.
  5. Conclua os seguintes passos no painel Criar associação:
  6. No passo Detalhes da ligação, indique os detalhes sobre a nova ligação HL7:
    1. Versão do conector: escolha uma versão disponível do conector HL7 na lista pendente.
    2. Nome da associação: introduza um nome para a associação HL7.
    3. (Opcional) Descrição: introduza uma descrição para a associação.
    4. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    5. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para a ligação HL7.
    6. Ativar subscrição de eventos: selecione esta opção para ativar a subscrição de eventos para a ligação HL7.
    7. (Opcional) Introduza Tempo limite de receção: o valor SO_TIMEOUT (em milissegundos) é usado quando se aguarda o início de um frame. O valor predefinido é de 15 000 milissegundos.
    8. Protocolo de destino: selecione o protocolo de destino HL7 REST(API Google Cloud Healthcare) e, em seguida, especifique o seguinte:
      1. ID do projeto: o ID do projeto do Google Cloud onde se encontra o arquivo HL7.
      2. Localização: a localização do conjunto de dados e do armazenamento de HL7v2.
      3. ID do conjunto de dados: o ID do conjunto de dados que contém o armazenamento de HL7v2.
      4. ID do armazenamento de HL7: o ID do armazenamento de HL7v2 onde armazena a mensagem de HL7v2.
    9. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    10. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    11. Opcionalmente, se quiser usar SSL, selecione Ativar SSL. São apresentados os detalhes da configuração SSL.
      1. Selecione um tipo de loja fidedigna. Pode ser Público, Privado ou Ligação não segura.
      2. Selecione os certificados conforme apresentado com base na sua seleção da loja de confiança.
      3. Se estiver a usar o mTLS, selecione os certificados do armazenamento de chaves na secção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão do TLS.
      5. Introduza o conjunto de cifras suportado. Introduza várias suites de cifragem como valores separados por vírgulas. Para mais informações, consulte o artigo Conjuntos de cifras suportados.
    12. Clicar em Seguinte.
  7. Ignore a secção Destinos.
  8. Clicar em Seguinte.
  9. Na secção Autenticação, não tem de especificar detalhes de autenticação, uma vez que a ligação HL7 não requer autenticação.
  10. Na secção Detalhes da subscrição de eventos, configure os detalhes relacionados com o evento.
    • Nome do projeto: o projeto do Google Cloud onde reside a instância do Pub/Sub.
    • Nome do tópico do Pub/Sub: o nome do tópico do Pub/Sub a associar ao arquivo HL7v2 para o qual as mensagens de notificação vão ser enviadas.
  11. Rever: reveja os detalhes da ligação e da autenticação.
  12. Clique em Criar.

Conjuntos de cifras suportados

Versão do TLS Conjuntos de cifras suportados
1.2
  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1.3
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • TLS_AES_128_GCM_SHA256

Saída do acionador

O acionador HL7 demora alguns minutos a concluir a configuração da subscrição de eventos. Pode ver o estado da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

O acionador HL7 indica o estado de uma subscrição de eventos através dos seguintes estados:

  • Creating: indica que o acionador está a subscrever a subscrição de eventos.
  • Active: indica que o acionador subscreveu com êxito uma subscrição de eventos.
  • Error: indica que existe um problema com a subscrição de eventos configurada.

Além do estado da subscrição de eventos, a secção Detalhes da subscrição de eventos também apresenta outros detalhes, como a região de associação, o nome da associação e o nome da subscrição de eventos.

Variável de saída do acionador

Para cada evento, o acionador HL7 gera uma variável de saída ConnectorEventPayload (no formato JSON) que pode usar nas tarefas posteriores. A variável terá a carga útil do seu evento HL7. Por exemplo: 

 {
 "messageType": "ADT_A01",
 "message": "MSH|^~\\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|20240209120000||ADT^A01|123456789|P|2.3|||NE|AL|||||\rEVN|A02222221|20240209120000|||\rPID|1||123456789|^^^Hospital^MR||Doe^John^^^Mr.||19800101|M|||123 Main St^^New York^NY^10001^USA||(555)555-1234|(555)555-1235\rPV1|1|I|2000^2012^01||||123^Doe^John|||SUR||||ADM|A0||\r",
 "contentType": "text/plain"
}

Veja as subscrições de eventos

Para ver e gerir todas as subscrições de eventos associadas a uma ligação nos Integration Connectors, faça o seguinte:

  1. Aceda à página Integration Connectors > Ligações.

    Aceda à página Ligações

  2. Clique na associação para a qual quer ver as subscrições.
  3. Clique no separador Subscrições de eventos.

    Esta apresenta todas as subscrições de eventos da associação.

Edite o acionador HL7

Pode editar um acionador HL7 para alterar ou atualizar a configuração da associação e os detalhes da subscrição de eventos.

Para editar um acionador HL7, siga estes passos:

  1. Clique no elemento Acionador HL7 no editor de integração para abrir o painel de configuração do acionador.
  2. Clique em Configurar acionador HL7.
  3. Faça o seguinte na página Editor de acionadores de eventos do conetor:
    1. Para manter a subscrição de eventos configurada anteriormente, clique em Manter. Caso contrário, clique em Eliminar.
    2. Atualize a configuração da associação e os detalhes da subscrição de eventos conforme pretendido.
    3. Clique em Concluído.

    4. Pode ver os detalhes atualizados da associação e da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?