Attività durante il loop

L'attività Mentre loop consente di effettuare chiamate ripetute a una sottointegrazione da l'integrazione attuale (principale) finché non viene soddisfatta una condizione specificata.

L'ID trigger API e il Nome integrazione identificano la sottointegrazione che vuoi eseguire.

L'attività ti consente anche di raccogliere la risposta da ogni esecuzione di sottointegrazione e di archiviare il valore e l'integrazione attuale per l'uso nelle attività downstream. Per raccogliere le risposte puoi utilizzare uno dei seguenti approcci:

  • Raccogli la risposta a ogni esecuzione in una variabile di array, dove ogni elemento dell'array ha una determinata esecuzione. Per raccogliere le risposte, configura la proprietà Collect values from sub-integration output(s).
  • Aggrega le risposte di tutte le esecuzioni in un'unica variabile. Per aggregare le risposte, configura la proprietà Override values from sub-integration output(s).
di Gemini Advanced.

Prima di iniziare

Proprietà di configurazione

Nella tabella seguente vengono descritte le proprietà di configurazione dell'attività Mentre Loop.

Proprietà Tipo di dati Descrizione
API Trigger ID Stringa ID trigger dell'integrazione secondaria da eseguire.

Questo valore è disponibile nel campo ID trigger del trigger API nell'integrazione secondaria.

Integration name Stringa Nome dell'integrazione secondaria da eseguire.
While loop condition N/D Condizione per terminare il loop. L'integrazione secondaria viene eseguita fino a quando la condizione non viene soddisfatta. Ad esempio, $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s) N/D Valori da passare dall'integrazione attuale all'integrazione secondaria.

I valori di questa proprietà sono sotto forma di coppie chiave/valore, in cui la chiave è una variabile. nell'integrazione corrente e il valore è la variabile di input corrispondente una sottointegrazione. Ad esempio, supponiamo che l'integrazione principale abbia l'elemento productID che vuoi mappare alla variabile subIntProductID variabile di integrazione secondaria; vorresti seleziona productID in Variabile di integrazione da cui eseguire la mappatura a discesa e inserisci subIntProductID nel campo Input d'integrazione secondaria da mappare al campo.

Collect values from sub-integration output(s) N/D Raccogli i risultati delle esecuzioni di sottointegrazione.

Ogni volta che viene eseguita la sottointegrazione, puoi archiviare l'output dell'integrazione secondaria in una variabile array dell'integrazione attuale. Inserisci il la variabile di output della sottointegrazione nell'output dell'integrazione secondaria da raccogliere e seleziona la variabile dell'array nell'integrazione corrente dal Menu a discesa Variabile di integrazione da raccogliere. Ogni elemento dell'array riceve la risposta da un di una specifica esecuzione di sottointegrazione. Ad esempio, se la variabile dell'array è resultsArray, resultsArray[0] ha la risposta della prima esecuzione e resultsArray[1] ha la risposta dalla seconda esecuzione.

Override values from sub-integration output(s) N/D Leggi la variabile di output di un'esecuzione di una sottointegrazione e memorizzala in una variabile dell'integrazione corrente.

Seleziona la variabile di output della sottointegrazione in Output della sottointegrazione da cui eseguire la mappatura e seleziona la variabile corrispondente nell'integrazione corrente dal Menu a discesa Variabile di integrazione da sostituire. Puoi inviare la variabile sottoposta a override nell'integrazione attuale all'esecuzione di sottointegrazione successiva mappando la variabile nella sezione Mappa a una sottointegrazione aggiuntiva input(s). Di conseguenza, puoi aggregare cumulativamente le risposte delle esecuzioni delle sottointegrazioni.

Loop metadata Array JSON La variabile di output con i dettagli di esecuzione della sottointegrazione viene eseguita come ID esecuzione dell'integrazione secondaria, messaggi di errore e valori delle variabili trasmessi durante l'esecuzione. I metadati del loop contengono variabili tra cui le seguenti variabili di output: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element e failure_message.

Best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Durante il loop, vedi Limiti di utilizzo.

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da eseguire se l'attività non riesce a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.