Consulta i connettori supportati per Application Integration.

Trigger HL7

Anteprima - HL7 trigger

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

L'attivatore HL7 è un attivatore evento del connettore che ti consente di richiamare un'integrazione in base agli eventi HL7 a cui hai effettuato l'iscrizione nella connessione HL7.

Importante:Integration Connectors è un componente fatturabile di Google Cloud. Per informazioni sui costi e sugli addebiti relativi all'utilizzo di Integration Connectors, consulta la pagina Prezzi di Integration Connectors.

Prima di iniziare

• Crea un argomento Pub/Sub.
• Crea un archivio HL7.

• Per ricevere messaggi HL7 su connessioni TCP/IP utilizzando il protocollo MLLP (Minimal Lower Layer Protocol), devi configurare un adattatore MLLP. Non è necessario configurare un adattatore MLLP se ricevi messaggi HL7 tramite REST (API Google Cloud Healthcare). Per eseguire l'adattatore:

  1. Imposta il progetto e la regione nellgcloud CLI:

     gcloud config set project PROJECT_ID \
     gcloud config set compute/region LOCATION

     Per ulteriori informazioni, vedi Impostare le proprietà.

  2. Crea un'istanza VM.

        gcloud compute instances create VM_NAME \
            --service-account=SERVICE_ACCOUNT_EMAIL \
            --scopes=https://www.googleapis.com/auth/cloud-platform
        

     Sostituisci quanto segue:

     • SERVICE_ACCOUNT_EMAIL: l'indirizzo email dell'account di servizio che hai creato.
     • VM_NAME: il nome dell'istanza VM.
  3. Aggiungi un tag all'istanza VM appena creata.

        gcloud compute instances add-tags INSTANCE_NAME \
        --zone ZONE \
        --tags TAGS
        

     Sostituisci quanto segue:

     • INSTANCE_NAME: il nome dell'istanza VM.
     • ZONE: la zona dell'istanza VM.
     • TAGS: i tag da aggiungere all'istanza VM.
  4. Aggiungi una regola firewall per esporre la porta su cui è in esecuzione l'adattatore MLLP.

        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
     

     Sostituisci quanto segue:

     • FIREWALL_RULE: il nome della regola firewall.
     • PORT: la porta su cui è in esecuzione l'adattatore MLLP.
  5. Accedi tramite SSH all'istanza VM.

        gcloud compute ssh VM_NAME --zone ZONE
      

     Sostituisci quanto segue:

     • VM_NAME: il nome dell'istanza VM.
     • ZONE: la zona dell'istanza VM.
  6. Installa Docker nella VM utilizzando il seguente comando:

        sudo apt-get update && sudo apt-get install -y docker.io
        

  7. Avvia il servizio Docker eseguendo i seguenti comandi:

        sudo systemctl start docker
        sudo systemctl enable docker
        

  8. Esegui il pull dell'immagine Docker nel registry dei container.

        docker pull gcr.io/cloud-healthcare-containers/mllp-adapter:latest
        

  9. Esegui l'adattatore MLLP nell'istanza 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
      

     Sostituisci quanto segue:

     • PROJECT_ID: l'ID del progetto Google Cloud.
     • LOCATION: la posizione dell'archivio HL7.
     • DATASET_ID: l'ID del set di dati che contiene l'archivio HL7.
     • HL7V2_STORE_ID: l'ID dell'archivio HL7.
     • PORT: la porta su cui è in esecuzione l'adattatore MLLP.
  10. Esegui il seguente comando per assicurarti che il contenitore sia in esecuzione:

         sudo docker ps
         

  11. Per controllare i log del contenitore, esegui il seguente comando:

         sudo docker logs CONTAINER_ID
         

Ruoli obbligatori

Se prevedi di creare o configurare una nuova connessione per l'attivatore HL7, assicurati di disporre del seguente ruolo IAM nel progetto:

• Connector Admin (roles/connectors.admin)

Per informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.

Concedi i seguenti ruoli o autorizzazioni IAM all'account di servizio che vuoi utilizzare per l'attivatore HL7:

• Application Integration Invoker (roles/integrations.integrationInvoker)
• Consumer messaggi HL7v2 Healthcare (roles/healthcare.hl7V2Consumer)
• Healthcare HL7v2 Message Ingest (roles/healthcare.hl7V2Ingest)
• Autorizzazione (healthcare.hl7V2Stores.update)
• Editor Pub/Sub (roles/pubsub.editor)

Per informazioni sulla concessione di ruoli a un account di servizio, vedi Gestire l'accesso agli account di servizio.

Aggiungi l'attivatore HL7

Per aggiungere un attivatore HL7 all'integrazione, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Elenco integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   Viene visualizzata l'integrazione nell'editor di integrazione.

4. Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attivatori per visualizzare l'elenco degli attivatori disponibili.
5. Fai clic e posiziona l'elemento Trigger HL7 nell'editor di integrazione.

