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 nome dell'attività le integrazioni secondarie vengono eseguite in parallelo.

Questa attività utilizza l'ID attivatore 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 un'integrazione secondaria, puoi anche Leggi la risposta della sottointegrazione nell'integrazione principale. Usa questa attività per eseguire integrazioni secondarie come dipendenze dell'integrazione principale.

Prima di iniziare

Configura l'attività per ogni paralle

Per configurare l'attività Per ogni parallelo:

  1. Nella console Google Cloud, vai alla pagina Application Integration.

    Vai ad Application Integration

  2. 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.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. 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 dell'integrazione.
    4. Fai clic su Crea.

    L'integrazione viene aperta nell'editor dell'integrazione.

  4. Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
  5. Fai clic e posiziona l'elemento dell'attività Per ogni parallelo nell'editor di integrazione.
  6. Fai clic sull'elemento dell'attività Per ogni parallelo nel designer per aprire la finestra Per ogni parallelo. di configurazione delle attività.
  7. Configura i campi visualizzati utilizzando le proprietà di configurazione per l'attività come descritto nelle tabelle seguenti.

    Tutte le modifiche apportate 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 dell'array List to iterate Un array di tipo stringa, numero intero, doppio o JSON. Elenco di valori per i quali devono essere eseguite le integrazioni secondarie. Viene eseguito un thread di integrazione secondaria separato per ogni valore nell'elenco i thread vengono eseguiti in parallelo.

Puoi passare il valore ripetuto all'integrazione secondaria impostando il valore Dove mappare i singoli elementi dell'array.

Puoi anche passare valori aggiuntivi dall'integrazione principale all'integrazione secondaria in nel campo Mappa a input di integrazione secondaria aggiuntivi.

Dettagli della sottointegrazione 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/D

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 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 API.

Ad esempio, se l'integrazione A e l'integrazione B hanno la stessa API ID trigger, entrambe le integrazioni A e B vengono eseguite per ogni elemento in Elenco da ripetere.

Nota: se selezioni questa opzione, la risposta delle integrazioni secondarie non è disponibile nell'integrazione principale. Se vuoi utilizzare la risposta del nelle integrazioni secondarie, seleziona l'opzione Esegui una singola integrazione.

Run a single integration N/D Esegue solo l'integrazione specificata nel Campo Integration name (Nome integrazione). Puoi utilizzare la risposta delle integrazioni secondarie configurando la sezione Raccogli valori da output di sottointegrazione.

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. L'array possono essere mappati direttamente a una variabile di input di integrazione secondaria. 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 aggiuntiva per la mappatura secondaria.
  • Variabile di integrazione da cui mappare: il nome della variabile nell'integrazione corrente a da passare alla variabile di input della sottointegrazione.
  • Input di integrazione secondaria a cui mappare: il nome della variabile di input dell'integrazione secondaria a cui mappare.

Questo campo richiede 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 sottointegrazione.

Ad esempio, supponiamo che l'integrazione principale contenga la variabile productID, che vuoi mappare alla variabile di sottointegrazione subIntProductID. Devi selezionare productID dal campo Variabile di integrazione da mappare e inserire subIntProductID nel campo Inserisci la variabile di sottointegrazione.

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.
  • Output dell'integrazione secondaria da cui raccogliere: il nome della variabile di output della sottointegrazione da aggregare.
  • Variabile di integrazione da raccogliere: il nome della variabile nell'integrazione corrente in cui raccogliere la con output aggregati.
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 di sottointegrazioni successiva.

Ignore failures Booleano

Puoi specificare uno dei seguenti valori:

  • True: l'attività ignora gli errori di integrazione secondaria ed esegue tutte le esecuzioni.
  • False: l'attività non va a buon fine per errori di sottointegrazione e termina tutte le esecuzioni.

Best practice

Quando utilizzi l'attività Per ogni parallelo, consigliamo le seguenti best practice:

  • Imposta la dimensione della coorte in base a eventuali limitazioni di quota imposte dalle integrazioni secondarie.
  • Utilizza una strategia di esecuzione SYNC quando vuoi raccogliere l'output della sottointegrazione per un utilizzo futuro.
  • Utilizza una strategia di esecuzione ASYNC se la sottointegrazione potrebbe essere eseguita per più di 2 minuti.

Per informazioni sui limiti di utilizzo che si applicano all'attività Per ogni parallelo, vedi 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à di approvazione.

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 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