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

Subintegration mit der Aufgabe „Für jede Schleife“ aufrufen

In dieser Kurzanleitung erfahren Sie, wie Sie eine Integration erstellen, in der eine untergeordnete Integration mithilfe der Aufgabe „Für jede Schleife“ aufgerufen wird. Die Subintegration nimmt die Eingabe der Hauptintegration entgegen und sendet mithilfe der Aufgabe „E-Mail senden“ E-Mails an die Empfänger.

Subintegration erstellen

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

5. 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.
6. Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

API-Trigger in der untergeordneten Integration hinzufügen

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

So fügen Sie den 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.

Eingabevariable in der Subintegration erstellen

Die untergeordnete Integration verwendet eine Variable, um die Details zu speichern, die von der Hauptintegration im JSON-Format empfangen wurden. So erstellen Sie eine neue Eingabevariable:

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

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

   a. Name: Geben Sie order_details ein.

   b. Datentyp: Wählen Sie JSON aus.

   c. Klicken Sie auf Aus dem Standardwert ableiten.

   d. Geben Sie unter 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 Beispiel-JSON-Objekt 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.

Aufgabe „Datenabgleich“ hinzufügen und konfigurieren

Mit der Aufgabe Datenabgleich können Sie Variablenzuweisungen in Ihrer Integration ausführen, Attribute von JSON-Objekten abrufen und festlegen sowie verschachtelte Transformationsfunktionen auf Werte anwenden. Bei Variablen der Aufgabe „Datenabgleich“ kann es sich um Integrations- oder Aufgabenvariablen handeln.

So fügen Sie eine Aufgabe vom Typ „Datenabgleich“ 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. Klicken Sie im Integrationseditor auf das Element Datenabgleich, um den Konfigurationsbereich der Aufgabe zu öffnen.
4. Klicken Sie auf Datenabgleichs-Editor öffnen.
5. 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 Abgleichsfunktion hinzu. Klicken Sie neben order_details.items auf das Symbol +. 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 Abgleichsfunktion hinzu. Klicken Sie in der FOR EACH-Zeile in den Klammern nach dem Element obj1, das Sie gerade hinzugefügt haben, auf +. Scrollen Sie in der Liste der Funktionen nach unten und wählen Sie PROPERTY(String) GETTEN -> JSON aus.
   8. Klicken Sie auf Variable oder Wert und geben Sie in Wert itemName ein.
   9. Klicken Sie auf Speichern.
   10. Klicken Sie in der Zeile nach PROPERTY ABRUFEN 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.
6. Konfigurieren Sie die Ausgabe so:
   1. Erstellen Sie eine neue Ausgabevariable. Klicken Sie im Bereich Ausgabe auf Neu 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.
7. Prüfen Sie, ob Ihre Datenzuordnungskonfiguration dem folgenden Bild ähnelt.

   

8. Schließen Sie den Datenabgleichseditor, um zum Integrationseditor zurückzukehren.

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

So fügen Sie die Aufgabe E-Mail senden hinzu und konfigurieren sie, um eine E-Mail an jeden der Empfänger zu senden:

1. Klicken Sie im Integrationseditor auf Aufgabe/Trigger hinzufügen.
2. Klicken Sie auf Aufgaben und platzieren Sie das Element E-Mail senden im Integrationseditor.
3. Klicken Sie im Integrationseditor auf das Aufgabenelement E-Mail senden, um den Konfigurationsbereich der Aufgabe zu öffnen.

4. 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. Subject (Betreff): Geben Sie den Betreff der E-Mail ein. Geben Sie für diese Kurzanleitung Order delivery notification ein.
   3. Text im Nur-Text-Format: 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$.
   

Elemente in der Subintegration verbinden

Nachdem Sie die erforderlichen Aufgaben und Trigger in der untergeordneten Integration hinzugefügt und konfiguriert haben, fügen Sie eine Verbindung (Edge) zwischen den Elementen hinzu. Ein Edge gibt den Kontrollfluss von einem Element zum nächsten an.

1. Fügen Sie dem Element Datenzuordnung eine Edge-Verbindung aus dem Element API-Trigger hinzu. Bewegen Sie den Mauszeiger auf einen Steuerungspunkt im Element API-Trigger. Klicken Sie dann auf eine Linie und ziehen Sie sie zu einem Steuerungspunkt im Element Datenabgleich.
2. Fügen Sie auf ähnliche Weise eine Kante vom Element Datenabgleich zum Element E-Mail senden hinzu.

Subintegration testen und veröffentlichen

1. Klicken Sie zum Testen dieser Subintegration in der Symbolleiste des Integrationseditors auf Testen und dann im Dialogfeld Integration testen auf Integration testen. Die untergeordnete Integration 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 ist. Nach Abschluss des Tests sollte eine Erfolgsmeldung angezeigt werden.
2. Klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen, um diese Subintegration zu veröffentlichen.

Hauptintegration erstellen

1. Klicken Sie im Navigationsmenü auf Integrationen, um zur Seite Integrationen zurückzukehren.
2. Klicken Sie auf Integration erstellen.
3. 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.
4. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus. Achten Sie darauf, dass Sie die Hauptintegration in derselben Region wie die Subintegration erstellen.
5. Klicken Sie auf Erstellen.

API-Trigger in der Hauptintegration hinzufügen

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

Eingabevariable in der Hauptintegration erstellen

In der Hauptintegration wird eine Eingabevariable verwendet, um die Daten zu speichern, die über die For-Each-Schleife 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 für diese Kurzanleitung die Variable jetzt.

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

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

   a. Name: Geben Sie order_requests ein.

   b. Datentyp: Wählen Sie JSON aus.

   c. Klicken Sie auf Aus dem Standardwert ableiten.

   d. Geben Sie unter 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 Beispiel-JSON-Objekt 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.

Aufgabe „Für jede Schleife“ hinzufügen und konfigurieren

1. Klicken Sie im Integrationseditor auf Aufgaben.
2. Klicken Sie auf das Element Für jede Schleife und platzieren Sie es im Integrationseditor.
3. Klicken Sie im Integrationseditor auf das Aufgabenelement Für jede Schleife, um den Konfigurationsbereich der Aufgabe zu öffnen.
4. Führen Sie im Konfigurationsbereich die folgenden Schritte aus:
   1. Liste zum Iterieren: Wählen Sie die von Ihnen erstellte Eingabevariable order_requests aus.
   2. API-Trigger-ID: Wählen Sie den API-Trigger in Ihrer Sub-Integration aus. Wählen Sie für diese Kurzanleitung api_trigger/ForEachSendEmailSubIntegration_API_1 aus.
   3. Integrationsname: Wählen Sie den Namen der Subintegration aus, die Sie aufrufen möchten. Wählen Sie für diese Kurzanleitung ForEachSendEmailSubIntegration aus.
   4. Subintegrationszuordnung des Iterationselements: Wählen Sie order_details aus.

Elemente in der Hauptintegration verbinden

1. Fügen Sie dem Element Für jede Schleife eine Kante aus dem Element API-Trigger hinzu. Bewegen Sie den Mauszeiger auf einen Steuerungspunkt des Elements API-Trigger. Klicken Sie dann auf eine Zeile und ziehen Sie sie zu einem Steuerungspunkt im Element Für jede Schleife.

Hauptintegration testen und veröffentlichen

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

1. Klicken Sie in der Symbolleiste des Integrationseditors auf Testen und dann im Dialogfeld Integration testen auf Integration testen. Nach Abschluss des Tests sollte eine Erfolgsmeldung angezeigt werden.

2. Klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichen, um diese Integration zu 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.

Kontingente und Limits

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