Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

Unterintegration mithilfe einer For-Jede Schleifen-Aufgabe aufrufen

In dieser Kurzanleitung erfahren Sie, wie Sie eine Integration erstellen, in der eine Subintegration mithilfe der Aufgabe „Für jede Schleife“ aufgerufen wird. Die Unterintegration übernimmt die Eingabe aus der Hauptintegration und sendet E-Mails mithilfe der Aufgabe E-Mail senden 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 Integrations (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.
  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 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 Datenzuordnungsaufgabe können Sie Variablenzuweisungen in Ihrer Integration vornehmen, Attribute von JSON-Objekten abrufen und festlegen und 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 Data Mapping (Datenzuordnung), 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 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 den Klammern nach dem gerade hinzugefügten obj1-Element 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 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 aus.
  6. Konfigurieren Sie die Ausgabe so:
    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 dem folgenden Bild ähnelt.

    Abbildung: Konfiguration des Datenabgleichs-Editors

  8. Schließen Sie den Datenabgleichseditor, 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 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 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 die erforderlichen Aufgaben und Trigger in der untergeordneten Integration 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 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.

Untergeordnete Integration testen und veröffentlichen

  1. Wenn Sie diese Subintegration testen möchten, klicken Sie 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 in der Aufgabe „E-Mail senden“ angegebene E-Mail-Adresse. Nach Abschluss des Tests sollte eine Erfolgsmeldung angezeigt werden.
  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. Datentyp: 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 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. Klicke auf das Element For Every Loop und platziere 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. 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 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 For Every Loop 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 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 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.