API-Anfrage erfüllen

---

In dieser Anleitung wird ein Anwendungsfall beschrieben, in dem Sie die Anwendungsintegration verwenden, um Informationen für eine Ingress API-Anfrage zu leiten und abzurufen.

Übersicht

In dieser Anleitung erstellen Sie eine Integration mit einem API-Trigger, der API-Anfragen zum Abrufen von Kundeninformationen empfängt. Je nach Standort der API-Anfrage ruft die Integration die Kundendetails entweder aus einer MySQL- oder einer Oracle-Datenbank ab.

Lernziele

In dieser Anleitung erfahren Sie, wie Sie die folgenden Aufgaben in Ihrer Integration ausführen:

• Fügen Sie einen API-Trigger hinzu.
• Fügen Sie Connectors-Aufgaben für MySQL- und Oracle-Verbindungen hinzu und konfigurieren Sie sie.
• Fügen Sie Aufgaben zum Datenabgleich hinzu und konfigurieren Sie sie, um die API-Nutzlast zu extrahieren und abzugleichen.

Kosten

In dieser Anleitung werden die folgenden kostenpflichtigen Komponenten von Google Cloud verwendet:

• Anwendungsintegration
• Integration Connectors
• Secret Manager

Die Anleitungen in diesem Leitfaden sind so konzipiert, dass Ihre Ressourcennutzung innerhalb der Limits der Immer kostenlos-Stufe von Google Cloud bleibt.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

Hinweis:Alle anderen erforderlichen Google Cloud APIs wie die Application Integration API, die Secret Manager API und die Connectors API werden während der Einrichtung der Anwendungsintegration aktiviert. Weitere Informationen finden Sie unter Application Integration einrichten.

Umgebung vorbereiten

MySQL-Datenbank einrichten

Stellen Sie eine Verbindung zu Ihrem MySQL-Server her und erstellen Sie eine Datenbank und eine Tabelle für die Verwendung in dieser Anleitung. In dieser Anleitung wird eine Datenbank mit einer Tabelle namens Customers mit den folgenden Zeilen verwendet:

  +-------------+---------------+--------------------+------------------+
  | customer_id | customer_name | customer_emailID   | customer_city    |
  +-------------+---------------+--------------------+------------------+
  |           1 | Alex          | [e-mail]   | New York         |
  |           2 | Dana          | [e-mail]   | Seattle          |
  +-------------+---------------+--------------------+------------------+
  

Informationen zum Erstellen und Verwenden einer MySQL-Datenbank finden Sie in der MySQL-Dokumentation.

Oracle-Datenbank einrichten

Stellen Sie eine Verbindung zu Ihrer Oracle-Datenbank her und erstellen Sie eine Tabelle für die Verwendung in dieser Anleitung. In dieser Anleitung wird eine Datenbank mit einer SQL-Tabelle namens Customers mit den folgenden Zeilen verwendet:

  +-------------+---------------+--------------------+------------------+
  | customer_id | customer_name | customer_emailID   | customer_city    |
  +-------------+---------------+--------------------+------------------+
  |           1 | Amal          | [e-mail]   | Delhi            |
  |           2 | Hao           | [e-mail]   | Beijing          |
  +-------------+---------------+--------------------+------------------+
  

Informationen zum Erstellen und Verwenden einer Oracle-Datenbank finden Sie in der Oracle-Dokumentation.

Verbindungen konfigurieren

Für diese Anleitung müssen Sie die folgenden Verbindungen in Integration Connectors konfigurieren:

Tipp:Wir empfehlen, die folgenden Verbindungen in der Region us-central1(lowa) zu erstellen.

MySQL-Verbindung

Konfigurieren Sie eine MySQL-Verbindung in Integration Connectors, um die Entitäten der Customer-Tabellen abzurufen. Informationen zum Konfigurieren eines MySQL-Connectors finden Sie unter MySQL-Connector.

Oracle DB-Verbindung

Konfigurieren Sie eine Oracle-Datenbankverbindung in Integration Connectors, um die Entitäten der Customer-Tabellen abzurufen. Informationen zum Konfigurieren eines MySQL-Connectors finden Sie unter Oracle-Datenbank-Connector.

