Consulte os conectores compatíveis com o Application Integration.

Gatilho HL7

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

Antes de começar

• Crie um tópico do Pub/Sub.
• Crie um repositório HL7.

• Para receber mensagens HL7 por conexões TCP/IP usando o protocolo de camada inferior mínima (MLLP), configure um adaptador MLLP. Não é necessário configurar um adaptador MLLP se você receber mensagens HL7 via REST (API 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 de 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á sendo 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:

     • 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 Container Registry.

        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)
• Ingestão 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 gatilho HL7

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

1. No console 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.

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

   1. Digite 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 info 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 conferir a lista de acionadores disponíveis.
5. Clique e coloque o elemento Gatilho HL7 no editor de integração.

Para configurar o gatilho HL7, use uma conexão HL7 atual com REST (API Cloud Healthcare) como o protocolo de destino disponível no Integration Connectors ou crie uma conexão HL7 REST(API Google Cloud Healthcare) usando a opção de criação de conexão inline.

Configurar um gatilho HL7 usando uma conexão atual

É possível configurar o gatilho HL7 usando uma conexão HL7 atual 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 REST HL7(API Cloud Healthcare) com a inscrição em 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 um gatilho HL7 usando uma nova conexão HL7 REST(API Google Cloud HealthCare).

Para configurar um gatilho HL7 usando uma conexão HL7 com 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. Forneça 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 REST HL7(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 REST HL7(API Google Cloud HealthCare) que estão ativas e têm uma assinatura de evento ativada.

   3. Selecione Tipo de conteúdo da mensagem HL7: 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 um gatilho HL7 usando uma nova conexão

Para configurar o gatilho HL7 usando uma nova conexão REST HL7(API Cloud Healthcare do Google), 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 gatilho 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. Se quiser, 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 com os papéis do IAM necessários para a conexão HL7.
   6. Ativar assinatura de eventos:selecione essa opção para ativar a assinatura de eventos da conexão HL7.
   7. (Opcional) Insira 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 Cloud Healthcare do Google Cloud) e especifique o seguinte:
      1. ID do projeto: o ID do projeto do Google Cloud em que o repositório HL7 está localizado.
      2. Localização: 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 ícones como valores separados por vírgulas. Para mais informações, consulte Pacotes de criptografia compatíveis.
   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 requer autenticação.
10. Na seção Detalhes da assinatura de 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 a ser associado ao armazenamento HL7v2 para onde 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 compatíveis

Saída do gatilho

O gatilho HL7 leva alguns minutos para concluir a configuração da inscrição no evento. É possível conferir o status da sua assinatura de evento no painel de configuração do gatilho em Detalhes da assinatura de evento.

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

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

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

Variável de saída do acionador

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

Ver inscrições em eventos

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

1. Acesse a página Integration Connectors > Conexões.

   Acessar a página "Conexões"

2. Clique na conexão para ver as assinaturas.
3. Clique na guia Assinaturas de eventos.

   Isso mostra todas as inscrições em eventos da conexão.

Editar gatilho HL7

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

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 de conexão e os detalhes da inscrição no evento conforme necessário.
   3. Clique em Concluído.

Você pode conferir os detalhes atualizados da conexão e da assinatura de evento no painel de configuração do gatilho em Detalhes da assinatura de evento.

Cotas e limites

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

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.