Attività per ogni loop

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

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

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

L'attività consente anche 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 a ogni esecuzione in una variabile di array, in cui ogni elemento dell'array ha 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 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 di join. Per maggiori dettagli, vedi Partecipa.

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 l'account di servizio abbia il 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à Per ogni loop.

Proprietà	Tipo di dati	Descrizione
API Trigger ID	String	ID trigger dell'integrazione secondaria da eseguire. Questo valore è disponibile nel campo ID trigger del trigger API nell'integrazione secondaria.
Integration name	String	Nome dell'integrazione secondaria da eseguire.
List to iterate	Un array di tipo booleano, stringa, intero, doppio o JSON.	Elenco di valori per i quali deve essere eseguita l'integrazione secondaria. La sottointegrazione viene eseguita per ogni valore nell'elenco, uno dopo l'altro. Puoi passare il valore iterato all'integrazione secondaria impostando la proprietà mappatura dell'integrazione secondaria degli elementi di iterazione. In questa proprietà, specifica la variabile nell'integrazione secondaria a cui deve essere mappato il valore iterato.
Iteration element sub-integration mapping	N/A	Variabile nella sottointegrazione a cui deve essere assegnato l'elemento iterato corrente.
Map to additional sub-integration input(s)	N/A	Valori aggiuntivi da trasferire 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 attuale 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 da mappare.
Collect values from sub-integration output(s)	N/A	Raccogli i risultati delle esecuzioni di sottointegrazione. Ogni volta che viene eseguita l'integrazione secondaria, puoi archiviare il relativo output in una variabile array dell'integrazione attuale. Seleziona la variabile di output della sottointegrazione dall'elenco a discesa Output dell'integrazione secondaria da raccogliere e la variabile dell'array nell'integrazione attuale dal menu a discesa Variabile di integrazione da raccogliere. Ogni elemento dell'array ha la risposta di una particolare 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 della seconda esecuzione.
Response parameter override mapping	N/A	Leggi la variabile di output di un'esecuzione di sottointegrazione e archiviala in una variabile dell'integrazione attuale. 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 attuale dal menu a discesa Variabile di integrazione da sostituire. Puoi inviare la variabile sottoposta a override nell'integrazione attuale alla successiva esecuzione di integrazione secondaria mappando la variabile nella proprietà Mappa a input di integrazione secondaria aggiuntivi. Di conseguenza, è possibile aggregare in modo cumulativo le risposte delle esecuzioni di sottointegrazione.
Loop metadata	Array JSON	La variabile di output con i dettagli dell'esecuzione delle integrazioni secondarie, come l'ID esecuzione dell'integrazione secondaria, i messaggi di errore e i valori delle variabili passati 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 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 trattino basso (_) perché le altre chiavi stanno per essere deprecate.

Best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Per ogni 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 l'articolo sulle strategie di gestione degli errori.