Integration erstellen

So erstellen Sie eine neue Integration:

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 Integrationen wird angezeigt.
3. Klicken Sie auf Integration erstellen und geben Sie auf der Seite Integration erstellen die folgenden Details an:
   1. Name der Integration:Geben Sie api_fulfilment ein.
   2. Beschreibung:Geben Sie Demo integration created for tutorial ein.
   3. Region:Wählen Sie us-central1 aus der Liste der unterstützten Regionen aus.
   4. Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

Integrationstrigger einrichten

Nachdem Sie die Integration erstellt haben, können Sie einen Integrationstrigger hinzufügen und konfigurieren, der die Integration für ein bestimmtes Ereignis auslöst.

In dieser Anleitung wird ein API-Trigger verwendet, um die Integration bei jeder neuen API-Anfrage aufzurufen. So fügen Sie Ihrer api_fulfilment-Integration einen API-Trigger hinzu und konfigurieren ihn:

1. Klicken Sie im Integrationseditor auf Trigger, um eine Liste der verfügbaren Trigger aufzurufen.
2. Klicken Sie auf das Element API-Trigger und platzieren Sie es im Integrationseditor.

   Bei der Anwendungsintegration werden das Triggerlabel, der Triggername und die Trigger-ID automatisch ausgefüllt. Die Trigger-ID ist eine maschinengenerierte ID im Format api_trigger/TRIGGER_NAME und wird in der API-Anfrage verwendet.

Für diesen Trigger ist keine weitere Konfiguration erforderlich.

Integrationsvariablen erstellen

Integrationsvariablen ähneln Variablen, die in einer Programmiersprache verwendet werden. Daten in den Variablen können während der Ausführung der Integration gelesen und geschrieben werden. So erstellen Sie die erforderlichen Variablen für diese Anleitung:

1. Klicken Sie in der Navigationsleiste des Designers auf  (Bereich ein-/ausblenden), um den Bereich Variablen aufzurufen.
2. Klicken Sie auf + Erstellen und erstellen Sie die folgenden Integrationsvariablen:

   Variablenname	Datentyp	Variablentyp
   location	STRING	Eingabe in die Integration
   customer_id	STRING	Eingabe in Integration
   customer_record	JSON	Ausgabe der Integration

Kundendaten aus einer MySQL-Datenbank abrufen

Wenn die Ingress API-Anfrage vom Standort US stammt, gehe so vor, um Kundendaten aus der MySQL-Datenbank abzurufen.

Verbindung zur MySQL-Datenbank herstellen

Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe hinzuzufügen und zu konfigurieren, um die Kundendetails aus der MySQL-Tabelle Kunden abzurufen:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
3. Wählen Sie im Designer das Aufgabenelement Connectors aus, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie das Label Connectors in Fetch MySQL Data um.
5. Klicken Sie auf Connector konfigurieren.
6. Führen Sie auf der Seite Connectors-Aufgabeneditor die folgenden Schritte aus:
   1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
   2. Wählen Sie Ihre Salesforce-Verbindung aus der Liste der verfügbaren Verbindungen aus.
   3. Klicken Sie auf Weiter.
   4. Wählen Sie unter Typ die Option Entitäten aus.
   5. Wählen Sie unter Entitäten/Aktionen festlegen aus der Liste der verfügbaren Entitäten Kunden und dann als Vorgang Abrufen aus.
   6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Kundennummer dem MySQL-Connector zuordnen

Mit einer Aufgabe vom Typ Datenabgleich wird die Kunden-ID dem MySQL-Connector zugeordnet. So fügen Sie der Integration die Datenzuordnung hinzu und konfigurieren sie:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
3. Wählen Sie im Designer das Element Datenabgleich aus, um den Konfigurationsbereich der Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie die Aufgabe Datenabgleich in Map to MySQL um.
5. Klicken Sie auf Datenabgleichs-Editor öffnen.

   Mit den Transformationsfunktionen im Datenabgleichs-Editor können Sie Eingabevariablen den gewünschten Ausgabevariablen zuordnen. Die Ausgabe ist dann als Variable für alle anderen Integrationsaufgaben oder Trigger verfügbar. Weitere Informationen zum Zuordnen von Variablen finden Sie unter Zuordnung hinzufügen.

