<ph type="x-smartling-placeholder"></ph> Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

Unterintegration mithilfe einer For-Jede-Schleife-Aufgabe aufrufen

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

Unterintegration erstellen

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Integrationsliste) 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 Unterintegration hinzufügen

Trigger sind erforderlich, um die Abfolge der Aufgaben einer Integration zu starten. 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:

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

Eingabevariable in der Unterintegration erstellen

Die Unterintegration verwendet eine Variable, um die empfangenen Details in JSON zu speichern Format der Hauptintegration. So erstellen Sie eine neue Eingabevariable:

1. Klicken Sie in der Navigationsleiste des Designers auf (Ein-/Aus-Schaltfläche), 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. Data Type: Wählen Sie JSON aus.

   c. Klicken Sie auf Vom Standardwert ableiten.

   d. Geben Sie unter Default Value (Standardwert) den folgenden JSON-Code 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.

Datenabgleichsaufgabe hinzufügen und konfigurieren

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

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

1. Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um die 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 Data Mapping (Datenzuordnung), um den Konfigurationsbereich der Aufgabe zu öffnen.
4. Klicken Sie auf Datenabgleichs-Editor öffnen.
5. Konfigurieren Sie die Eingabe so: <ph type="x-smartling-placeholder">
   </ph>
   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-Datei.
   5. Geben Sie den Funktionseingabeparameter 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 in der für JEDEN Zeile in der Klammer nach dem gerade hinzugefügten obj1-Element auf +. Scrollen Sie in der Liste der Funktionen nach unten und wählen Sie GET PROPERTY(String) -> JSON-Datei.
   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 GET PROPERTY auf + Funktion hinzufügen und wählen Sie TO_STRING() -> String.
   11. Klicken Sie in der letzten Zeile auf + Funktion hinzufügen und wählen Sie TO_STRING() -> String.
6. Konfigurieren Sie die Output (Ausgabe) so: <ph type="x-smartling-placeholder">
   </ph>
   1. Erstellen Sie eine neue Ausgabevariable. Klicken Sie im Abschnitt Output (Ausgabe) auf create a new one (Neue Ausgabe erstellen).
   2. Geben Sie im Bereich Variable erstellen den Namen items ein, behalten Sie die Standardwerte für alle anderen Felder bei und klicken Sie auf Erstellen.
7. Prüfen Sie, ob Ihre Datenzuordnungskonfiguration der folgenden Abbildung ähnelt.

   

8. Schließen Sie den Datenabgleichs-Editor, um zum Integrationseditor zurückzukehren.

Aufgabe zum Senden einer E-Mail hinzufügen und konfigurieren

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

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

4. Legen Sie die folgenden Task Input-Felder fest:

   1. An Empfänger: Klicken Sie auf Variable und wählen Sie order_details.emailId aus.
   2. Betreff: Geben Sie einen Betreff für die E-Mail ein. Geben Sie für diese Kurzanleitung Order delivery notification ein.
   3. Text als 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 Unterintegration verbinden

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

1. Fügen Sie dem Element Datenzuordnung eine Kante vom Element API-Trigger hinzu. Bewegen Sie den Mauszeiger auf einem API-Trigger auf einen Kontrollpunkt. Klicken Sie dann auf eine Linie und ziehen Sie sie zu einem Kontrollpunkt auf dem Element Datenzuordnung.
2. Fügen Sie dem Element E-Mail senden ebenfalls eine Kante aus dem Element Datenzuordnung hinzu.

Untergeordnete Integration testen und veröffentlichen

1. Klicken Sie zum Testen dieser Unterintegration in der Symbolleiste des Integrationseditors auf Test und dann im Dialogfeld Test Integration (Integration testen) auf Test integration (Integration testen). Die Unterintegration wird mit dem Standardwert als Eingabe ausgeführt und sendet eine E-Mail an die in der Aufgabe „E-Mail senden“ angegebene E-Mail-Adresse. Nach Abschluss des Tests sollten Sie eine Erfolgsmeldung sehen.
2. Klicken Sie in der Symbolleiste des Integrationseditors auf Publish (Veröffentlichen), um diese Unterintegration 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 die Hauptintegration in derselben Region wie die Unterintegration erstellt wird.
5. Klicken Sie auf Erstellen.

API-Trigger in der Hauptintegration hinzufügen

1. Klicken Sie im Integrationseditor auf Trigger, um die 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 zum Speichern der Daten verwendet, die über die For-Jede-Schleife an die Unterintegration ü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 jetzt für diese Kurzanleitung.

1. Klicken Sie in der Navigationsleiste des Designers auf (Ein-/Aus-Schaltfläche), 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. Data Type: Wählen Sie JSON aus.

   c. Klicken Sie auf Vom Standardwert ableiten.

   d. Geben Sie unter Default Value (Standardwert) den folgenden JSON-Code 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, die Sie zum Testen der Integration verwenden 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 Tasks (Aufgaben).
2. Klicke im Integrationseditor auf das Element For Every Loop und platziere es.
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: <ph type="x-smartling-placeholder">
   </ph>
   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 Ihrer Unterintegration aus. Wählen Sie für diese Kurzanleitung 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 der Unterintegration des Iterationselements: Wählen Sie order_details aus.

Verbinden Sie die Elemente in der Hauptintegration.

1. Fügen Sie dem Element For Every Loop eine Kante aus dem Element API-Trigger hinzu. Bewegen Sie den Mauszeiger auf einem API-Trigger auf einen Kontrollpunkt. Klicken Sie dann auf eine Linie und ziehen Sie sie zu einem Kontrollpunkt auf dem 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 Test und dann im Dialogfeld Test Integration (Integration testen) auf Test integration (Integration testen). Nach Abschluss des Tests sollten Sie eine Erfolgsmeldung sehen.

2. Klicken Sie in der Symbolleiste des Integrationseditors auf Publish (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

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