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à For Every Loop ti consente di effettuare chiamate ripetute a una integrazione secondaria dall'integrazione attuale (principale). L'attività esegue l'iterazione della variabile dell'array configurata e chiama l'integrazione secondaria per ogni elemento dell'array. Il numero di volte in cui viene chiamata l'integrazione secondaria equivale alla dimensione della variabile dell'array.

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à 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 integrazione secondaria 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à For every Loop non va a buon fine, l'intera attività non va a buon fine e le attività downstream non vengono eseguite. Per evitare errori dell'intera integrazione, puoi specificare una strategia di esecuzione per l'attività nel riquadro di configurazione di join. Consulta la pagina Partecipa per maggiori dettagli.

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à Per ogni 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.
List to iterate	Un array di tipo booleano, stringa, numero intero, doppio o JSON.	Elenco dei valori per cui deve essere eseguita l'integrazione secondaria. L'integrazione secondaria 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/D	Variabile nell'integrazione secondaria per la quale deve essere assegnato l'elemento iterato corrente.
Map to additional sub-integration input(s)	N/D	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 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 seleziona subIntProductID nel menu a discesa Input della sottointegrazione 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. Seleziona la variabile di output dell'integrazione secondaria dal menu a discesa Output subintegrazione da raccogliere e la variabile 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.
Response parameter override mapping	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 contenente i dettagli dell'esecuzione delle integrazioni secondarie, come l'ID esecuzione dell'integrazione secondaria, i messaggi di errore e i valori della variabile trasmessi durante l'esecuzione.

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 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.