6. Ordnen Sie die Triggervariable „customer_id“ der automatisch generierten Connector-Eingabevariablen „entityId(Fetch MySQL Data)“ zu.

   Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

7. Fügen Sie eine Edge-Verbindung von der Aufgabe MySQL zuordnen zum Connector MySQL-Daten abrufen hinzu.

MySQL-Kundendetails abrufen

So rufst du die Kundendetails aus dem MySQL-Connector ab:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
3. Klicken Sie im Designer auf das Element Datenabgleich, um den Konfigurationsbereich der Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie die Aufgabe Datenabgleich in Get MySQL data um.
5. Klicken Sie auf Datenabgleichs-Editor öffnen.
6. Ordnen Sie die MySQL-Ausgabevariable connectorOutputPayload (Fetch MySQL Data) der Integrationsvariablen customer_record zu.

   Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

7. Fügen Sie eine Edge-Verbindung vom Connector MySQL-Daten abrufen zur Aufgabe MySQL-Daten abrufen hinzu.

Kundendaten aus der Oracle-Datenbank abrufen

Wenn die Ingress API-Anfrage vom Standort APAC stammt, gehe so vor, um Kundendaten aus der Oracle-Datenbank abzurufen.

Verbindung zur Oracle-Datenbank herstellen

Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe hinzuzufügen und zu konfigurieren, um die Kundendetails aus der Oracle-Tabelle Kunden abzurufen:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
3. Wählen Sie im Designer das Aufgabenelement Connectors aus, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie das Label Connectors in Fetch Oracle Data um.
5. Klicken Sie auf Connector konfigurieren.
6. Führen Sie auf der Seite Connectors-Aufgabeneditor die folgenden Schritte aus:
   1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
   2. Wählen Sie Ihre Salesforce-Verbindung aus der Liste der verfügbaren Verbindungen aus.
   3. Klicken Sie auf Weiter.
   4. Wählen Sie unter Typ die Option Entitäten aus.
   5. Wählen Sie unter Entitäten/Aktionen festlegen aus der Liste der verfügbaren Entitäten Kunden und dann als Vorgang Abrufen aus.
   6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Kundennummer dem Oracle-Connector zuordnen

So fügen Sie der Integration die Datenzuordnung hinzu und konfigurieren sie:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
3. Wählen Sie im Designer das Element Datenabgleich aus, um den Konfigurationsbereich der Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie die Aufgabe Datenabgleich in Map to Oracle um.
5. Klicken Sie auf Datenabgleichs-Editor öffnen.
6. Ordnen Sie die Trigger-Integrationsvariable customer_id der automatisch generierten Connector-Eingabevariablen entityId(Fetch Oracle Data) zu.

   Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

7. Fügen Sie eine Edge-Verbindung von der Aufgabe Zu Oracle zuordnen zum Connector Oracle-Daten abrufen hinzu.

Oracle-Kundendetails abrufen

So rufst du die Kundendetails aus dem Oracle-Connector ab:

1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
3. Klicken Sie im Designer auf das Element Datenabgleich, um den Konfigurationsbereich der Aufgabe aufzurufen.
4. Klicken Sie auf  und benennen Sie die Aufgabe Datenabgleich in Get Oracle data um.
5. Klicken Sie auf Datenabgleichs-Editor öffnen.
6. Ordnen Sie die Ausgabevariable „Oracle-connectorOutputPayload (Fetch Oracle Data)“ der Integrationsvariablen „customer_record“ zu.

   Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

7. Fügen Sie eine Edge-Verbindung vom Connector Oracle-Daten abrufen zur Aufgabe Oracle-Daten abrufen hinzu.

Edge-Bedingung hinzufügen

Mit einer Edge-Bedingung können Sie die Bedingungen angeben, die erfüllt sein müssen, damit die Steuerung über eine Integration an die durch die Edge verbundene Aufgabe übergeben wird. Nachdem Sie die erforderlichen Aufgaben hinzugefügt und konfiguriert haben, können Sie eine Kante Bedingung hinzufügen, um den Ablauf der Integration zu definieren.

