Informationen zu den unterstützten Connectors für Application Integration.

HL7-Trigger

Der HL7-Trigger ist ein Trigger für Connector-Ereignisse, 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 Properties 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, an dem der MLLP-Adapter ausgeführt wird.
    5. Stellen Sie eine SSH 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 in 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 auf der VM-Instanz ausführen 
         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, an 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 Containerprotokolle 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 der 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 Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, 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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

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

    6. Zum Konfigurieren des HL7-Triggers können Sie entweder eine vorhandene HL7-Verbindung mit REST (Cloud Healthcare API) als Zielprotokoll verwenden, das in Integration Connectors verfügbar ist, oder eine neue HL7 REST-Verbindung(Google Cloud Healthcare API) mithilfe der Option zum Erstellen einer Inline-Verbindung 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 den Trigger nur mit einer HL7 REST-Verbindung(Google Cloud Healthcare API) mit aktiviertem Ereignisabo konfigurieren.

Informationen zum Konfigurieren eines HL7-Triggers mit einer neuen HL7 REST-Verbindung(Google Cloud Healthcare API) finden Sie unter HL7-Trigger mit einer neuen HL7 REST-Verbindung(Google Cloud Healthcare API) 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 gewünschte HL7 REST-Verbindung(Google Cloud Healthcare API) aus.

      In der Anwendungsintegration 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-Nachrichteninhaltstyp): „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-Verbindung(Google Cloud Healthcare API):

  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 im Bereich Verbindung erstellen die folgenden Schritte aus:
  6. Geben Sie im Schritt Verbindungsdetails Details zur neuen HL7-Verbindung ein:
    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 Receive Timeout 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. Speicherort: Der Speicherort 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. Optional: Konfigurieren Sie 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 SSL aktivieren aus. Daraufhin werden die Details zur SSL-Konfiguration angezeigt.
      1. Wählen Sie einen Typ für das Vertrauensspeicher aus. Es kann entweder Öffentlich, Privat oder Unsichere Verbindung sein.
      2. Wählen Sie die Zertifikate aus, die gemäß Ihrer Auswahl des Vertrauensspeichers angezeigt werden.
      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 Verschlüsselungssuite ein. Geben Sie mehrere Chiffren-Suites als durch Kommas getrennte Werte ein. Weitere Informationen finden Sie unter Unterstützte Chiffren-Suites.
    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, der dem HL7v2-Speicher zugeordnet werden soll, an den die Benachrichtigungsnachrichten gesendet werden.
  11. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
  12. Klicken Sie auf Erstellen.

Unterstützte Cipher Suites

TLS-Version Unterstützte Cipher Suites
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

Trigger-Ausgabe

Bei Verwendung des HL7-Triggers dauert es einige Minuten, bis die Ereignisabonnentenkonfiguration abgeschlossen ist. Den Status Ihres Ereignisabonnements finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabonnement.

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

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

Im Bereich Details zum Ereignisabo werden neben dem Status des Ereignisabos auch andere Details wie die Verbindungsregion, der Verbindungsname und der Name des Ereignisabos angezeigt.

Trigger-Ausgabevariable

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 aus Ihrem HL7-Ereignis. 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 Ereignisabonnements auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

  1. Rufen Sie die Seite 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 Ereignisabos.

    Daraufhin werden alle Ereignisabonnements 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-Ereignistrigger-Editor die folgenden Schritte aus:
    1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
    2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignisabo nach Bedarf.
    3. Klicken Sie auf Fertig.

    4. 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