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:
- Connectors-Administrator (roles/connectors.admin)
Weisen Sie dem Dienstkonto, das Sie für den SAP Gateway-Trigger verwenden möchten, die folgenden IAM-Rollen zu:
- Aufrufer von Application Integration (roles/integrations.integrationInvoker)

SAP-Gateway-Trigger hinzufügen

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

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
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:
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.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
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 Zusammenfassung ändern oder aktualisieren.
  Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
Klicken Sie auf das Element SAP Gateway-Trigger und platzieren Sie es im Integrationseditor.

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:

Klicken Sie im Integrationseditor auf das Element SAP Gateway-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
Klicken Sie auf Trigger konfigurieren.
Geben Sie auf der Seite Editor für Connector-Ereignistrigger die folgenden Konfigurationsdetails an:
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. Dieses Feld ermittelt den Ereignistyp, der 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.
Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

SAP Gateway-Trigger mit einer neuen Verbindung konfigurieren

Klicken Sie im Integrationseditor auf das Element SAP Gateway-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
Klicken Sie auf Trigger konfigurieren.
Überspringen Sie das Feld Region.
Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
Führen Sie im Abschnitt Connection Details (Verbindungsdetails) die folgenden 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 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. 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 Ereignisabos 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 Ereignisabos zu verwenden. Wenn Sie diese Option auswählen, klicken Sie auf Weiter und konfigurieren Sie das Ereignisabo.
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.
Legen Sie im Abschnitt Destinations (Ziele) die URL Ihrer SAP Gateway-Umgebung oder die vollständige URL des OData-Dienstes fest. Beispiel: ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/. Die Beispiel-URL ist https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Fügen Sie zusätzliche Attribute 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.
    Hinweis: Informationen zum Erstellen eines Endpunktanhangs finden Sie unter PSC-Dienstanhang und Endpunktanhang. Nachdem Sie den Endpunktanhang erstellt haben, wird er in der Liste Endpunktanhang angezeigt.
  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 so konfigurieren, dass nur bestimmte statische IP-Adressen auf die Zulassungsliste gesetzt werden.
  
  Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + ZIEL HINZUFÜGEN.
2. Tippen Sie auf Weiter.
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. Tippen Sie auf Weiter.
Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
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:

Wählen Sie einen der folgenden Authentifizierungstypen für den Event-Listener aus.
Hinweis : Prüfen Sie vor dem Konfigurieren der Authentifizierung, ob Sie den Event-Listener-Endpunkt haben, der Ihnen nach dem Herstellen der Verbindung zur Verfügung steht. Rufen Sie zum Anzeigen des Endpunkts die Seite Alle Verbindungen auf und klicken Sie auf die Verbindung, die Sie aufrufen möchten. Der Endpunkt wird im Abschnitt Verbindungsdetails angezeigt.
- Google-Authentifizierung. Wenn Sie diese Option aktivieren, folgen Sie den Schritten unter Mit JSON Web Tokens authentifizieren, um die Authentifizierung für das ABAP SDK zu konfigurieren. Sorgen Sie außerdem dafür, dass das Dienstkonto die Rolle roles/connectors.listener hat, deren Zugriffstoken für die Authentifizierung verwendet wird.
- API-Schlüsselauthentifizierung Wenn Sie diese Option auswählen, sollten Sie einen API-Schlüssel erstellt und dann als Secret Manager-Secret gespeichert haben. Weitere Informationen finden Sie unter API-Schlüssel erstellen.
Geben Sie den Feldnamen für den Ereignistyp ein. Dieses Feld ermittelt den Ereignistyp, der mit der eingehenden Ereignisanfrage verknüpft ist.
```
{
"event_type": "user.created",
...
// other request fields
...
}
```
Wählen Sie für eine sichere Verbindung zwischen Ihrer Back-End-Anwendung und Ihrer Verbindung Private Verbindung aktivieren aus. 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 Verbindungen für Ereignisabos.
Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie unzustellbare 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 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.