Consulta i connettori supportati per Application Integration.

Attività per ogni loop

L'attività Per ogni loop consente di effettuare chiamate ripetute a una sub-integrazione dall'integrazione corrente (principale). L'attività esegue l'iterazione sulla variabile array configurata e chiama l'integrazione secondaria per ogni elemento dell'array. Il numero di volte in cui viene chiamata la sotto-integrazione è uguale alla dimensione della variabile array.

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

L'attività ti consente anche di raccogliere la risposta di ogni esecuzione della sub-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à Response parameter override mapping.

Nota:

• Un'attività Per ogni loop può eseguire un massimo di 8000 iterazioni.
• 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.
• Se un'integrazione nell'attività Per ogni loop non riesce, l'intera attività non riesce e le attività downstream non vengono eseguite. Per evitare l'errore dell'intera integrazione, puoi specificare una strategia di esecuzione per l'attività nel relativo riquadro di configurazione dell'unione. Per saperne di più, consulta la sezione Partecipare.

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 impostazione predefinita viene utilizzato l'service account predefinito ([e-mail]) per l'autenticazione.
• Assicurati che il account di servizio disponga del ruolo IAM Application Integration Invoker. Per informazioni sulla concessione dei 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 For Each.

Proprietà	Tipo di dati	Descrizione
API Trigger ID	Stringa	L'ID attivatore dell'integrazione secondaria 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.
List to iterate	Un array di tipo booleano, stringa, intero, doppio o JSON.	Elenco dei valori per cui deve essere eseguita la sotto-integrazione. La sub-integrazione viene eseguita per ogni valore dell'elenco, uno dopo l'altro. Puoi passare il valore iterato alla sotto-integrazione impostando la proprietà Mappatura della sotto-integrazione dell'elemento di iterazione. In questa proprietà, specifica la variabile nella sotto-integrazione a cui deve essere mappato il valore iterato.
Iteration element sub-integration mapping	N/D	Variabile nella sotto-integrazione a cui deve essere assegnato l'elemento iterato corrente.
Map to additional sub-integration input(s)	N/D	Valori aggiuntivi da trasferire dall'integrazione corrente 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 nell'integrazione secondaria. Ad esempio, supponiamo 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 seleziona subIntProductID nel menu a discesa Input di 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. Seleziona la variabile di output della sotto-integrazione dal menu a discesa Output della sotto-integrazione da raccogliere e 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 dell'integrazione secondaria. Ad esempio, se la variabile array è resultsArray, resultsArray[0] ha la risposta della prima esecuzione e resultsArray[1] ha la risposta della seconda esecuzione.
Response parameter override mapping	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 della sotto-integrazione dal menu a discesa Output della sotto-integrazione 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 integrazioni secondarie, ad esempio l'ID di esecuzione dell'integrazione secondaria, 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.

Esempi

Le sezioni seguenti forniscono esempi dettagliati di come configurare e utilizzare l'attività Ciclo For Each per scenari specifici. Questi esempi illustrano i passaggi di configurazione per diversi casi d'uso:

• Iterare e passare ogni elemento
• Raccogliere gli output delle sottointegrazioni
• Aggrega i risultati con l'override della risposta
• Trasmettere input aggiuntivi

Itera e passa ogni elemento

Supponiamo di avere un'integrazione principale con una variabile array denominata productIds contenente valori come ["P1", "P2", "P3"]. Per chiamare una sotto-integrazione denominata GetProductDetails per ogni ID prodotto, configura l'attività Per ogni loop nel seguente modo:

• Imposta List to iterate (Elenco su cui eseguire l'iterazione) su productIds.
• Imposta Mappatura della sotto-integrazione dell'elemento di iterazione per mappare l'elemento corrente di productIds a una variabile in GetProductDetails, ad esempio subIntProductId.

Ogni esecuzione di GetProductDetails riceve quindi un ID prodotto da productIds.

Raccogliere gli output delle integrazioni secondarie

Come nell'esempio precedente, supponiamo che GetProductDetails restituisca un oggetto JSON in una variabile di output denominata productInfo.

Per raccogliere tutti gli output productInfo di ogni esecuzione della sotto-integrazione e memorizzarli come elementi in una variabile di array all'interno dell'integrazione principale:

• Configura Raccogli valori dagli output delle integrazioni secondarie.
• Seleziona productInfo da Output dell'integrazione secondaria da cui raccogliere i dati.
• Seleziona una variabile array nell'integrazione principale, ad esempio allProductDetails, da Variabile di integrazione da raccogliere in.

Al termine del ciclo, allProductDetails è un array in cui ogni elemento è il JSON productInfo di una esecuzione della sotto-integrazione.

Aggrega i risultati con l'override della risposta

Supponiamo di avere un'integrazione principale che chiama un'integrazione secondaria (ad esempio GetProductDetails) per ogni elemento di un elenco e di voler calcolare il prezzo totale di tutti gli elementi. Per sommare un valore numerico restituito da ogni esecuzione della sotto-integrazione:

• Assicurati che la sotto-integrazione restituisca un valore in una variabile di output itemPrice.
• Inizializza la variabile totalPrice a 0 nell'integrazione principale.
• Configura la mappatura dell'override dei parametri di risposta:
  • Mappa itemPrice (dall'integrazione secondaria) a totalPrice (nell'integrazione principale).
• Nella sezione Mappa a input di integrazione secondaria aggiuntivi:
  • Mappa totalPrice (dall'integrazione principale) a una variabile di input nell'integrazione secondaria, ad esempio currentTotal.
• Nella logica dell'integrazione secondaria, aggiungi il prezzo dell'articolo corrente a currentTotal ricevuto dall'integrazione principale. Quindi, restituisci questa nuova somma nella variabile di output denominata itemPrice. Questo processo crea un'aggregazione cumulativa.

Passare input aggiuntivi

Se la tua integrazione secondaria GetProductDetails richiede un codice currency dall'integrazione principale:

• Nella sezione Mappa a input di integrazione secondaria aggiuntivi:
  • Mappa la variabile di integrazione principale currencyCode alla variabile di input dell'integrazione secondaria subIntCurrency.
• Questo currencyCode viene passato a ogni esecuzione della sotto-integrazione.

Esplora i seguenti esempi di integrazione per guide pratiche passo passo ed esempi eseguibili dei concetti trattati nelle sezioni precedenti:

• Richiamare una sub-integrazione utilizzando un'attività per ogni loop
• Integrazione di esempio dell'e-commerce

Best practice

Per informazioni sui limiti di utilizzo applicati 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 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.