Die folgende Edge-Bedingung steuert den Ablauf der Integration basierend auf der Integrationsvariablen location:

1. Fügen Sie eine Edge-Verbindung vom API-Trigger zur Aufgabe MySQL zuordnen mit der folgenden Edge-Bedingung hinzu:

     $location$ = "US"

2. Fügen Sie der Aufgabe Auf Oracle abbilden eine weitere Edge-Verbindung aus dem API-Trigger mit der folgenden Edge-Bedingung hinzu:

     $location$ = "APAC"

Beispiel für einen Integrationsablauf

Die folgende Abbildung zeigt ein Beispiellayout der Integration, die mit dieser Anleitung erstellt wurde.

Integration veröffentlichen

Klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen, um die Integration zu veröffentlichen.

Nach der Veröffentlichung Ihrer Integration können Sie die Ausführungslogs der veröffentlichten Integration aufrufen und prüfen. Klicken Sie auf Ausführungsprotokolle für diese Integration ansehen, um die Protokolle aufzurufen. Die Seite Ausführungslogs wird angezeigt.

Integration testen

Integration über den Integrationseditor testen

So testen Sie die Integration über den Integrationseditor:

1. Klicken Sie in der Symbolleiste des Integrationseditors auf Testen.

   Der Bereich Integration testen wird angezeigt.

2. Sie werden aufgefordert, die Testwerte für die Eingabevariablen der Integration einzugeben. Gehen Sie für diesen Test so vor:
   • customer_id::Geben Sie 1 ein.
   • location:Geben Sie APAC ein.
3. Klicken Sie auf Integration testen.

Die Integration wird erfolgreich ausgeführt und der folgende Kundenwert wird angezeigt:

{ 
  "CUSTOMER_ID": 1,
  "CUSTOMER_NAME": "Amal"
  "CUSTOMER_EMAILID": "[e-mail] "
  "CUSTOMER_CITY": "Delhi"
}

Weitere Informationen zu Tests finden Sie unter Integrationen testen und veröffentlichen.

Mit einem REST API-Aufruf testen

Nachdem die Integration veröffentlicht und ausgeführt wird, können Sie sie mit dem folgenden POST REST-Aufruf aufrufen:

URL:

https://integrations.googleapis.com/v1/projects/project-name/locations/-/integrations/api_fulfilment:execute 

Anfragetext:

{"trigger_id":"api_trigger/api_fulfilment_API_1"}

Beispiel: API-Anfrage mit benutzerdefinierten Eingaben senden

Hinweis:Im folgenden Beispiel wird curl verwendet, das normalerweise auf Linux- und macOS-Betriebssystemen vorinstalliert ist. Wenn curl nicht installiert ist, können Sie es von der Seite Releases und Downloads für curl herunterladen.

curl -v -X POST -H "Content-Type: application/json" 'https://integrations.googleapis.com/v1/projects/connectors-ip-test/locations/us-central1/integrations/api-fulfillment-integration:execute' -H "Authorization: Bearer $(gcloud auth AUTH_PROFILE)" -d  '{ "triggerId": "api_trigger/api-fulfillment-integration_API_1", "inputParameters": { "customer_id": {"string_value": 1}, "location" : {"string_value" : "US"}} }'

Die API gibt die Antwort zur Ausführung der Integration zurück, die die folgenden JSON-Elemente enthält:

  { 
    "CUSTOMER_ID": 2,
    "CUSTOMER_NAME": "Dana"
    "CUSTOMER_EMAILID": "[e-mail] "
    "CUSTOMER_CITY": "Seattle"
  }
  

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, widerrufen Sie die Veröffentlichung der Integration und löschen Sie die in Integration Connectors erstellten Verbindungen.

• Wenn Sie die Veröffentlichung dieser Integration aufheben möchten, klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichung aufheben. Weitere Informationen finden Sie unter Integrationen löschen.
• Informationen zum Löschen einer Verbindung finden Sie unter Connectors verwalten.