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 la sottointegrazione chiamata è uguale alla dimensione della variabile di 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). - Aggrega le risposte di tutte le esecuzioni in un'unica variabile. Per aggregare le risposte, configura
la proprietà
Response parameter override mapping.
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 (
service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) 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
|
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, intero, doppio 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 ripetuto all'integrazione secondaria impostando il valore Proprietà di mappatura dell'integrazione secondaria degli elementi 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 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
una sottointegrazione. Ad esempio, supponiamo che
la tua integrazione principale ha la variabile |
Collect values from sub-integration output(s)
|
N/D | Raccogli i risultati delle esecuzioni di sottointegrazione.
Ogni volta che viene eseguita la sottointegrazione,
puoi archiviare l'output dell'integrazione secondaria in una variabile array dell'integrazione attuale.
Seleziona la variabile di output della sottointegrazione in Output dell'integrazione secondaria da raccogliere
e la variabile dell'array nell'integrazione corrente dal
Menu a discesa Variabile di integrazione da raccogliere. Ogni elemento dell'array riceve la risposta da un
di una specifica esecuzione di sottointegrazione. Ad esempio, se la variabile dell'array è |
Response parameter override mapping
|
N/D | Leggi la variabile di output di un'esecuzione di sottointegrazione e memorizzala in una variabile di
l'integrazione attuale.
Seleziona la variabile di output della sottointegrazione in Output della sottointegrazione da cui eseguire la mappatura 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 attuale all'esecuzione di sottointegrazione successiva mappando la variabile nella sezione Mappa a una sottointegrazione aggiuntiva input(s). Di conseguenza, puoi aggregare cumulativamente 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.
|
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 Strategie di gestione degli errori.