Attività per singola parallela
L'attività Per singola parallela consente di eseguire altre integrazioni (integrazioni secondarie) dall'integrazione principale. Come suggerisce il nome dell'attività, le integrazioni secondarie vengono eseguite in parallelo.
Questo task 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 integrazioni secondarie che hanno
l'ID trigger api_trigger/APITriggerX.
Dopo aver eseguito un'integrazione secondaria, puoi anche leggere la risposta dell'integrazione secondaria nell'integrazione principale. Utilizza questa attività per eseguire le integrazioni secondarie come dipendenze dell'integrazione principale.
Prima di iniziare
- Assicurati di aver collegato un service account gestito dall'utente all'integrazione. Se l'integrazione non ha configurato un account di servizio gestito dall'utente, per l'autenticazione viene utilizzato per impostazione predefinita il service account predefinito (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com). - Assicurati che il account di servizio disponga del ruolo IAM Application Integration Invoker. Per informazioni sulla concessione di ruoli a un account di servizio, vedi Gestire l'accesso ai service account.
Configura l'attività per singola parallela
Per configurare l'attività Per singola parallela:
- Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.
- Nel menu di navigazione, fai clic su 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 del account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti dell'integrazione.
- Fai clic su Crea. L'integrazione appena creata si apre nell'editor integrazioni.
- Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
- Fai clic e posiziona l'elemento attività Per singola parallela nell'Editor integrazioni.
- Fai clic sull'elemento dell'attività Per singola parallela nel designer per aprire il riquadro di configurazione dell'attività Per singola parallela.
- 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 parallelo.
Proprietà di input
| Nome proprietà | Nome parametro | Tipo di dati | Descrizione |
| Selezione array | List to iterate
|
Un array di tipo stringa, numero intero, numero a virgola mobile o JSON. | Elenco dei valori per cui devono essere eseguite le integrazioni secondarie.
Per ogni valore dell'elenco viene eseguito un thread di integrazione secondaria separato e tutti i thread vengono eseguiti in parallelo.
Puoi passare il valore iterato alla sotto-integrazione impostando il campo Dove mappare i singoli elementi dell'array. Puoi anche trasferire valori aggiuntivi dall'integrazione principale all'integrazione secondaria nel campo Mappa a input aggiuntivi dell'integrazione secondaria. |
| Dettagli della sottointegrazione | API Trigger ID
|
Stringa | L'ID trigger della sotto-integrazione pubblicata da eseguire.
Questo valore è disponibile nel campo ID trigger del trigger API nella sub-integrazione. |
Execution strategy
|
N/D |
SYNC: esegue le integrazioni secondarie in modalità sincrona. In questa modalità, l'integrazione principale attende il completamento delle integrazioni secondarie prima di continuare con le attività downstream. ASYNC: esegue le integrazioni secondarie in modalità asincrona. In questa modalità, l'integrazione principale non attende il completamento delle integrazioni secondarie. Subito dopo aver chiamato le integrazioni secondarie, l'integrazione principale esegue le attività downstream. |
|
Run all integrations with this API Trigger ID |
N/D | Esegue tutte le integrazioni
che hanno lo stesso ID trigger API.
Ad esempio, se l'integrazione
Nota: se selezioni questa opzione, la risposta delle integrazioni secondarie non sarà disponibile nell'integrazione principale. Se vuoi utilizzare la risposta delle integrazioni secondarie, seleziona l'opzione Esegui una singola integrazione. |
|
Run a single integration |
N/D | Esegue solo l'integrazione specificata nel campo
Nome integrazione. Puoi utilizzare la risposta delle integrazioni secondarie
configurando la sezione Raccogli valori dagli output delle integrazioni secondarie.
|
|
| A ogni esecuzione | Where to map individual array elements |
Stringa | Il nome della variabile di input della sotto-integrazione in cui devono essere mappati gli elementi dell'array. Gli elementi dell'array possono essere mappati direttamente a una variabile di input della sotto-integrazione. Se viene selezionata una singola integrazione secondaria, puoi selezionare la variabile di input dell'integrazione secondaria da un elenco a discesa. |
Map to additional sub-integration input(s) |
Stringa | Opzione di mappatura aggiuntiva per l'integrazione secondaria.
Questo campo accetta valori sotto forma di coppie chiave-valore, in cui la chiave è una variabile nell'integrazione principale e il valore è la variabile di input corrispondente nella sotto-integrazione.
Ad esempio, supponiamo che l'integrazione principale abbia la variabile |
|
Collect values from sub-integration output(s) |
Stringa | Se la strategia di esecuzione è sincrona (SYNC) e viene selezionata una singola integrazione secondaria (Esegui una singola integrazione), gli output dell'integrazione secondaria 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 integrazioni secondarie. Il valore predefinito è
50 (10000 massimo).
Tutte le integrazioni secondarie di una coorte vengono eseguite completamente prima dell'esecuzione della coorte successiva di integrazioni secondarie. |
Ignore failures
|
Booleano |
Puoi specificare uno qualsiasi dei seguenti valori:
|
Best practice
Ti consigliamo di seguire queste best practice quando utilizzi l'attività Per ogni parallelo:
- Imposta le dimensioni del segmento in base alle limitazioni di quota imposte dalle integrazioni secondarie.
- Utilizza una strategia di esecuzione SYNC quando vuoi raccogliere l'output della sotto-integrazione per un utilizzo successivo.
- Utilizza una strategia di esecuzione ASYNC quando la tua integrazione secondaria potrebbe essere eseguita per più di 2 minuti.
Per informazioni sui limiti di utilizzo applicati all'attività Per singola parallela, vedi Limiti di utilizzo.
Considerazioni
In generale, non utilizzare una strategia di esecuzione SYNC se l'integrazione secondaria richiede più di 2 minuti per essere eseguita o se prevedi di utilizzare questa attività in combinazione con attività naturalmente asincrone come l'attività di approvazione.
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 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.