Unterstützte Connectors für Application Integration

HL7-Trigger

Der HL7-Trigger ist ein Connector-Ereignistrigger, mit dem Sie eine Integration basierend auf den HL7-Ereignissen aufrufen können, die Sie in Ihrer HL7-Verbindung abonniert haben.

Hinweise

• Erstellen Sie ein Pub/Sub-Thema.
• Erstellen Sie einen HL7-Speicher.

• Wenn Sie HL7-Nachrichten über TCP/IP-Verbindungen mit dem minimalen Low-Layer-Protokoll (MLLP) empfangen möchten, müssen Sie einen MLLP-Adapter konfigurieren. Sie müssen keinen MLLP-Adapter konfigurieren, wenn Sie HL7-Nachrichten über REST (Google Cloud Healthcare API) empfangen. So führen Sie den Adapter aus:

  1. Legen Sie das Projekt und die Region in der gcloud CLI fest:

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

     Weitere Informationen finden Sie unter Attribute festlegen.

  2. Erstellen Sie eine VM-Instanz.

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

     Ersetzen Sie Folgendes:

     • SERVICE_ACCOUNT_EMAIL: die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
     • VM_NAME: Der Name der VM-Instanz.
  3. Fügen Sie der neu erstellten VM-Instanz ein Tag hinzu.

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

     Ersetzen Sie Folgendes:

     • INSTANCE_NAME: Der Name der VM-Instanz.
     • ZONE: die Zone der VM-Instanz.
     • TAGS: Die Tags, die der VM-Instanz hinzugefügt werden sollen.
  4. Fügen Sie eine Firewallregel hinzu, um den Port freizugeben, auf dem der MLLP-Adapter ausgeführt wird.

        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
     

     Ersetzen Sie Folgendes:

     • FIREWALL_RULE: Der Name der Firewallregel.
     • PORT: Der Port, auf dem der MLLP-Adapter ausgeführt wird.
  5. Stellen Sie eine SSH-Verbindung zur VM-Instanz her.

        gcloud compute ssh VM_NAME --zone ZONE
      

     Ersetzen Sie Folgendes:

     • VM_NAME: Der Name der VM-Instanz.
     • ZONE: die Zone der VM-Instanz.
  6. Installieren Sie Docker auf der VM mit dem folgenden Befehl:

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

  7. Starten Sie den Docker-Dienst mit den folgenden Befehlen:

        sudo systemctl start docker
        sudo systemctl enable docker
        

  8. Rufen Sie das Docker-Image in der Container Registry ab.

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

  9. MLLP-Adapter ausführen auf der VM-Instanz.

        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
      

     Ersetzen Sie Folgendes:

     • PROJECT_ID: Die Projekt-ID des Google Cloud-Projekts.
     • LOCATION: Der Speicherort des HL7-Speichers.
     • DATASET_ID: Die ID des Datasets, das den HL7-Speicher enthält.
     • HL7V2_STORE_ID: Die ID des HL7-Speichers.
     • PORT: Der Port, auf dem der MLLP-Adapter ausgeführt wird.
  10. Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Container ausgeführt wird:

         sudo docker ps
         

  11. Führen Sie den folgenden Befehl aus, um die Containerlogs zu prüfen:

         sudo docker logs CONTAINER_ID
         

Erforderliche Rollen

Wenn Sie eine neue Verbindung für den HL7-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