Per configurare l'attivatore HL7, puoi utilizzare una connessione HL7 esistente con REST (API Google Cloud HealthCare) come protocollo di destinazione disponibile nei connettori di integrazione oppure creare una nuova connessione HL7 REST(API Google Cloud HealthCare) utilizzando l'opzione di creazione della connessione in linea.

Configura l'attivatore HL7 utilizzando una connessione esistente

Puoi configurare l'attivatore HL7 utilizzando una connessione HL7 esistente con REST (API Cloud Healthcare) come protocollo di destinazione in Integration Connectors. L'attivatore HL7 è un attivatore di eventi del connettore, pertanto puoi utilizzare solo una connessione HL7 REST(API Google Cloud Healthcare) con l'iscrizione agli eventi abilitata per configurare l'attivatore.

Per informazioni su come configurare un attivatore HL7 utilizzando una nuova connessione HL7 REST(API Google Cloud Healthcare), consulta Configurare l'attivatore HL7 utilizzando una nuova connessione HL7 REST(API Google Cloud Healthcare).

Per configurare un attivatore HL7 utilizzando una connessione HL7 esistente con REST (API Cloud Healthcare) come protocollo di destinazione, svolgi i seguenti passaggi:

1. Fai clic sull'elemento Trigger HL7 nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.
2. Fai clic su Configura trigger.
3. Fornisci i seguenti dettagli di configurazione nella pagina Editor dell'attivatore evento del connettore:
   1. Regione:seleziona la regione della connessione HL7 REST(API Google Cloud Healthcare).
   2. Connessione:seleziona la connessione HL7 REST(API Google Cloud Healthcare) che vuoi utilizzare.

      L'Application Integration mostra solo le connessioni HL7 REST(API Google Cloud Healthcare) attive e per le quali è stato attivato un abbonamento agli eventi.

   3. Seleziona Tipo di contenuto del messaggio HL7: testo o byte dal menu a discesa.
   4. Inserisci il tipo di messaggio HL7. Ad esempio, ADT_A01 o ADT_02.
4. Fai clic su Fine per completare la configurazione dell'attivatore e chiudere la pagina.

Configura l'attivatore HL7 utilizzando una nuova connessione

Per configurare l'attivatore HL7 utilizzando una nuova connessione HL7 REST(API Google Cloud Healthcare), svolgi i seguenti passaggi:

1. Fai clic sull'elemento Trigger HL7 nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.
2. Fai clic su Configura trigger.
3. Seleziona la regione per l'attivatore HL7.
4. Fai clic su Connessione e seleziona l'opzione Crea connessione dal menu a discesa.
5. Completa i seguenti passaggi nel riquadro Crea connessione:
6. Nel passaggio Dettagli connessione, fornisci i dettagli della nuova connessione HL7:
   1. Versione del connettore:scegli una versione disponibile del connettore HL7 dall'elenco a discesa.
   2. Nome connessione:inserisci un nome per la connessione HL7.
      Nota: i nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono superare i 49 caratteri.
   3. (Facoltativo) Descrizione : inserisci una descrizione per la connessione.
   4. Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
   5. Account di servizio: seleziona un account di servizio con i ruoli IAM richiesti per la connessione HL7.
   6. Attiva sottoscrizione eventi:seleziona questa opzione per attivare la sottoscrizione agli eventi per la connessione HL7.
      Nota: questo connettore non supporta l'opzione Enable only event subscription.
   7. (Facoltativo) Inserisci Timeout ricezione: il valore SO_TIMEOUT (in millisecondi) viene utilizzato durante l'attesa dell'inizio di un frame. Il valore predefinito è 15000 millisecondi.
   8. Protocollo di destinazione: seleziona il protocollo di destinazione HL7 REST(API Google Cloud Healthcare) e poi specifica quanto segue:
      1. ID progetto: l'ID progetto Google Cloud in cui si trova l'archivio HL7.
      2. Posizione: la posizione del set di dati e dell'archivio HL7v2.
      3. ID set di dati: l'ID del set di dati che contiene l'archivio HL7v2.
      4. ID archivio HL7: l'ID dell'archivio HL7v2 in cui memorizzi il messaggio HL7v2.
   9. (Facoltativo) Configura le impostazioni del nodo di connessione:
      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Per elaborare più transazioni per una connessione sono necessari più nodi e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

   Nota: puoi personalizzare i valori dei nodi di connessione solo se sei un cliente con pagamento a consumo.
   10. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di una coppia chiave/valore.
   11. Se vuoi utilizzare SSL, seleziona Abilita SSL. Vengono visualizzati i dettagli della configurazione SSL.
       1. Seleziona un tipo di magazzino attendibile. Può essere Pubblica, Privata o Connessione non sicura.
       2. Seleziona i certificati visualizzati in base alla selezione dell'archivio attendibile.
       3. Se utilizzi mTLS, seleziona i certificati dell'archivio chiavi nella sezione Archivio chiavi.
       4. Se vuoi, seleziona la versione TLS.
       5. Inserisci il pacchetto di crittografia supportato. Inserisci più suite di crittografia come valori separati da virgole. Per ulteriori informazioni, vedi Suite di crittografia supportate.
       Nota:

       • Tutti i certificati devono essere certificati X.509 e devono essere in formato PEM (Privacy Enhanced Mail).
       • Non puoi selezionare direttamente un certificato durante la configurazione di SSL. Devi archiviare tutti i certificati e le chiavi private come segreto di Secret Manager, quindi selezionare il segreto richiesto durante la configurazione SSL.
   12. Fai clic su Avanti.
