Informationen zu den unterstützten Connectors für Application Integration.

Unterintegration mit einer For Every Loop-Aufgabe aufrufen

In dieser Kurzanleitung erfahren Sie, wie Sie eine Integration erstellen, die eine For Every Loop-Aufgabe zum Aufrufen einer Unterintegration verwendet. Die Subintegration übernimmt die Eingaben aus der Hauptintegration und sendet E-Mails an die Empfänger mithilfe der Aufgabe "E-Mail senden".

Unterintegration erstellen

Rufen Sie in der Google Cloud Console die Seite Anwendungsintegration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Integrationsliste) wird angezeigt.
Klicken Sie auf Integration erstellen.
Geben Sie einen Namen und eine Beschreibung für die Integration ein.
Geben Sie für diese Kurzanleitung den Namen ForEachSendEmailSubIntegration und die Beschreibung Quickstart sub-integration ein.
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.
Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

Fügen Sie der Subintegration einen API-Trigger hinzu

Trigger sind erforderlich, um die Abfolge von Aufgaben zu starten, aus denen eine Integration besteht. In dieser Kurzanleitung verwenden Sie einen API-Trigger, um die Integration zu starten.

Führen Sie die folgenden Schritte aus, um den API-Trigger hinzuzufügen und zu konfigurieren:

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

Eingabevariable in der Subintegration erstellen

Die Unterintegration verwendet eine Variable zum Speichern der von der Hauptintegration im JSON-Format empfangenen Details. So erstellen Sie eine neue Eingabevariable:

Klicken Sie in der Designer-Navigationsleiste auf (Bereich ein-/ausblenden), um den Bereich Variablen aufzurufen.
Klicken Sie auf + Erstellen, um eine Variable zu erstellen.

Führen Sie im Bereich Variable erstellen die folgenden Schritte aus:

a. Name: Geben Sie order_details ein.

b. Data Type (Datentyp): Wählen Sie JSON aus.

c. Klicken Sie auf Standardwert ableiten.

d. Geben Sie unter Default Value (Standardwert) die folgende JSON-Datei ein.

  {
    "orderId": "1",
    "customerName": "Harry Ford",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "New York",
      "country": "USA",
      "zipcode": "103487"
      },
    "items": [{
      "itemid": "111-222-333",
      "itemName": "Smartphone",
      "itemPrice": 999.0,
      "quantity": 1.0
      }, {
      "itemid": "444-555-666",
      "itemName": "Mobile Cover",
      "itemPrice": 49.0,
      "quantity": ""
      }],
    "paymentDetails": {
      "mode": "COD",
      "status": ""
      },
    "expectedDelivery": "15 March 2023"
  }

Ersetzen Sie in diesem JSON-Beispielobjekt YOUR_EMAIL_ID durch die E-Mail-ID, mit der Sie die Integration testen möchten.

e. Klicken Sie auf Als Eingabe für die Integration verwenden.

f. Klicken Sie auf Erstellen.

Datenzuordnungsaufgabe hinzufügen und konfigurieren

Mit der Datenzuordnungsaufgabe können Sie Variablenzuweisungen in Ihrer Integration ausführen, Attribute von JSON-Objekten abrufen und festlegen sowie verschachtelte Transformationsfunktionen auf Werte anwenden. Die von der Datenzuordnungsaufgabe verwendeten Variablen können entweder Integrations- oder Aufgabenvariablen sein.

Führen Sie die folgenden Schritte aus, um eine Datenzuordnungsaufgabe hinzuzufügen und zu konfigurieren:

