Consulta i connettori supportati per Application Integration.
Attività per singola parallela
L'attività Per ogni paralle ti consente di eseguire altre integrazioni (sub-integrazioni) dall'integrazione principale. Come suggerisce il nome dell'attività, le sottointegrazioni vengono eseguite in parallelo.
Questa attività utilizza l'ID trigger dell'API come handle per identificare le integrazioni da eseguire.
Ad esempio, se specifichi l'ID trigger
dell'API come api_trigger/APITriggerX, l'attività esegue tutte le sottointegrazioni che hanno
l'ID trigger api_trigger/APITriggerX.
Dopo aver eseguito una sottointegrazione, puoi anche leggere la risposta della sottointegrazione nell'integrazione principale. Utilizza questa attività per eseguire le sottointegrazioni come dipendenze dell'integrazione principale.
Prima di iniziare
- Assicurati di aver allegato 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.
Configura l'attività per ogni paralle
Per configurare l'attività Per ogni parallela:
- Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.
- Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nel riquadro Crea integrazione.
- Seleziona una regione per l'integrazione.
- Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
- Fai clic su Crea.
Viene visualizzata l'integrazione nell'editor di integrazione.
- Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
- Fai clic e posiziona l'elemento dell'attività Per ogni paralle nell'editor di integrazione.
- Fai clic sull'elemento dell'attività Per ogni paralle nel designer per aprire il riquadro di configurazione dell'attività Per ogni paralle.
- Configura i campi visualizzati utilizzando le proprietà di configurazione per l'attività come descritto nelle tabelle seguenti.
Tutte le modifiche alle proprietà vengono salvate automaticamente.
Proprietà di configurazione
Questa sezione descrive le proprietà di configurazione dell'attività Per ogni paralle.
Proprietà di input
| Nome proprietà | Nome parametro | Tipo di dati | Descrizione |
| Selezione array | List to iterate
|
Un array di tipo stringa, intero, doppio o JSON. | Elenco di valori per i quali devono essere eseguite le sottointegrazioni.
Viene eseguito un thread di sottointegrazione separato per ogni valore nell'elenco e tutti i thread vengono eseguiti in parallelo.
Puoi passare il valore iterato alla sottointegrazione impostando il campo Dove mappare i singoli elementi dell'array. Puoi anche passare valori aggiuntivi dall'integrazione principale alla sottointegrazione nel campo Mappa a uno o più input aggiuntivi della sottointegrazione. |
| Dettagli della sottointegrazione | API Trigger ID
|
Stringa | L'ID attivatore della sottointegrazione pubblicata da eseguire.
Questo valore è disponibile nel campo ID trigger dell'attivatore API nella sottointegrazione. |
Execution strategy
|
N/D |
SYNC: esegue le sottointegrazioni in modalità sincrona. In questa modalità, l'integrazione principale attende il completamento delle sottointegrazioni prima di continuare con le attività a valle. ASYNC: esegue le sottointegrazioni in modalità asincrona. In questa modalità, l'integrazione principale non attende il completamento delle sottointegrazioni. Immediatamente dopo aver chiamato le sottointegrazioni, l'integrazione principale esegue le attività a valle. |
|
Run all integrations with this API Trigger ID |
N/D | Esegue tutte le integrazioni
che hanno lo stesso ID trigger dell'API.
Ad esempio, se le integrazioni Nota: se selezioni questa opzione, la risposta delle sottointegrazioni non sarà disponibile nell'integrazione principale. Se vuoi utilizzare la risposta delle sub-integrazioni, seleziona l'opzione Esegui una singola integrazione. |
|
Run a single integration |
N/D | Esegue solo l'integrazione specificata nel
nome dell'integrazione. Puoi utilizzare la risposta delle sottointegrazioni
configurando la sezione Raccogliere i valori dagli output delle sottointegrazioni.
|
|
| A ogni esecuzione | Where to map individual array elements |
Stringa | Il nome della variabile di input della sottointegrazione in cui devono essere mappati gli elementi dell'array. Gli elementi dell'array possono essere mappati direttamente a una variabile di input di sottointegrazione. Se è selezionata una singola sottointegrazione, puoi selezionare la variabile di input della sottointegrazione da un elenco a discesa. |
Map to additional sub-integration input(s) |
Stringa | Opzione di mappatura di sottointegrazione aggiuntiva.
Questo campo accetta valori sotto forma di coppie chiave-valore, dove la chiave è una variabile nell'integrazione principale e il valore è la variabile di input corrispondente nella sottointegrazione.
Ad esempio, supponiamo che l'integrazione principale contenga la variabile |
|
Collect values from sub-integration output(s) |
Stringa | Se la strategia di esecuzione è sincrona (SYNC) ed è selezionata una singola sottointegrazione (Esegui una singola integrazione), gli output della sottointegrazione possono essere raccolti in variabili array nell'integrazione corrente.
| |
| Impostazioni di esecuzione | Integrations to execute at a time (parallel)
|
Numero intero | Numero massimo di esecuzioni parallele consentite per le sottointegrazioni. Il valore predefinito è
50 (massimo 10000).
Tutte le sottointegrazioni di una coorte vengono eseguite completamente prima dell'esecuzione della coorte successiva di sottointegrazioni. |
Ignore failures
|
Booleano |
Puoi specificare uno dei seguenti valori:
|
Best practice
Ti consigliamo le seguenti best practice per l'utilizzo dell'attività Per ogni paralle:
- Imposta la dimensione della coorte in base alle limitazioni di quota imposte dalle sottointegrazioni.
- Utilizza una strategia di esecuzione SYNC quando vuoi raccogliere l'output della sottointegrazione per utilizzarlo in un secondo momento.
- Utilizza una strategia di esecuzione ASYNC quando la sottointegrazione potrebbe richiedere più di 2 minuti.
Per informazioni sui limiti di utilizzo che si applicano all'attività Per ogni paralle, consulta Limiti di utilizzo.
Considerazioni
In generale, non utilizzare una strategia di esecuzione SYNC se l'esecuzione della sottointegrazione richiede più di 2 minuti o se prevedi di utilizzare questa attività in combinazione con attività naturalmente asincrone come l'attività Approvazione.
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 sui diversi tipi di strategie di gestione degli errori, consulta 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.