7. Salta la sezione Destinazioni.
8. Fai clic su Avanti.
9. Nella sezione Autenticazione, non è necessario specificare i dettagli di autenticazione perché la connessione HL7 non richiede alcuna autenticazione.
10. Nella sezione Dettagli dell'iscrizione all'evento, configura i dettagli relativi all'evento.
    • Nome progetto: il progetto Google Cloud in cui risiede l'istanza Pub/Sub.
    • Nome argomento Pub/Sub: il nome dell'argomento Pub/Sub da associare all'archivio HL7v2 a cui verranno inviati i messaggi di notifica.
11. Rivedi: controlla i dettagli di connessione e autenticazione.
12. Fai clic su Crea.

Suite di crittografia supportate

Versione TLS	Suite di crittografia supportate
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

Attiva l'output

L'attivatore HL7 richiede un paio di minuti per completare la configurazione dell'iscrizione agli eventi. Puoi visualizzare lo stato dell'iscrizione agli eventi nel riquadro di configurazione dell'attivatore in Dettagli iscrizione eventi.

L'attivatore HL7 indica lo stato di un abbonamento agli eventi utilizzando i seguenti stati:

• Creating: indica che l'attivatore si sta iscrivendo all'abbonamento all'evento.
• Active: indica che l'attivatore è stato sottoscritto correttamente per un abbonamento agli eventi.
• Error: indica che si è verificato un problema con l'abbonamento agli eventi configurato.

Oltre allo stato della sottoscrizione all'evento, la sezione Dettagli della sottoscrizione all'evento mostra anche altri dettagli, come la regione di connessione, il nome della connessione e il nome della sottoscrizione all'evento.

Variabile di output dell'attivatore

Per ogni evento, l'attivatore HL7 genera una variabile di output ConnectorEventPayload (in formato JSON) che puoi utilizzare nelle attività a valle. La variabile di output avrà il payload dell'evento HL7. Ad esempio:

 {
 "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||[phone]|[phone]\rPV1|1|I|2000^2012^01||||123^Doe^John|||SUR||||ADM|A0||\r",
 "contentType": "text/plain"
}

Visualizzare le iscrizioni agli eventi

Per visualizzare e gestire tutte le iscrizioni agli eventi associate a una connessione in Integration Connectors:

1. Vai alla pagina Connettori di integrazione > Connessioni.

   Vai alla pagina Connessioni

2. Fai clic sul collegamento per cui vuoi visualizzare gli abbonamenti.
3. Fai clic sulla scheda Abbonamenti agli eventi.

   Vengono visualizzati tutti gli abbonamenti agli eventi per la connessione.

Modificare l'attivatore HL7

Puoi modificare un attivatore HL7 per cambiare o aggiornare la configurazione della connessione e i dettagli dell'iscrizione agli eventi.

Importante: quando modifichi un attivatore HL7, puoi conservare l'iscrizione agli eventi configurata in precedenza associata all'attivatore oppure eliminarla. L'eliminazione di una sottoscrizione di eventi influirà su tutte le integrazioni pubblicate che la utilizzano.

Per modificare un trigger HL7:

1. Fai clic sull'elemento Trigger HL7 nell'editor di integrazione per aprire il riquadro di configurazione dell'attivatore.
2. Fai clic su Configura trigger HL7.
3. Nella pagina Editor di trigger evento connettore:
   1. Per mantenere l'abbonamento agli eventi configurato in precedenza, fai clic su Mantieni, altrimenti fai clic su Elimina.
      Avviso: l'eliminazione di una sottoscrizione di eventi influirà su tutte le integrazioni pubblicate che la utilizzano. Questa attività non può essere annullata.
   2. Aggiorna la configurazione della connessione e i dettagli dell'iscrizione agli eventi come preferisci.
   3. Fai clic su Fine.

Puoi visualizzare i dettagli aggiornati della connessione e della sottoscrizione di eventi nel riquadro di configurazione dell'attivatore in Dettagli della sottoscrizione di eventi.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi

• Scopri di più su tutte le attività e gli attivatori.
• Scopri come testare e pubblicare un'integrazione.
• Scopri di più sulla gestione degli errori.
• Scopri di più sui log di esecuzione dell'integrazione.