Aufgabe „Für jede Schleife“

Mitteilung: Application Integration ist jetzt für Ihr Google Cloud-Projekt verfügbar. Sie können jetzt Apigee Integration und Application Integration im selben Google Cloud-Projekt verwenden. Weitere Informationen

Mit der Aufgabe Für jede Schleife können Sie wiederkehrende Aufrufe einer Subintegration von Ihrer Hauptintegration ausführen. Die Aufgabe durchläuft die konfigurierte Arrayvariable und ruft die Subintegration für jedes Element im Array auf. Die Häufigkeit, mit der die Subintegration aufgerufen wird, entspricht der Größe der Arrayvariable.

Die API-Trigger-ID und der Integrationsname identifizieren die Subintegration, die Sie ausführen möchten.

Mit der Aufgabe können Sie auch die Antwort von jeder Subintegrationsausführung erfassen und den Wert in Ihrer aktuellen Integration zur Verwendung in nachgelagerten Aufgaben speichern. Sie können die folgenden Methoden verwenden, um die Antworten zu erfassen:

• Erfasst die Antwort jeder Ausführung in einer Arrayvariable, wobei jedes Element des Arrays die Antwort aus einer bestimmten Ausführung enthält. Konfigurieren Sie das Attribut Collect values from sub-integration output(s), um die Antworten zu erfassen.
• Fassen Sie die Antworten aller Ausführungen in einer einzigen Variablen zusammen. Konfigurieren Sie das Attribut Response parameter override mapping, um die Antworten zusammenzufassen.

Hinweis:

• Eine Aufgabe Für jede Schleife kann maximal 8.000 Iterationen ausführen.
• Die kumulative Größe der Daten, die bei jeder Ausführung einer Subintegration erfasst wurden, darf 50 MB nicht überschreiten. Wenn die Größe 50 MB überschreitet, schlägt die Integration fehl und die nachgelagerten Aufgaben werden nicht ausgeführt.
• Wenn eine Integration in der Aufgabe For jeden Loop fehlschlägt, schlägt die gesamte Aufgabe fehl und die nachgelagerten Aufgaben werden nicht ausgeführt. Damit nicht die gesamte Integration fehlschlägt, können Sie im Bereich "Join-Konfiguration" eine Ausführungsstrategie für die Aufgabe angeben. Weitere Informationen finden Sie unter Join.

Hinweise

• Prüfen Sie, ob Sie ein nutzerverwaltetes Dienstkonto an Ihre Integration angehängt haben. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto ([e-mail]) zur Authentifizierung verwendet.
• Prüfen Sie, ob Ihr Dienstkonto die IAM-Rolle Aufrufer von Anwendungsintegrationen hat. Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Konfigurationsattribute

In der folgenden Tabelle werden die Konfigurationsattribute der Aufgabe Für jede Schleife beschrieben.

Attribut	Datentyp	Beschreibung
API Trigger ID	String	Trigger-ID der auszuführenden Subintegration. Dieser Wert ist im Feld Trigger-ID des API-Triggers in der Subintegration verfügbar.
Integration name	String	Name der auszuführenden Subintegration.
List to iterate	Ein Array vom Typ String, Integer, Double oder JSON.	Liste der Werte, für die die Subintegration ausgeführt werden soll. Die Subintegration wird für jeden Wert in der Liste nacheinander ausgeführt. Sie können den iterierten Wert an die Subintegration übergeben, indem Sie das Attribut Iterationselement-Subintegrationszuordnung festlegen. Geben Sie in diesem Attribut die Variable in der Subintegration an, der der iterierte Wert zugeordnet werden muss.
Iteration element sub-integration mapping	–	Variable in der Subintegration, für die das aktuelle iterierte Element zugewiesen werden muss.
Map to additional sub-integration input(s)	–	Zusätzliche Werte, die von der aktuellen Integration an die Subintegration übergeben werden sollen. Die Werte dieses Attributs haben die Form von Schlüssel/Wert-Paaren, wobei der Schlüssel eine Variable in der aktuellen Integration und der Wert die entsprechende Eingabevariable in der Subintegration ist. Angenommen, Ihre Hauptintegration hat die Variable productID, die Sie der Subintegrationsvariablen subIntProductID zuordnen möchten. In diesem Fall würden Sie productID aus dem Drop-down-Menü Integrationsvariable, von der zugeordnet werden soll und subIntProductID im Drop-down-Menü Subintegrationseingabe, in die zugeordnet werden soll auswählen.
Collect values from sub-integration output(s)	–	Erfasst die Ergebnisse der Subintegrationsausführungen. Jedes Mal, wenn die Subintegration ausgeführt wird, können Sie die Ausgabe der Subintegration in einer Arrayvariable der aktuellen Integration speichern. Wählen Sie die Ausgabevariable der Subintegration aus dem Drop-down-Menü Subintegrationsausgabe, aus der erfasst werden soll und die Arrayvariable in der aktuellen Integration aus dem Drop-down-Menü Integrationsvariable, in die erfasst werden soll aus. Jedes Element des Arrays hat die Antwort einer bestimmten Subintegrationsausführung. Wenn die Arrayvariable beispielsweise resultsArray ist, hat resultsArray[0] die Antwort aus der ersten Ausführung und resultsArray[1] die Antwort aus der zweiten Ausführung.
Response parameter override mapping	–	Die Ausgabevariable einer Subintegrationsausführung lesen und in einer Variable der aktuellen Integration speichern. Wählen Sie die Ausgabevariable der Subintegration aus dem Drop-down-Menü Subintegrationsausgabe, von der zugeordnet werden soll und dann die entsprechende Variable in der aktuellen Integration aus dem Drop-down-Menü Integrationsvariablen, die überschrieben werden soll aus. Sie können die überschriebene Variable in der aktuellen Integration an die nächste Ausführung der Subintegration senden, indem Sie die Variable im Attribut Weiteren Subintegrationseingaben zuordnen zuordnen. Dadurch können Sie die Antworten der Subintegrationsausführungen kumulativ zusammenfassen.
Loop metadata	JSON-Array	Die Ausgabevariable mit den Ausführungsdetails der Subintegration wie die Ausführungs-ID der Subintegration, Fehlermeldungen und Variablenwerten, die während der Ausführung übergeben werden. Schleifenmetadaten enthalten Variablen, einschließlich der folgenden Ausgabevariablen: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element und failure_message. Warnung: In den Schleifenmetadaten finden Sie doppelte Schlüssel für die Ausgabevariable, z. B. Current Iteration Count und current_iteration_count. Wir empfehlen die Verwendung der Variablen mit dem Unterstrich (_), da die anderen Schlüssel verworfen werden.

Best Practices

Informationen zu den Nutzungslimits für die Aufgabe Für jede Schleife finden Sie unter Nutzungslimits.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.