Consulta i connettori supportati per Application Integration.
Attività durante il loop
L'attività Mentre il loop consente di effettuare chiamate ripetute a una sottointegrazione dall'integrazione attuale (principale) fino a quando non viene soddisfatta una condizione specificata.
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à
Override values from sub-integration output(s)
.
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-integrations.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
Nella tabella seguente vengono descritte le proprietà di configurazione dell'attività Mentre 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. |
While loop condition
|
N/A | Condizione per terminare il loop. La sottointegrazione viene eseguita finché la condizione non è soddisfatta. Ad esempio, $loopMetadata.current_iteration_count$< 10 . |
Map to sub-integration input(s)
|
N/A | Valori da passare 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 |
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. Inserisci la variabile di output della sottointegrazione nel campo Output dell'integrazione secondaria da raccogliere e seleziona 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 è |
Override values from sub-integration output(s)
|
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 dell'integrazione secondaria viene eseguita, come l'ID esecuzione dell'integrazione secondaria, i messaggi di errore e i valori della variabile 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 .
|
Best practice
Per informazioni sui limiti di utilizzo che si applicano all'attività Durante il 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.