SAP-Gateway-Trigger

Der SAP-Gateway-Trigger ist ein Connector-Ereignis-Trigger. 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)
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)

SAP-Gateway-Trigger hinzufügen

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

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu „Application Integration“
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.
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.
  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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
  Hinweis:Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung 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 eine Liste der verfügbaren Trigger aufzurufen.
Klicken Sie auf das Element SAP-Gateway-Trigger und platzieren Sie es im Integrationseditor.

Sie können den SAP-Gateway-Trigger entweder mit einer vorhandenen SAP-Gateway-Verbindung konfigurieren, die in den 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-Ereignistrigger. Daher können Sie den Trigger nur mit einer SAP-Gateway-Verbindung mit aktiviertem Ereignisabo konfigurieren.

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:

Klicken Sie im Integrationseditor auf das Element SAP-Gateway-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
Klicken Sie auf Trigger konfigurieren.
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 SAP Gateway-Verbindung aus.
2. Verbindung:Wählen Sie die SAP-Gateway-Verbindung aus, die Sie verwenden möchten.
  In der Anwendungsintegration werden nur die 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 Ereignistyp angegeben, 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 für die 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 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 Konnektoren, die Ereignisanmeldungen 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 Ereignisabos als auch für Connector-Vorgänge (Entitäten und Aktionen) zu verwenden.
  - Nur Ereignisabo aktivieren: Wählen Sie diese Option aus, wenn Sie die Verbindung nur für das Ereignisabo verwenden möchten. Wenn Sie diese Option auswählen, klicken Sie auf Weiter und dann auf Ereignisanmeldung 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. 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.
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 Ziele die URL Ihrer SAP-Gateway-Umgebung oder die vollständige URL des OData-Dienstes fest. Beispielformat: ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ und Beispiel-URL: https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Fügen Sie mit der Property CustomUrlParams weitere Properties hinzu.
1. Zieltyp: Wählen Sie einen Zieltyp aus.
  - Wählen Sie in der Liste Hostadresse aus, um den Hostnamen oder die IP-Adresse des Ziels 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 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.
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 Details zum Ereignisabo die folgenden Werte ein:

Wählen Sie einen der folgenden Authentifizierungstypen für den Ereignisempfänger aus.
Hinweis : Bevor Sie die Authentifizierung konfigurieren, müssen Sie den Endpunkt des Ereignisempfängers kennen. Dieser ist nach dem Erstellen der Verbindung verfügbar. Wenn Sie sich den Endpunkt ansehen möchten, rufen Sie die Seite Alle Verbindungen auf und klicken Sie auf die Verbindung, die Sie sich ansehen möchten. Der Endpunkt wird im Bereich Verbindungsdetails angezeigt.
- Google-Authentifizierung. Wenn Sie diese Option aktivieren, folgen Sie der Anleitung unter Mit JSON-Webtokens authentifizieren, um die Authentifizierung für das ABAP SDK zu konfigurieren. Außerdem muss das Dienstkonto die Rolle roles/connectors.listener haben, deren Zugriffstoken für die Authentifizierung verwendet wird.
- Authentifizierung von API-Schlüsseln Wenn Sie diese Option auswählen, müssen 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. In diesem Feld wird der Ereignistyp angegeben, der mit der eingehenden Ereignisanfrage verknüpft ist.
```
{
"event_type": "user.created",
...
// other request fields
...
}
```
Wählen Sie Private Verbindung aktivieren für eine sichere Verbindung zwischen Ihrer Backend-Anwendung und Ihrer Verbindung 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 Verbindung für Ereignisabonnements.
Geben Sie die Konfiguration für den Postfach-Alias ein. Wenn Sie ein Dead-Letter-Thema konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
1. Dead-Letter-Projekt-ID : Die Google Cloud-Projekt-ID, in der Sie das Dead-Letter-Pub/Sub-Thema konfiguriert haben.
2. Dead-Letter-Thema : 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. Folgen Sie dazu der Anleitung im Leitfaden Authentifizierung für die lokale oder eine beliebige Cloud-Version des ABAP SDK for Google Cloud.

Trigger prüfen

Sie können ein ABAP-Programm erstellen, um den Trigger zu validieren. Im Folgenden finden Sie ein Beispiel für ein ABAP-Programm, 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

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