Consulta i connettori supportati per Application Integration.

Attività integrazione chiamate

L'attività Chiamate di integrazione ti consente di richiamare o chiamare altre integrazioni create all'interno del tuo progetto Google Cloud.

L'attività Integrazione chiamate è utile negli scenari in cui devi definire più piccole integrazioni (integrazioni secondarie) controllate utilizzando un'integrazione principale (integrazione principale). Dopo aver eseguito un'integrazione secondaria, puoi anche leggere la risposta dell'integrazione principale nell'integrazione principale.

Prima di iniziare

L'attività Call Integration utilizza l'attivatore API per identificare e chiamare altre integrazioni e sottointegrazioni. Devi quindi assicurarti che le integrazioni che vuoi chiamare siano configurate utilizzando il trigger API. Per informazioni sulla configurazione di un trigger API, consulta Trigger API.
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à di integrazione delle chiamate

Per configurare l'attività Integrazione chiamate:

Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
Vai ad Application Integration
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:
1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
2. Seleziona una regione per l'integrazione.
  Nota:nel menu a discesa Regioni sono elencate solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
3. 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.
  Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance di integrazione per la regione selezionata.
4. 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 sull'elemento Call Integration (Integrazione chiamate) e posizionalo nell'editor di integrazione.
Fai clic sull'elemento dell'attività Call Integration nel designer per visualizzare il riquadro di configurazione delle attività Call Integration (Integrazione chiamate).
Configura i seguenti dettagli dell'integrazione secondaria:
1. ID trigger API: digita l'ID trigger API dell'integrazione che vuoi chiamare. Puoi chiamare una singola integrazione o più integrazioni con lo stesso ID trigger.
2. Esegui tutte le integrazioni con questo ID trigger API:seleziona questa opzione per chiamare tutte le integrazioni che hanno lo stesso ID trigger API.
  Ad esempio, se l'integrazione A e l'integrazione B hanno lo stesso ID trigger API, vengono eseguite entrambe le integrazioni A e B.
  
  Nota: se selezioni questa opzione, la risposta delle integrazioni secondarie non sarà disponibile nell'integrazione principale. Se vuoi accedere alla risposta delle integrazioni secondarie, seleziona l'opzione Esegui una singola integrazione.
3. Esegui una singola integrazione: seleziona questa opzione per chiamare solo l'integrazione specificata nel campo Nome integrazione. Per accedere alla risposta dell'integrazione secondaria e mapparla, puoi configurare i campi dettagliati in Mappare le variabili di risposta dell'integrazione secondaria.
4. Strategia di esecuzione: seleziona le modalità di esecuzione per le integrazioni secondarie che vuoi chiamare.
  - SINCRONIZZAZIONE: esegue l'integrazione secondaria in modalità sincrona. In questa modalità, l'integrazione principale attende il completamento delle integrazioni secondarie prima di continuare con le attività downstream.
  - ASYNC: esegue l'integrazione secondaria 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.
    
    Se questa opzione è selezionata, imposta il Ritardo di esecuzione (in millisecondi). Se impostata, consente di specificare il ritardo dell'esecuzione dell'integrazione.
  Tutte le modifiche alle proprietà vengono salvate automaticamente.

Mappa le variabili di risposta dell'integrazione secondaria

La tabella seguente descrive le proprietà di configurazione per mappare le variabili tra l'integrazione principale e le sottointegrazioni:

Proprietà Description

Proprietà	Description
`Map to sub-integration input(s)`	Mappa i valori dall'integrazione principale a quella secondaria. 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, se vuoi mappare la variabile `productID` dell'integrazione principale alla variabile di integrazione secondaria `subIntProductID`, seleziona `productID` nel campo Variabile di integrazione da mappare e inserisci `subIntProductID` nel campo Input della sottointegrazione da mappare.
`Map values to sub-integration output(s)`	Mappa le variabili di output dell'integrazione secondaria alle variabili di integrazione principali. Fai clic su Output della subintegrazione da cui eseguire la mappatura e seleziona l'integrazione secondaria. Fai clic su Variabile di integrazione da mappare e seleziona la variabile di integrazione principale corrispondente. Nota: questo campo viene visualizzato solo quando è selezionata l'opzione Esegui una singola integrazione con la strategia di esecuzione SINC.

Map to sub-integration input(s)

Mappa i valori dall'integrazione principale a quella secondaria. 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, se vuoi mappare la variabile productID dell'integrazione principale alla variabile di integrazione secondaria subIntProductID, seleziona productID nel campo Variabile di integrazione da mappare e inserisci subIntProductID nel campo Input della sottointegrazione da mappare.

Map values to sub-integration output(s)

Mappa le variabili di output dell'integrazione secondaria alle variabili di integrazione principali.

Fai clic su Output della subintegrazione da cui eseguire la mappatura e seleziona l'integrazione secondaria. Fai clic su Variabile di integrazione da mappare e seleziona la variabile di integrazione principale corrispondente.

best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Integrazione delle chiamate, consulta 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 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.