Klicken Sie im Integrationseditor auf Aufgaben, um die Liste der verfügbaren Aufgaben aufzurufen.
Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
Klicken Sie im Integrationseditor auf das Element Datenzuordnung, um den Bereich für die Aufgabenkonfiguration zu öffnen.
Klicken Sie auf Datenabgleichs-Editor öffnen.
Konfigurieren Sie die Eingabe so:
1. Klicken Sie im Bereich Eingabe auf Variable oder Wert.
2. Geben Sie unter „Variable“ item ein und wählen Sie dann order_details.items aus.
3. Klicken Sie auf Speichern.
4. Fügen Sie order_details.items eine Zuordnungsfunktion hinzu. Klicken Sie auf das +-Symbol neben order_details.items. Scrollen Sie in der Liste der Funktionen nach unten und wählen Sie FOR_EACH(Any) -> JSON aus.
5. Geben Sie den Eingabeparameter der Funktion FOR_EACH ein. Klicken Sie auf Variable oder Wert und wählen Sie ~obj1 aus.
6. Klicken Sie auf Speichern.
7. Fügen Sie obj1 eine Zuordnungsfunktion hinzu. Klicken Sie auf + in der Zeile FOR JEACH innerhalb der Klammern nach dem Element obj1, das Sie gerade hinzugefügt haben. Scrollen Sie in der Liste der Funktionen nach unten und wählen Sie PROPERTY(String) abrufen -> JSON aus.
8. Klicken Sie auf Variable oder Wert und geben Sie unter Wert itemName ein.
9. Klicken Sie auf Speichern.
10. Klicken Sie in der Zeile nach PROPERTY ERSTELLEN auf + Funktion hinzufügen und wählen Sie TO_STRING() -> String aus.
11. Klicken Sie in der letzten Zeile auf + Funktion hinzufügen und wählen Sie TO_STRING() -> String aus.
Konfigurieren Sie die Ausgabe so:
1. Erstellen Sie eine neue Ausgabevariable. Klicken Sie im Abschnitt Ausgabe auf Neue erstellen.
2. Geben Sie im Bereich Variable erstellen den Namen items ein, übernehmen Sie für alle anderen Felder die Standardwerte und klicken Sie auf Erstellen.
Überprüfen Sie, ob die Konfiguration der Datenzuordnung der in der folgenden Abbildung entspricht.
Schließen Sie den Datenzuordnungs-Editor, um zum Integrationseditor zurückzukehren.

Aufgabe „E-Mail senden“ hinzufügen und konfigurieren

Führen Sie die folgenden Schritte aus, um die Aufgabe E-Mail senden hinzuzufügen und so zu konfigurieren, dass an alle Empfänger eine E-Mail gesendet wird.

Klicken Sie im Integrationseditor auf Aufgabe/Trigger hinzufügen.
Gehe zu Tasks, klicke auf das Element Send Email (E-Mail senden) und platziere es im Integrationseditor.
Klicken Sie im Integrationseditor auf das Aufgabenelement E-Mail senden, um den Bereich für die Aufgabenkonfiguration zu öffnen.
Legen Sie die folgenden Felder für die Aufgabeneingabe fest:
1. An Empfänger: Klicken Sie auf Variable und wählen Sie order_details.emailId aus.
2. Betreff: Geben Sie den Betreff der E-Mail ein. Geben Sie für diese Kurzanleitung Order delivery notification ein.
3. Text in Nur-Text: Geben Sie den folgenden Text ein:
```
Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
```

Die Elemente in der Subintegration verbinden

Nachdem Sie nun die erforderlichen Aufgaben und Trigger in der Teilintegration hinzugefügt und konfiguriert haben, fügen Sie eine Verbindung (Edge) zwischen den Elementen hinzu. Ein Rand stellt den Steuerungsfluss von einem Element zum nächsten dar.

Fügen Sie dem Element Datenzuordnung einen Edge aus dem Element API-Trigger hinzu. Bewegen Sie den Mauszeiger im Element API-Trigger auf einen Kontrollpunkt. Klicken Sie dann auf eine Linie und ziehen Sie sie auf einen Kontrollpunkt im Element Datenzuordnung.
Entsprechend fügen Sie einen Rand vom Element Datenzuordnung zum Element E-Mail senden hinzu.

Unterintegration testen und veröffentlichen

Um diese Unterintegration zu testen, klicken Sie in der Symbolleiste des Integrationseditors auf Testen und dann im Dialogfeld Integration testen auf Integration testen. Die Unterintegration wird mit dem Standardwert als Eingabe ausgeführt und sendet eine E-Mail an die E-Mail-Adresse, die in der Aufgabe "E-Mail senden" angegeben wurde. Nach Abschluss des Tests sollten Sie eine Erfolgsmeldung sehen.
Wenn Sie diese Unterintegration veröffentlichen möchten, klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen.

Hauptintegration erstellen

Klicken Sie im Navigationsmenü auf Integrationen, um zur Seite Integrationen zurückzukehren.
Klicken Sie auf Integration erstellen.
Geben Sie einen Namen und optional eine Beschreibung für die Integration ein. Geben Sie für diese Kurzanleitung den Namen ForEachSendEmail und die Beschreibung Quickstart main integration ein.
Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus. Erstellen Sie die Hauptintegration in derselben Region wie die Unterintegration.
Klicken Sie auf Erstellen.

API-Trigger in der Hauptintegration hinzufügen

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

