Unterstützte Connectors für Application Integration

SAP Gateway-Trigger

Der SAP Gateway-Trigger ist ein Connector-Ereignistrigger. Mit dem SAP Gateway-Connector können Sie Vorgänge zum Einfügen, Löschen, Aktualisieren und Lesen von SAP Gateway-Daten ausführen.

Hinweise

  • Wenn Sie eine neue Verbindung für den SAP Gateway-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 SAP Gateway-Trigger verwenden möchten, die folgenden IAM-Rollen zu:
    • Application Integration Invoker (roles/integrations.integrationInvoker)

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

    • SAP Gateway-Trigger hinzufügen

    Führen Sie die folgenden Schritte aus, um Ihrer Integration einen SAP Gateway-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 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 SAP Gateway-Trigger und platzieren Sie es im Integrationseditor.

      6. Zum Konfigurieren des SAP Gateway-Triggers können Sie entweder eine vorhandene SAP Gateway-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder eine neue SAP Gateway-Verbindung mit der Inline-Option zum Erstellen von Verbindungen erstellen.

    SAP Gateway-Trigger mit einer vorhandenen Verbindung konfigurieren

    Der SAP Gateway-Trigger ist ein Connector-Ereignistrigger. Daher können Sie zum Konfigurieren des Triggers nur eine SAP Gateway-Verbindung mit aktivierter Ereignisregistrierung verwenden.

    Informationen zum Konfigurieren eines SAP Gateway-Triggers mit einer neuen SAP Gateway-Verbindung finden Sie unter SAP Gateway-Trigger mit einer neuen Verbindung konfigurieren.

    So konfigurieren Sie einen SAP Gateway-Trigger mit einer vorhandenen SAP Gateway-Verbindung:

    1. Klicken Sie im Integrationseditor auf das Element SAP Gateway-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 die folgenden Konfigurationsdetails an:
      1. Region:Wählen Sie die Region Ihrer SAP Gateway-Verbindung aus.
      2. Verbindung:Wählen Sie die SAP Gateway-Verbindung aus, die Sie verwenden möchten.

        In der Anwendungsintegration werden nur SAP Gateway-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

      3. Geben Sie den Feldnamen für den Ereignistyp ein. In diesem Feld wird der Typ des Ereignisses angegeben, das mit der eingehenden Ereignisanfrage verknüpft ist. 
        {
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
      4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den SAP Gateway-Trigger aus.
    4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

    SAP Gateway-Trigger mit einer neuen Verbindung konfigurieren

    1. Klicken Sie im Integrationseditor auf das Element SAP Gateway-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
    2. Klicken Sie auf Trigger konfigurieren.
    3. Überspringen Sie das Feld Region.
    4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
    5. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
      1. Connector: Wählen Sie SAP Gateway aus der Drop-down-Liste der verfügbaren Connectors aus.
      2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
      3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

        Verbindungsnamen müssen die folgenden Kriterien erfüllen:

        • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
        • Buchstaben müssen Kleinbuchstaben sein.
        • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
        • Verbindungsnamen dürfen maximal 49 Zeichen haben.
        • Bei Connectors, die Ereignisabos unterstützen, dürfen die Verbindungsnamen nicht mit dem Präfix „goog“ beginnen.
      4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
      5. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
      6. Wenn Sie die Verbindung für Ereignisabos verwenden möchten, wählen Sie Ereignisabo aktivieren aus. Wenn Sie diese Option auswählen, werden die folgenden Optionen angezeigt:
        • Ereignisabo mit Entität und Aktionen aktivieren: Wählen Sie diese Option aus, um die Verbindung sowohl für das Ereignisabo als auch für Connector-Vorgänge (Entitäten und Aktionen) zu verwenden.
        • Nur Ereignisabo aktivieren: Wählen Sie diese Option aus, um die Verbindung nur für das Ereignisabo zu verwenden. Wenn Sie diese Option auswählen, klicken Sie auf Weiter und konfigurieren Sie dann das Ereignis-Abo.
      7. Namespace: Geben Sie den Service-Namespace an, aus dem Sie Daten abrufen möchten. Dies ist erforderlich, wenn der Dienst nicht in der URL angegeben ist.
      8. Dienst: Geben Sie den Dienst an, von dem Sie Daten abrufen möchten. Dies ist erforderlich, wenn der Dienst nicht in der URL angegeben ist.
      9. CustomUrlParams:Geben Sie benutzerdefinierte Abfragestringparameter an, die in der HTTP-Anfrage enthalten sind. Die Parameter müssen als Abfragestring im folgenden Format codiert werden: field1=value1&field2=value2. Die Werte im Abfragestring müssen URL-codiert sein.
      10. Datenformat: Das Datenformat, in dem Daten abgerufen werden sollen. Wählen Sie entweder XML oder JSON aus.
      11. Display Names verwenden: Boolesch, um festzulegen, ob SAP-Labels verwendet werden sollen.
      12. 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.

      13. Klicken Sie optional auf + LABEL HINZUFÜGEN, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      14. Tippen Sie auf Weiter.
    6. Legen Sie im Abschnitt Ziele die URL Ihrer SAP Gateway-Umgebung oder die vollständige URL des OData-Dienstes fest. Beispielformat: ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/. Beispiel-URL: https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Fügen Sie zusätzliche Eigenschaften mit der Eigenschaft CustomUrlParams hinzu.
      1. Zieltyp: Wählen Sie einen Zieltyp aus.
        • Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
        • Wenn Sie eine private Verbindung herstellen möchten, wählen Sie Endpunktanhang aus und wählen Sie den erforderlichen Anhang aus der Liste Endpunktanhang aus.

        Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

        Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + ZIEL HINZUFÜGEN.

      2. Tippen Sie auf Weiter.
    7. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
      1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

        Die folgenden Authentifizierungstypen werden von der SAP Gateway-Verbindung unterstützt:

        • Nutzername und Passwort
        • Anonym
        • SAP BTP (OAuth 2.0 – Clientanmeldedaten)

        2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

      2. Tippen Sie auf WEITER.
    8. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
    9. Klicken Sie auf Erstellen.

    Authentifizierung konfigurieren

    Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

    • Nutzername und Passwort
      • Nutzername: Nutzername für den Connector
      • Passwort: Secret Manager-Secret mit dem Passwort, das mit dem Connector verknüpft ist.
    • Anonym

      Wenn Sie die anonyme Anmeldung verwenden möchten, wählen Sie Nicht verfügbar aus.

      • API-Schlüssel: Der API-Schlüssel des derzeit authentifizierten Nutzers.
    • SAP BTP (OAuth 2.0 – Clientanmeldedaten)
      • Client-ID: Geben Sie die Client-ID ein, die Sie auf der Seite „API-Client“ erhalten haben.
      • Clientschlüssel: Geben Sie den Clientschlüssel ein, den Sie auf der Seite „API-Client“ erhalten haben.
      • Secret-Version: Geben Sie die Secret-Version für das oben ausgewählte Secret ein.
      • OAuthAccessTokenURL: Geben Sie die URL des OAuth-Zugriffstokens ein.
      • Zielname: Geben Sie den Namen des SAP BTP-Ziels ein.
      • Ziel-URL: Geben Sie die Ziel-URL der SAP BTP ein.
      • Authentifizierungsüberschreibung aktivieren: Wählen Sie diese Option aus, damit für die Verbindung während der Laufzeit dynamisch eine andere Authentifizierung akzeptiert wird.

    Ereignisabo konfigurieren

    Wenn Sie das Ereignis-Abo aktiviert haben, geben Sie im Abschnitt Details zum Ereignis-Abo die folgenden Werte ein:

    1. Wählen Sie einen der folgenden Authentifizierungstypen für den Event-Listener aus.
    2. Geben Sie den Feldnamen für den Ereignistyp ein. In diesem Feld wird der Typ des Ereignisses angegeben, das mit der eingehenden Ereignisanfrage verknüpft ist. 
      {
"event_type": "user.created",
...
// other request fields
...
}
    3. Wählen Sie Private Verbindung aktivieren aus, um eine sichere Verbindung zwischen Ihrer Backend-Anwendung und Ihrer Verbindung herzustellen. Wenn Sie diese Option auswählen, müssen Sie nach dem Erstellen der Verbindung zusätzliche Konfigurationsschritte ausführen. Weitere Informationen finden Sie unter Private Verbindung für Ereignisabos.
    4. Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie ein Thema für fehlgeschlagene Nachrichten konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
      1. Projekt-ID für Unzustellbarkeitsnachrichten : Die Google Cloud-Projekt-ID, in der Sie das Pub/Sub-Thema für Unzustellbarkeitsnachrichten konfiguriert haben.
      2. Thema für unzustellbare Nachrichten : Das Pub/Sub-Thema, in das Sie die Details des nicht verarbeiteten Ereignisses schreiben möchten.

    Authentifizierung in SAP konfigurieren

    Konfigurieren Sie die Authentifizierung in SAP gemäß der Anleitung im Leitfaden Authentifizierung für die lokale oder eine beliebige Cloud-Version des ABAP SDK for Google Cloud.

    Trigger validieren

    Um den Trigger zu validieren, können Sie ein ABAP-Programm erstellen. Das folgende ABAP-Beispielprogramm kann als Referenz dienen. Das Feld ls_event_payload ändert sich je nach Ihren Anforderungen:

    *&---------------------------------------------------------------------*
*& Report ZR_TEST_INT_CONNECTOR
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT zr_test_int_connector.
PARAMETERS: p_auth TYPE char1 RADIOBUTTON GROUP rbg1 USER-COMMAND uc DEFAULT 'X',
 p_apik TYPE char1 RADIOBUTTON GROUP rbg1.
DATA:
 lv_p_projects_id TYPE string,
 lv_p_locations_id TYPE string,
 lv_p_connections_id TYPE string,
 ls_input TYPE /goog/cl_connectors_v1=>ty_103.
TYPES: BEGIN OF event_payload,
 event_type TYPE string,
 event_id TYPE string,
 name TYPE string,
 org_id TYPE string,
 END OF event_payload.
DATA: ls_event_payload TYPE event_payload.
ls_event_payload = VALUE #(
 event_type = 'create-entity'
 event_id = '1'
 name = 'demo-org'
 org_id = 'SAP'
 ).
