Consulta i connettori supportati per Application Integration.

Attività durante il loop

L'attività Durante il loop ti consente di effettuare chiamate ripetute a una sottointegrazione dall'integrazione attuale (principale) fino a quando non viene soddisfatta una condizione specificata.

L'ID trigger API e il Nome integrazione identificano l'integrazione secondaria che vuoi eseguire.

L'attività consente inoltre di raccogliere la risposta da ogni esecuzione di integrazione secondaria e archiviare il valore nell'integrazione attuale per utilizzarlo nelle attività downstream. Per raccogliere le risposte puoi utilizzare uno dei seguenti approcci:

• Raccogli la risposta di ogni esecuzione in una variabile dell'array, in cui ogni elemento dell'array ha la risposta da 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).

Nota:

• L'attività Mentre Loop può eseguire un massimo di 8000 iterazioni. Questo vincolo è valido anche se la condizione configurata genera un loop infinito.
• La dimensione cumulativa dei dati raccolti da ogni esecuzione di integrazione secondaria non può superare 50 MB. Se la dimensione supera 50 MB, l'integrazione non riesce e le attività downstream non vengono eseguite.

Prima di iniziare

• Assicurati di aver collegato un account di servizio gestito dall'utente all'integrazione. Se per l'integrazione non è configurato un account di servizio gestito dall'utente, per l'autenticazione viene utilizzato per impostazione predefinita l'account di servizio predefinito ([e-mail]).
• Assicurati che il tuo account di servizio disponga del ruolo IAM Invoker di integrazione di applicazioni. Per informazioni sulla concessione dei ruoli a un account di servizio, vedi Gestire l'accesso agli account di servizio.

Proprietà di configurazione

La tabella seguente descrive le proprietà di configurazione dell'attività Durante il loop.

Proprietà	Tipo di dati	Description
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 finché 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 nella sottointegrazione. Ad esempio, supponi che l'integrazione principale abbia la variabile productID, che vuoi mappare alla variabile di integrazione secondaria subIntProductID. Seleziona productID dal menu a discesa Variabile di integrazione da mappare e inserisci subIntProductID nel campo Input dell'integrazione secondaria da mappare.
Collect values from sub-integration output(s)	N/D	Raccogli i risultati delle esecuzioni dell'integrazione secondaria. Ogni volta che viene eseguita l'integrazione secondaria, puoi archiviare l'output dell'integrazione secondaria in una variabile array dell'integrazione attuale. Inserisci la variabile di output dell'integrazione secondaria nel campo Output dell'integrazione secondaria da raccogliere e seleziona la variabile dell'array nell'integrazione attuale dal menu a discesa Variabile di integrazione da raccogliere. Ogni elemento dell'array ha la risposta a una particolare esecuzione di integrazione secondaria. Ad esempio, se la variabile dell'array è resultsArray, resultsArray[0] ha la risposta della prima esecuzione, mentre resultsArray[1] ha la risposta della seconda esecuzione.
Override values from sub-integration output(s)	N/D	Legge la variabile di output di un'esecuzione di integrazione secondaria e archiviala in una variabile dell'integrazione attuale. Seleziona la variabile di output dell'integrazione secondaria dall'elenco a discesa Output dell'integrazione secondaria da mappare e seleziona la variabile corrispondente nell'integrazione attuale dal menu a discesa Variabile di integrazione da sostituire. Puoi inviare la variabile sottoposta a override nell'integrazione attuale all'integrazione secondaria successiva eseguita mappando la variabile nella proprietà Mappa a input di integrazione secondaria aggiuntivi. Di conseguenza, puoi aggregare in modo cumulativo le risposte delle esecuzioni dell'integrazione secondaria.
Loop metadata	Array JSON	La variabile di output con i dettagli dell'esecuzione dell'integrazione secondaria viene eseguita, ad esempio l'ID esecuzione dell'integrazione secondaria, i messaggi di errore e i valori della variabile 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. Avviso: nei metadati del loop troverai chiavi duplicate per la variabile di output, ad esempio Current Iteration Count e current_iteration_count. Ti consigliamo di utilizzare le variabili che contengono il simbolo di trattino basso (_) perché le altre chiavi sono in fase di ritiro.

best practice

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

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere 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.