Consulte os conectores compatíveis com a integração de aplicativos.

Acionador HL7

O gatilho HL7 é um gatilho de evento do conector que permite invocar uma integração com base nos eventos HL7 aos quais você se inscreveu na conexão HL7.

Antes de começar

  • Crie um tópico do Pub/Sub.
  • Crie um armazenamento HL7.
  • Para receber mensagens HL7 por conexões TCP/IP usando o protocolo de camada mínima (MLLP, na sigla em inglês), é necessário configurar um adaptador MLLP. Não é necessário configurar um adaptador MLLP se você receber mensagens HL7 por REST (API Google Cloud Healthcare). 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 Definir 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:

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

      Substitua:

      • INSTANCE_NAME: o nome da instância de VM.
      • ZONE: a zona da instância de VM.
      • TAGS: as tags a serem adicionadas à instância de VM.
    4. Adicione uma regra de firewall para expor a porta em que o adaptador MLLP está em execução.
         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:

      • FIREWALL_RULE: o nome da regra de firewall.
      • PORT: a porta em que o adaptador MLLP está sendo executado.
    5. Use SSH para acessar a instância de VM.
         gcloud compute ssh VM_NAME --zone ZONE
       

      Substitua:

      • VM_NAME: o nome da instância de VM.
      • ZONE: a zona da instância de VM.
    6. Instale o Docker na VM usando o seguinte comando:
         sudo apt-get update && sudo apt-get install -y docker.io
         
    7. Inicie o serviço do Docker executando os seguintes comandos:
         sudo systemctl start docker
         sudo systemctl enable docker
         
    8. Extraia a imagem do Docker no registro de contêineres.
         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:

      • PROJECT_ID: o ID do projeto do Google Cloud.
      • LOCATION: é o local do armazenamento HL7.
      • DATASET_ID: é o ID do conjunto de dados que contém o armazenamento HL7.
      • HL7V2_STORE_ID: é o ID do armazenamento HL7.
      • PORT: a porta em que o adaptador MLLP está sendo executado.
    10. Execute o comando a seguir para garantir que o contêiner esteja em execução:
         sudo docker ps
         
    11. Para verificar os registros do contêiner, execute o seguinte comando:
         sudo docker logs CONTAINER_ID
         

Funções exigidas

Se você planeja criar ou configurar uma nova conexão para o gatilho HL7, verifique se tem o seguinte papel do IAM no projeto:

  • Administrador do conector (roles/connectors.admin)
  • Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso.

Conceda os seguintes papéis ou permissões do IAM à conta de serviço que você quer usar para o gatilho HL7:

  • Invocador do Application Integration (roles/integrations.integrationInvoker)
  • Consumidor de mensagens HL7v2 do Healthcare (roles/healthcare.hl7V2Consumer)
  • Processador de mensagens HL7v2 do Healthcare (roles/healthcare.hl7V2Ingest)
  • Permissão (healthcare.hl7V2Stores.update)
  • Editor do Pub/Sub (roles/pubsub.editor)
  • Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Adicionar o acionador HL7

Para adicionar um gatilho HL7 à integração, siga estas etapas:

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

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

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

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

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Insira 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. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de acionadores disponíveis.
  5. Clique e coloque o elemento gatilho HL7 no editor de integração.
  6. Para configurar o gatilho HL7, use uma conexão HL7 com REST (API Cloud Healthcare) como o protocolo de destino disponível nos Integration Connectors ou crie uma nova conexão HL7 REST(API Cloud Healthcare) usando a opção de criação de conexão inline.

Configurar o acionador HL7 usando uma conexão existente

É possível configurar o gatilho HL7 usando uma conexão HL7 com REST (API Cloud Healthcare) como o protocolo de destino nos Integration Connectors. O acionador HL7 é um acionador de evento do conector. Portanto, só é possível usar uma conexão HL7 REST(API Google Cloud HealthCare) com a assinatura de eventos ativada para configurar o acionador.

Para informações sobre como configurar um gatilho HL7 usando uma nova conexão HL7 REST(API Google Cloud Healthcare), consulte Configurar gatilho HL7 usando uma nova conexão HL7 REST(API Google Cloud Healthcare).

Para configurar um gatilho HL7 usando uma conexão HL7 com o REST (API Cloud Healthcare) como protocolo de destino, siga estas etapas:

  1. Clique no elemento Gatilho HL7 no editor de integração para abrir o painel de configuração do gatilho.
  2. Clique em Configurar acionador.
  3. Informe os seguintes detalhes de configuração na página Editor de gatilho de evento do conector:
    1. Região:selecione a região da sua conexão HL7 REST(API Google Cloud Healthcare).
    2. Conexão:selecione a conexão HL7 REST(API Google Cloud HealthCare) que você quer usar.

      Application Integration só mostra as conexões HL7 REST(API Google Cloud Healthcare) que estão ativas e têm uma assinatura de evento ativada.

    3. Selecione HL7 Message Content Type: texto ou bytes no menu suspenso.
    4. Insira 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.

Configurar o acionador HL7 usando uma nova conexão

