Attività durante il loop

L'attività Ciclo While ti consente di effettuare chiamate ripetute a una sotto-integrazione dall'integrazione corrente (principale) finché non viene soddisfatta una condizione specificata.

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

L'attività ti consente anche di raccogliere la risposta di ogni esecuzione della sotto-integrazione e di memorizzare il valore nell'integrazione corrente per l'utilizzo nelle attività downstream. Puoi utilizzare uno dei seguenti approcci per raccogliere le risposte:

• Raccogli la risposta di ogni esecuzione in una variabile array, in cui ogni elemento dell'array contiene la risposta di una particolare esecuzione. Per raccogliere le risposte, configura la proprietà Collect values from sub-integration output(s).
• Aggrega le risposte di tutte le corse in un'unica variabile. Per aggregare le risposte, configura la proprietà Override values from sub-integration output(s).

Nota:

• L'attività Ciclo While può essere eseguita un massimo di 8000 volte. Questo vincolo è valido anche se la condizione configurata genera un loop infinito.
• Le dimensioni cumulative dei dati raccolti da ogni esecuzione della sotto-integrazione non possono superare 50 MB. Se le dimensioni superano 50 MB, l'integrazione non riesce e le attività downstream non vengono eseguite.

Prima di iniziare

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

Proprietà di configurazione

La tabella seguente descrive le proprietà di configurazione dell'attività Ciclo while.

Proprietà	Tipo di dati	Descrizione
API Trigger ID	Stringa	L'ID trigger della sotto-integrazione da eseguire. Questo valore è disponibile nel campo ID trigger del trigger API nella sub-integrazione.
Integration name	Stringa	Il nome dell'integrazione secondaria da eseguire.
While loop condition	N/D	Condizione per terminare il ciclo. La sotto-integrazione 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 corrente alla sotto-integrazione. 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 nell'integrazione secondaria. Ad esempio, supponiamo che l'integrazione principale abbia la variabile productID che vuoi mappare alla variabile subIntProductID dell'integrazione secondaria. In questo caso, seleziona productID dal menu a discesa Variabile di integrazione da mappare e inserisci subIntProductID nel campo Input integrazione secondaria a cui mappare.
Collect values from sub-integration output(s)	N/D	Raccogli i risultati delle esecuzioni delle integrazioni secondarie. Ogni volta che viene eseguita l'integrazione secondaria, puoi archiviare l'output dell'integrazione secondaria in una variabile array dell'integrazione corrente. Inserisci la variabile di output dell'integrazione secondaria nel campo Output dell'integrazione secondaria da raccogliere e seleziona la variabile array nell'integrazione corrente dal menu a discesa Variabile di integrazione in cui raccogliere i dati. Ogni elemento dell'array contiene la risposta di una particolare esecuzione della sotto-integrazione. Ad esempio, se la variabile array è resultsArray, resultsArray[0] ha la risposta della prima esecuzione e resultsArray[1] ha la risposta della seconda esecuzione.
Override values from sub-integration output(s)	N/D	Leggi la variabile di output di un'esecuzione di un'integrazione secondaria e memorizzala in una variabile dell'integrazione corrente. Seleziona la variabile di output dell'integrazione secondaria dal menu a discesa Output dell'integrazione secondaria da mappare 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 corrente alla successiva esecuzione della sotto-integrazione mappando la variabile nella proprietà Mappa a sotto-integrazione aggiuntiva input. Di conseguenza, puoi aggregare cumulativamente le risposte delle esecuzioni dell'integrazione secondaria.
Loop metadata	Array JSON	La variabile di output che contiene i dettagli di esecuzione delle esecuzioni della sotto-integrazione, ad esempio l'ID di esecuzione della sotto-integrazione, i messaggi di errore e i valori delle variabili passati durante l'esecuzione. I metadati del ciclo 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 ciclo 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 del trattino basso (_) perché le altre chiavi verranno ritirate.

Best practice

Per informazioni sui limiti di utilizzo applicati all'attività Ciclo while, 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 sui diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi

• Scopri di più su tutte le attività e gli attivatori.
• Scopri come testare e pubblicare un'integrazione.
• Scopri di più sulla gestione degli errori.
• Scopri di più sui log di esecuzione dell'integrazione.