TRY.
 IF p_Auth = abap_true.
 DATA(lv_client_key) = 'IC_DEMO_GOOGLE_AUTH'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway'.
 ELSE.
 lv_client_key = 'IC_DEMO_GOOGLE_APIK'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway-apik'.
 ENDIF.
* Open HTTP Connection
 DATA(lo_client) = NEW /goog/cl_connectors_v1( iv_key_name = CONV #( lv_client_key ) ).
* Populate relevant parameters
 lv_p_projects_id = lo_client->gv_project_id.
 lv_p_locations_id = 'us-central1'.
 GET REFERENCE OF ls_event_payload INTO ls_input-payload .
* Call API method: connectors.projects.locations.connections.listenEvent
 CALL METHOD lo_client->listen_event_connections
 EXPORTING


iv_p_projects_id = lv_p_projects_id
 iv_p_locations_id = lv_p_locations_id
 iv_p_connections_id = lv_p_connections_id
 is_input = ls_input
 IMPORTING
* es_raw =
 es_output = DATA(ls_output)
 ev_ret_code = DATA(lv_ret_code)
 ev_err_text = DATA(lv_err_text)
 es_err_resp = DATA(ls_err_resp).
 IF lo_client->is_success( lv_ret_code ).
 MESSAGE 'Success' TYPE 'S'.
 ELSE.
 MESSAGE lv_err_text TYPE 'E'.
 ENDIF.
* Close HTTP Connection
 lo_client->close( ).
 CATCH /goog/cx_sdk INTO DATA(lo_exception).
 MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.

    Kontingente und Limits

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

    Nächste Schritte