Para configurar o gatilho HL7 usando uma nova conexão HL7 REST(API Google Cloud Healthcare), siga estas etapas:

  1. Clique no elemento Gatilho HL7 no editor de integração para abrir o painel de configuração do gatilho.
  2. Clique em Configurar acionador.
  3. Selecione a Região do acionador HL7.
  4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
  5. Conclua as etapas a seguir no painel Criar conexão:
  6. Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão HL7:
    1. Versão do conector:escolha uma versão disponível do conector HL7 na lista suspensa.
    2. Nome da conexão:insira um nome para a conexão HL7.
    3. (Opcional) Descrição : insira uma descrição para a conexão.
    4. Como opção, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    5. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão HL7.
    6. Ativar a assinatura de eventos:selecione essa opção para ativar a assinatura de eventos para a conexão HL7.
    7. (Opcional) Digite Tempo limite de recebimento: o valor SO_TIMEOUT (em milissegundos) é usado ao aguardar o início de um frame. O valor padrão é 15.000 milissegundos.
    8. Protocolo de destino: selecione o protocolo de destino HL7 REST(API Google Cloud Healthcare) e especifique o seguinte:
      1. ID do projeto: o ID do projeto do Google Cloud em que a loja HL7 está localizada.
      2. Local: é a localização do conjunto de dados e do armazenamento HL7v2.
      3. ID do conjunto de dados: o ID do conjunto de dados que contém o armazenamento HL7v2.
      4. ID do armazenamento HL7: é o ID do armazenamento HL7v2 em que você armazena a mensagem HL7v2.
    9. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    10. Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
    11. Como opção, se quiser usar SSL, selecione Ativar SSL. Os detalhes da configuração do SSL serão exibidos.
      1. Selecione um tipo de loja de confiança. Pode ser Pública, Particular ou Conexão não segura.
      2. Selecione os certificados com base na sua seleção de loja de confiança.
      3. Se você estiver usando mTLS, selecione os certificados de armazenamento de chaves na seção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão TLS.
      5. Insira o pacote de criptografia compatível. Insira vários pacotes de criptografia como valores separados por vírgulas. Para mais informações, consulte Pacotes de criptografia aceitos.
    12. Clique em Próxima.
  7. Pule a seção Destinos.
  8. Clique em Próxima.
  9. Na seção Autenticação, não é necessário especificar detalhes de autenticação porque a conexão HL7 não exige autenticação.
  10. Na seção Detalhes da assinatura do evento, configure os detalhes relacionados ao evento.
    • Nome do projeto: o projeto do Google Cloud em que a instância do Pub/Sub reside.
    • Nome do tópico do Pub/Sub: o nome do tópico do Pub/Sub que será associado à loja HL7v2 para a qual as mensagens de notificação serão enviadas.
  11. Revisão: revise os detalhes de conexão e autenticação.
  12. Clique em Criar.

Pacotes de criptografia aceitos

Versão TLS Pacotes de criptografia aceitos
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 gatilho

A configuração da assinatura de eventos do gatilho HL7 leva alguns minutos. É possível conferir o status da assinatura de evento no painel de configuração do acionador em Detalhes da assinatura de evento.

O gatilho HL7 indica o status de uma assinatura de evento usando os seguintes estados:

  • Creating: indica que o acionador está se inscrevendo na assinatura de eventos.
  • Active: indica que o acionador foi inscrito em uma assinatura de evento.
  • Error: indica que há um problema com a assinatura de evento configurada.

Além do status da assinatura do evento, a seção Detalhes da assinatura do evento também mostra outros detalhes, como região de conexão, nome da conexão e nome da assinatura do evento.

Acionar variável de saída

Para cada evento, o acionador HL7 gera uma variável de saída ConnectorEventPayload (no formato JSON) que pode ser usada nas tarefas downstream. A variável de saída terá o payload do evento HL7. 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"
}

Conferir assinaturas de eventos

Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão nos Integration Connectors, faça o seguinte:

  1. Acesse a página Integration Connectors > Connections.

    Acessar a página "Conexões"

  2. Clique na conexão em que você quer conferir as assinaturas.
  3. Clique na guia Assinaturas de eventos.

    Isso mostra todas as assinaturas de eventos da conexão.

Editar acionador HL7

É possível editar um gatilho HL7 para mudar ou atualizar a configuração de conexão e os detalhes da assinatura de eventos.

Para editar um gatilho HL7, siga estas etapas:

  1. Clique no elemento Gatilho HL7 no editor de integração para abrir o painel de configuração do gatilho.
  2. Clique em Configurar acionador HL7.
  3. Faça o seguinte na página Editor de gatilho de evento do conector:
    1. Para manter a assinatura de evento configurada anteriormente, clique em Manter. Caso contrário, clique em Excluir.
    2. Atualize a configuração da conexão e os detalhes da assinatura de eventos conforme necessário.
    3. Clique em Concluído.
  4. É possível conferir os detalhes atualizados da conexão e da assinatura de eventos no painel de configuração do acionador em Detalhes da assinatura de eventos.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir