Attività durante il loop

L'attività Mentre loop consente di effettuare chiamate ripetute a una sottointegrazione da l'integrazione attuale (principale) finché non viene soddisfatta una condizione specificata.

L'ID trigger API e il nome dell'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).
Aggregare 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 il tuo account di servizio abbia il ruolo IAM Application Integration Invoker. Per informazioni sulla concessione di 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`	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 della sottointegrazione da eseguire.
`While loop condition`	N/D	Condizione per terminare il loop. L'integrazione secondaria viene eseguita fino a quando la condizione non viene soddisfatta. Ad esempio, `$loopMetadata.current_iteration_count$< 10`.
`Map to sub-integration input(s)`	N/D	Valori da passare dall'integrazione corrente alla sottointegrazione. 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, supponiamo che l'integrazione principale abbia l'elemento `productID` che vuoi mappare alla variabile `subIntProductID` variabile di integrazione secondaria; vorresti seleziona `productID` in Variabile di integrazione da cui eseguire la mappatura a discesa e inserisci `subIntProductID` nel campo Input d'integrazione secondaria da mappare.
`Collect values from sub-integration output(s)`	N/D	Riunisci i risultati delle esecuzioni delle sottointegrazioni. Ogni volta che viene eseguita la sottointegrazione, puoi archiviare l'output dell'integrazione secondaria in una variabile array dell'integrazione attuale. Inserisci la variabile di output della sottointegrazione nel campo Output della sottointegrazione da cui raccogliere e seleziona la variabile array nell'integrazione corrente dal menu a discesa Variabile di integrazione in cui raccogliere. Ogni elemento dell'array contiene la risposta di una determinata esecuzione della sottointegrazione. Ad esempio, se la variabile array è `resultsArray`, `resultsArray[0]` contiene la risposta della prima esecuzione e `resultsArray[1]` contiene la risposta della seconda esecuzione.
`Override values from sub-integration output(s)`	N/D	Leggi la variabile di output di un'esecuzione di una sottointegrazione e memorizzala in una variabile dell'integrazione corrente. 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 sostituita nell'integrazione corrente all'esecuzione della sottointegrazione successiva mappando la variabile nella proprietà Mappa agli input aggiuntivi della sottointegrazione. Di conseguenza, puoi aggregare cumulativamente le risposte delle esecuzioni delle sottointegrazioni.
`Loop metadata`	Array JSON	La variabile di output che contiene i dettagli di esecuzione delle esecuzioni della sottointegrazione, ad esempio l'ID esecuzione della sottointegrazione, i messaggi di errore e i 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`. Avviso: nei metadati di 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à Mentre loop, vedi 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 va a buon fine 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 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.