<ph type="x-smartling-placeholder"></ph> Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

SAP-Gateway-Trigger

Der SAP Gateway-Trigger ist ein Connector-Ereignis-Trigger, mit dem Sie SAP Gateway-Daten einfügen, löschen, aktualisieren und lesen können.

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: <ph type="x-smartling-placeholder">
      </ph>
    • Connectors-Administrator (roles/connectors.admin)
    • 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: <ph type="x-smartling-placeholder">
      </ph>
    • Aufrufer von Application Integration (roles/integrations.integrationInvoker)
    • Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

  • SAP-Gateway-Trigger hinzufügen

    So fügen Sie Ihrer Integration einen SAP Gateway-Trigger hinzu:

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

      Zu Application Integration

    2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

      Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

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

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

      1. Geben Sie im Bereich Create Integration (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 in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ä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 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 Option zum Erstellen einer Inline-Verbindung erstellen.

    SAP Gateway-Trigger mit einer vorhandenen Verbindung konfigurieren

    Der SAP Gateway-Trigger ist ein Connector-Ereignis-Trigger. Daher können Sie zum Konfigurieren des Triggers nur eine SAP Gateway-Verbindung mit aktiviertem Ereignisabo 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.

    Führen Sie die folgenden Schritte aus, um einen SAP Gateway-Trigger unter Verwendung einer vorhandenen SAP Gateway-Verbindung zu konfigurieren:

    1. Klicken Sie im Integrationseditor auf das Element SAP Gateway-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
    2. Klicken Sie auf Trigger konfigurieren.
    3. Geben Sie auf der Seite Editor für Connector-Ereignistrigger die folgenden Konfigurationsdetails an: <ph type="x-smartling-placeholder">
        </ph>
      1. Region: Wählen Sie die Region Ihrer SAP Gateway-Verbindung aus.
      2. Connection (Verbindung): Wählen Sie die SAP Gateway-Verbindung aus, die Sie verwenden möchten.

        Application Integration zeigt nur die SAP Gateway-Verbindungen an, 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 Ereignistyp angegeben. die mit der eingehenden Ereignisanfrage verknüpft sind.
        {
            "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 mit der 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 Connection Details (Verbindungsdetails) die folgenden Schritte aus: <ph type="x-smartling-placeholder">
        </ph>
      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 63 Zeichen haben.
      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. Wird ausgewählt werden folgende Optionen angezeigt: <ph type="x-smartling-placeholder">
          </ph>
        • Ereignisabo mit Entität und Aktionen aktivieren: Wählen Sie diese Option aus, um Die Verbindung wird sowohl für Ereignisabo- als auch für Connector-Vorgänge (Entitäten und Aktionen) verwendet.
        • Nur Ereignisabo aktivieren: Wählen Sie diese Option aus, um die Verbindung zu verwenden. nur für Ereignisabos. Wenn Sie diese Option auswählen, klicken Sie auf Weiter und dann auf Ereignisabo konfigurieren.
      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 sein: 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 Einstellungen für den Verbindungsknoten:

        • 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 Destinations (Ziele) die URL Ihrer SAP Gateway-Umgebung oder die vollständige URL des OData-Dienstes fest. Format; ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ und die Beispiel-URL ist https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Fügen Sie alle zusätzlichen Eigenschaften mithilfe des Attributs CustomUrlParams hinzu.
      1. Destination Type: Wählen Sie einen Destination Type aus.
        • Wählen Sie aus der Liste Hostadresse aus, um den Hostnamen oder die IP-Adresse für das Ziel anzugeben.
        • Wenn Sie eine private Verbindung zu Ihren Backend-Systemen herstellen möchten, wählen Sie in der Liste Endpunktanhang und dann den erforderlichen Endpunktanhang 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
      2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

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

    Ereignisabo konfigurieren

    Wenn Sie das Ereignisabo aktiviert haben, geben Sie im Abschnitt Event Subscription Details (Details zum Ereignisabo) 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 Ereignistyp angegeben. mit der eingehenden Ereignisanfrage verknüpft sind.
      {
      "event_type": "user.created",
      ...
      // other request fields
      ...
      }
    3. Wählen Sie für eine sichere Verbindung zwischen Ihrer Back-End-Anwendung die Option Private Verbindung aktivieren aus. und Ihre Verbindung. Wenn Sie diese Option auswählen, müssen Sie zusätzliche Konfigurationsschritte ausführen nachdem Sie die Verbindung erstellt haben. Weitere Informationen finden Sie unter Private Verbindungen für Ereignisabos.
    4. Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie unzustellbare Nachrichten konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse an das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein: <ph type="x-smartling-placeholder">
        </ph>
      1. Projekt-ID für unzustellbare Nachrichten : Die ID des Google Cloud-Projekts, in dem Sie das Pub/Sub-Thema für unzustellbare Nachrichten 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. Im Folgenden finden Sie ein ABAP-Beispielprogramm, das Sie als Referenz verwenden können. 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

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

    Nächste Schritte