• Connector-Administrator (roles/connectors.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den HL7-Trigger verwenden möchten, die folgenden IAM-Rollen oder Berechtigungen zu:

• Application Integration Invoker (roles/integrations.integrationInvoker)
• Healthcare-HL7v2-Nachrichtenverbraucher (roles/healthcare.hl7V2Consumer)
• Healthcare-HL7v2-Nachrichtenaufnehmer (roles/healthcare.hl7V2Ingest)
• Berechtigung (healthcare.hl7V2Stores.update)
• Pub/Sub-Bearbeiter (roles/pubsub.editor)

Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

HL7-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen HL7-Trigger hinzuzufügen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste wird angezeigt und enthält alle Integrationen, die im Google Cloud-Projekt verfügbar sind.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

   1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich info Integrationsübersicht in der Symbolleiste für die Integration ändern oder aktualisieren.
   4. Klicken Sie auf Erstellen.

   Die neu erstellte Integration wird im Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element HL7-Trigger und platzieren Sie es im Integrationseditor.

Zum Konfigurieren des HL7-Triggers können Sie entweder eine vorhandene HL7-Verbindung mit REST (Cloud Healthcare API) als Zielprotokoll verwenden, die in Integration Connectors verfügbar ist, oder eine neue HL7-REST-Verbindung(Google Cloud Healthcare API) mit der Inline-Option zum Erstellen von Verbindungen erstellen.

HL7-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den HL7-Trigger mit einer vorhandenen HL7-Verbindung mit REST (Cloud Healthcare API) als Zielprotokoll in Integration Connectors konfigurieren. Der HL7-Trigger ist ein Connector-Ereignistrigger. Daher können Sie nur eine HL7 REST-Verbindung(Google Cloud Healthcare API) mit aktivierter Ereignisregistrierung verwenden, um den Trigger zu konfigurieren.

Informationen zum Konfigurieren eines HL7-Triggers mit einer neuen HL7 REST(Google Cloud HealthCare API)-Verbindung finden Sie unter HL7-Trigger mit einer neuen HL7 REST(Google Cloud HealthCare API)-Verbindung konfigurieren.

So konfigurieren Sie einen HL7-Trigger mit einer vorhandenen HL7-Verbindung mit REST (Cloud Healthcare API) als Zielprotokoll:

1. Klicken Sie im Integrationseditor auf das Element HL7-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Konfigurationsdetails an:
   1. Region:Wählen Sie die Region Ihrer HL7 REST-Verbindung(Google Cloud Healthcare API) aus.
   2. Verbindung:Wählen Sie die HL7 REST-Verbindung(Google Cloud Healthcare API) aus, die Sie verwenden möchten.

      In Application Integration werden nur die HL7 REST-Verbindungen(Google Cloud Healthcare API) angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

   3. Wählen Sie im Drop-down-Menü HL7 Message Content Type (HL7-Nachrichtentyp) die Option „text“ oder „bytes“ aus.
   4. Geben Sie den HL7-Nachrichtentyp ein. Beispiel: ADT_A01 oder ADT_02.
4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

HL7-Trigger mit einer neuen Verbindung konfigurieren

So konfigurieren Sie den HL7-Trigger mit einer neuen HL7 REST(Google Cloud HealthCare API)-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element HL7-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Wählen Sie die Region für den HL7-Trigger aus.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
6. Geben Sie im Schritt Verbindungsdetails Details zur neuen HL7-Verbindung an:
   1. Connector-Version: Wählen Sie eine verfügbare Version des HL7-Connectors aus der Drop-down-Liste aus.
   2. Verbindungsname:Geben Sie einen Namen für die HL7-Verbindung ein.
   3. (Optional) Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
   4. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
   5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die HL7-Verbindung aus.
   6. Ereignisabo aktivieren:Wählen Sie diese Option aus, um das Ereignisabo für die HL7-Verbindung zu aktivieren.
   7. Optional: Geben Sie ein Zeitlimit für den Empfang ein. Der SO_TIMEOUT-Wert (in Millisekunden) wird verwendet, wenn auf den Beginn eines Frames gewartet wird. Der Standardwert ist 15.000 Millisekunden.
   8. Zielprotokoll: Wählen Sie das Zielprotokoll HL7 REST(Google Cloud Healthcare API) aus und geben Sie Folgendes an:
      1. Projekt-ID: Die Google Cloud-Projekt-ID, in der sich der HL7-Speicher befindet.
      2. Standort: Der Standort Ihres Datasets und des HL7v2-Speichers.
      3. Dataset-ID: Die ID des Datasets, das den HL7v2-Speicher enthält.
      4. HL7-Speicher-ID: Die ID des HL7v2-Speichers, in dem Sie die HL7v2-Nachricht speichern.
   9. Konfigurieren Sie optional die Verbindungsknoteneinstellungen:
      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

   10. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
   11. Wenn Sie SSL verwenden möchten, wählen Sie optional SSL aktivieren aus. Dadurch werden die SSL-Konfigurationsdetails angezeigt.
       1. Wählen Sie einen Truststore-Typ aus. Es kann entweder Öffentlich, Privat oder Unsichere Verbindung sein.
       2. Wählen Sie die Zertifikate entsprechend Ihrer Auswahl des Trust Stores aus.
       3. Wenn Sie mTLS verwenden, wählen Sie die Schlüsselspeicherzertifikate im Abschnitt Schlüsselspeicher aus.
       4. Wählen Sie optional die TLS-Version aus.
       5. Geben Sie die unterstützte Cipher-Suite ein. Geben Sie mehrere Cipher-Suites als durch Kommas getrennte Werte ein. Weitere Informationen finden Sie unter Unterstützte Chiffrierverfahren.
   12. Klicken Sie auf Weiter.
7. Überspringen Sie den Abschnitt Ziele.
8. Klicken Sie auf Weiter.
9. Im Abschnitt Authentifizierung müssen Sie keine Authentifizierungsdetails angeben, da für die HL7-Verbindung keine Authentifizierung erforderlich ist.
10. Konfigurieren Sie im Bereich Details zum Ereignisabo die ereignisbezogenen Details.
    • Projektname: Das Google Cloud-Projekt, in dem sich die Pub/Sub-Instanz befindet.
    • Name des Pub/Sub-Themas: Der Name des Pub/Sub-Themas, das dem HL7v2-Speicher zugeordnet werden soll, an den die Benachrichtigungen gesendet werden.
11. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
12. Klicken Sie auf Erstellen.

Unterstützte Cipher Suites

Trigger-Ausgabe

Es dauert einige Minuten, bis der HL7-Trigger die Konfiguration des Ereignisabos abgeschlossen hat. Den Status Ihres Ereignisabos können Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo einsehen.

Der HL7-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

• restart_alt Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• check_circle Active: Gibt an, dass der Trigger erfolgreich für ein Ereignisabo registriert wurde.
• error Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Status des Ereignisabos werden im Bereich Details zum Ereignisabo auch andere Details wie Verbindungsregion, Verbindungsname und Name des Ereignisabos angezeigt.

Variable „Trigger-Ausgabe“

Für jedes Ereignis generiert der HL7-Trigger eine ConnectorEventPayload-Ausgabevariable (im JSON-Format), die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable enthält die Nutzlast Ihres HL7-Ereignisses. Beispiel:

 {
 "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"
}

Ereignisabos ansehen

So rufen Sie alle Ereignisabos auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

1. Rufen Sie die Seite Integration Connectors > Connections (Integration Connectors > Verbindungen) auf.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
3. Klicken Sie auf den Tab Event-Abos.

   Hier werden alle Ereignisabos für die Verbindung angezeigt.

HL7-Trigger bearbeiten

Sie können einen HL7-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignisabo zu ändern oder zu aktualisieren.

So bearbeiten Sie einen HL7-Trigger:

1. Klicken Sie im Integrationseditor auf das Element HL7-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf HL7-Trigger konfigurieren.
3. Führen Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Schritte aus:
   1. Wenn Sie das zuvor konfigurierte Ereignis-Abo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
   2. Aktualisieren Sie die Verbindungs- und Ereignisaboeinstellungen nach Bedarf.
   3. Klicken Sie auf Fertig.

Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.