Eingabevariable in der Hauptintegration erstellen

In der Hauptintegration werden die Daten in einer Eingabevariable gespeichert, die über die For Every Loop an die Subintegration übergeben werden. Sie können diese Variable jetzt oder im nächsten Schritt erstellen, wenn Sie die Aufgabe „Für jede Schleife“ hinzufügen und konfigurieren. Erstellen Sie die Variable für diese Kurzanleitung jetzt.

Klicken Sie in der Designer-Navigationsleiste auf (Bereich ein-/ausblenden), um den Bereich Variablen aufzurufen.

Führen Sie im Bereich Variable erstellen die folgenden Schritte aus:

a. Name: Geben Sie order_requests ein.

b. Data Type (Datentyp): Wählen Sie JSON aus.

c. Klicken Sie auf Standardwert ableiten.

d. Geben Sie unter Default Value (Standardwert) die folgende JSON-Datei ein:

  [{
    "orderId": "1",
    "customerName": "Harry Ford",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "New York",
      "country": "USA",
      "zipcode": "103487"
    },
    "items": [{
      "itemid": "111-222-333",
      "itemName": "Smartphone",
      "itemPrice": 999.0,
      "quantity": 1.0
    }, {
      "itemid": "444-555-666",
      "itemName": "Mobile Cover",
      "itemPrice": 49.0,
      "quantity": ""
    }],
    "paymentDetails": {
      "mode": "COD",
      "status": ""
    },
   "expectedDelivery": "15 March 2023"
  }, {
    "orderId": "2",
    "customerName": "Tim Harvey",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "Los Angeles",
      "country": "USA",
      "zipcode": "210738"
    },
    "items": [{
      "itemid": "222-333-444",
      "itemName": "Laptop",
      "itemPrice": 5999.0,
      "quantity": 1.0
   }],
    "paymentDetails": {
      "mode": "Online Payment",
      "status": "Success"
    },
    "expectedDelivery": "21 Feb 2023"
  }]

Ersetzen Sie in diesem JSON-Beispielobjekt beide Vorkommen von YOUR_EMAIL_ID durch die E-Mail-ID, mit der Sie die Integration testen möchten.

e. Klicken Sie auf Als Eingabe für die Integration verwenden.

f. Klicken Sie auf Erstellen.

Für jede Schleife eine Aufgabe hinzufügen und konfigurieren

Klicken Sie im Integrationseditor auf Tasks (Aufgaben).
Klicken Sie auf das Element For Every Loop und platzieren Sie es im Integrationseditor.
Klicken Sie im Integrationseditor auf das Aufgabenelement For Every Loop, um den Bereich zur Aufgabenkonfiguration zu öffnen.
Führen Sie im Konfigurationsbereich folgende Schritte aus:
1. Zu iterierende Liste: Wählen Sie die von Ihnen erstellte Eingabevariable order_requests aus.
2. API-Trigger-ID: Wählen Sie den API-Trigger in der Subintegration aus. Wählen Sie für diesen Schnellstart api_trigger/ForEachSendEmailSubIntegration_API_1 aus.
3. Integrationsname: Wählen Sie den Namen der Unterintegration aus, die Sie aufrufen möchten. Wählen Sie für diesen Schnellstart ForEachSendEmailSubIntegration aus.
4. Zuordnung von Iterationselement und Unterintegration: Wählen Sie order_details aus.

Die Elemente in der Hauptintegration verbinden

Fügen Sie dem Element For Every Loop einen Rand vom API-Trigger hinzu. Bewegen Sie den Mauszeiger im Element API-Trigger auf einen Kontrollpunkt. Klicken Sie dann auf eine Linie und ziehen Sie sie auf einen Kontrollpunkt im Element Für jede Schleife.

Hauptintegration testen und veröffentlichen

Die letzte Aufgabe besteht darin, die Hauptintegration zu testen und zu veröffentlichen.

Klicken Sie in der Symbolleiste des Integrations-Editors auf Testen und dann im Dialogfeld Integration testen auf Integration testen. Nach Abschluss des Tests sollten Sie eine Erfolgsmeldung sehen.
Wenn Sie diese Integration veröffentlichen möchten, klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen.

Nach erfolgreicher Ausführung sendet die Integration eine E-Mail an die E-Mail-Adresse, die in der Aufgabe „E-Mail senden“ angegeben wurde. Bestätigen Sie den Erhalt der E-Mail in Ihrem E-Mail-Client.