Consulta i connettori supportati per Application Integration.
Attività per singola parallela
L'attività Per ogni parallelo ti consente di eseguire altre integrazioni (integrazioni secondarie) dall'integrazione principale. Come suggerito dal nome dell'attività, le integrazioni secondarie 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 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 principale nell'integrazione principale. Utilizza questa attività per eseguire integrazioni secondarie come dipendenze dell'integrazione principale.
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 l'autenticazione viene utilizzato per impostazione predefinita l'account di servizio predefinito (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
). - Assicurati che il tuo account di servizio disponga del 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.
Configura l'attività Per ogni parallelo
Per configurare l'attività Per ogni parallelo:
- Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
- Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, in cui sono elencate 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 di un account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti di integrazione.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor di integrazione.
- Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività disponibili.
- Fai clic e posiziona l'elemento dell'attività For every Parallel nell'editor di integrazione.
- Fai clic sull'elemento dell'attività For Every Parallel nel designer per aprire il riquadro di configurazione delle attività For Every Parallel.
- 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à input
Nome proprietà | Nome parametro | Tipo di dati | Description |
Selezione degli array | List to iterate
|
Un array di tipo stringa, numero intero, doppio o JSON. | Elenco dei valori per i quali devono essere eseguite le integrazioni secondarie.
Per ogni valore nell'elenco viene eseguito un thread di integrazione secondaria separato e tutti i thread vengono eseguiti in parallelo.
Puoi passare il valore iterato all'integrazione secondaria impostando il campo Dove mappare i singoli elementi dell'array. Puoi anche passare valori aggiuntivi dall'integrazione principale all'integrazione secondaria nel campo Mappa agli input aggiuntivi dell'integrazione secondaria. |
Dettagli dell'integrazione secondaria | API Trigger ID
|
Stringa | ID trigger dell'integrazione secondaria pubblicata da eseguire.
Questo valore è disponibile nel campo ID trigger del Trigger API nell'integrazione secondaria. |
Execution strategy
|
N/A |
SINCRONIZZAZIONE: 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 la chiamata delle integrazioni secondarie, l'integrazione principale esegue le attività downstream. |
|
Run all integrations with this API Trigger ID |
N/A | 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 è disponibile nell'integrazione principale. Se vuoi utilizzare la risposta delle integrazioni secondarie, seleziona l'opzione Esegui una singola integrazione. |
|
Run a single integration |
N/A | Esegue solo l'integrazione specificata nel campo Nome integrazione. Puoi utilizzare la risposta delle integrazioni secondarie configurando la sezione Raccogli valori dagli output dell'integrazione secondaria.
|
|
A ogni esecuzione | Where to map individual array elements |
Stringa | Il nome della variabile di input dell'integrazione secondaria in cui devono essere mappati gli elementi dell'array. Gli elementi dell'array possono essere mappati direttamente a una variabile di input dell'integrazione secondaria. Se è 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 aggiuntiva di mappatura delle sottointegrazioni.
Questo campo assume i valori sotto forma di coppie chiave-valore, in cui la chiave è una variabile nell'integrazione principale 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) |
Stringa | Se la strategia di esecuzione è sincrona (SYNC) ed è selezionata una singola integrazione secondaria (Esegui una singola integrazione), gli output dell'integrazione secondaria possono essere raccolti in variabili array nell'integrazione attuale.
| |
Impostazioni di esecuzione | Integrations to execute at a time (parallel)
|
Numero intero | Numero massimo di esecuzioni parallele consentito per le integrazioni secondarie. Il valore predefinito è 50 (massimo 10000 ).
Tutte le sottointegrazioni vengono eseguite completamente prima della coorte successiva. |
Ignore failures
|
Booleano |
Puoi specificare uno qualsiasi dei seguenti valori:
|
best practice
Quando utilizzi l'attività Per ogni parallelo, ti consigliamo di attenerti alle seguenti best practice:
- Imposta la dimensione della coorte in base a eventuali limitazioni di quota imposte dalle tue integrazioni secondarie.
- Utilizza una strategia di esecuzione SYNC quando vuoi raccogliere l'output dell'integrazione secondaria per utilizzarlo in un secondo momento.
- Utilizza una strategia di esecuzione ASYNC quando la tua integrazione secondaria potrebbe durare più di 2 minuti.
Per informazioni sui limiti di utilizzo che si applicano all'attività Per ogni parallelo, consulta Limiti di utilizzo.
Considerazioni
In generale, non utilizzare una strategia di esecuzione SYNC se l'esecuzione dell'integrazione secondaria richiede più di 2 minuti 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 per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.