Consulta i connettori supportati per Application Integration.

Attività per ogni loop

L'attività Per ogni loop consente di effettuare chiamate ripetute a una sottointegrazione da l'integrazione attuale (principale). L'attività esegue l'iterazione della variabile dell'array configurata e richiama la sottointegrazione per ogni elemento dell'array. Il numero di volte in cui viene chiamata la sottointegrazione è uguale alle dimensioni della variabile array.

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).
• Aggregare le risposte di tutte le esecuzioni in un'unica variabile. Per aggregare le risposte, configura la proprietà Response parameter override mapping.

Nota:

• Un'attività Per ogni loop può eseguire un massimo di 8000 iterazioni.
• La dimensione cumulativa dei dati raccolti da ogni esecuzione di sottointegrazione non può superare 50 MB. Se la dimensione supera 50 MB, l'integrazione non riesce e le attività downstream non vengono eseguite.
• Se un'integrazione nell'attività Per ogni loop non va a buon fine, l'intera attività non riesce e le attività downstream non vengono eseguite. Per evitare il fallimento dell'intera integrazione, puoi specificare una strategia di esecuzione per l'attività nel relativo riquadro di configurazione join. Per maggiori dettagli, consulta la sezione Partecipare.

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 impostazione predefinita viene utilizzato l'account di servizio predefinito ([e-mail]) per l'autenticazione.
• Assicurati che il tuo account di servizio abbia il ruolo IAM Application Integration Invoker. 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à Per ogni ciclo.

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 della sottointegrazione da eseguire.
List to iterate	Un array di tipo Boolean, String, Integer, Double o JSON.	Elenco di valori per i quali deve essere eseguita l'integrazione secondaria. La l'integrazione secondaria viene eseguita per ogni valore nell'elenco, uno dopo l'altro. Puoi passare il valore iterato alla sottointegrazione impostando la proprietà Mappatura della sottointegrazione dell'elemento di iterazione. In questa proprietà, specifica la variabile nella sottointegrazione a cui deve essere mappato il valore iterato.
Iteration element sub-integration mapping	N/D	Variabile nella sottointegrazione a cui deve essere assegnato l'elemento iterato corrente.
Map to additional sub-integration input(s)	N/D	Valori aggiuntivi da passare dall'integrazione corrente alla sottointegrazione. 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 la tua integrazione principale abbia la variabile productID, che vuoi mappare alla variabile di sottointegrazione subIntProductID. Dovresti selezionare productID dal menu a discesa Variabile di integrazione da cui eseguire la mappatura e subIntProductID nel menu a discesa Input di sottointegrazione.
Collect values from sub-integration output(s)	N/D	Raccogli i risultati delle esecuzioni di sottointegrazione. Ogni volta che viene eseguita la sottointegrazione, puoi memorizzare l'output della sottointegrazione in una variabile array dell'integrazione corrente. Seleziona la variabile di output della sottointegrazione dal menu a discesa Output della sottointegrazione da cui raccogliere e la variabile array nell'integrazione corrente dal menu a discesa Variabile di integrazione in cui raccogliere. Ogni elemento dell'array contiene la risposta di una determinata esecuzione della 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.
Response parameter override mapping	N/D	Leggi la variabile di output di un'esecuzione di una sottointegrazione e memorizzala in una variabile di l'integrazione attuale. Seleziona la variabile di output della sottointegrazione dal menu a discesa Output della sottointegrazione da cui eseguire la mappatura e 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 in modo cumulativo le risposte delle esecuzioni delle sottointegrazioni.
Loop metadata	Array JSON	La variabile di output con i dettagli di esecuzione delle sottointegrazioni, come quelle ID esecuzione, 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. Avviso: nei metadati di 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 del trattino basso (_) perché le altre chiavi verranno ritirate.

Best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Per ogni loop, consulta 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 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.