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

Aufgabe „Während Schleife“

Mit der Aufgabe Während Schleife können Sie wiederholte Aufrufe an eine Subintegration von Ihrer aktuellen Hauptintegration ausführen, bis eine angegebene Bedingung erfüllt ist.

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 Override values from sub-integration output(s), um die Antworten zusammenzufassen.

Hinweise

  • Achten Sie darauf, dass Sie Ihrer Integration ein vom Nutzer verwaltetes Dienstkonto angehängt haben. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) zur Authentifizierung verwendet.
  • Achten Sie darauf, dass Ihr Dienstkonto die IAM-Rolle Application Integration Invoker 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 Während 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.
While loop condition – Bedingung zum Beenden der Schleife. Die Subintegration wird ausgeführt, bis die Bedingung erfüllt ist. Beispiel: $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s) – 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 Subintegrationsvariable subIntProductID zuordnen möchten. Wählen Sie im Drop-down-Menü Integrationsvariable, aus der zugeordnet werden soll productID aus und geben Sie subIntProductID in das Feld Subintegrationseingabe, in die zugeordnet werden soll ein.

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. Geben Sie die Ausgabevariable der Subintegration in das Feld Subintegrationsausgabe, aus der erfasst werden soll ein und wählen Sie 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.

Override values from sub-integration output(s) – 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. Die Metadaten der Schleife enthalten Variablen, darunter die folgenden Ausgabevariablen: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element und failure_message.

Best Practices

Informationen zu den Nutzungslimits für die Aufgabe Während 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.

Kontingente und Limits

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

Nächste Schritte