Consulta i connettori supportati per Application Integration.

Attività integrazione chiamate

L'attività Integrazione chiamate ti consente di invocare o chiamare altre integrazioni create all'interno del tuo progetto Google Cloud.

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

Prima di iniziare

• L'attività Integrazione chiamate 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 impostazione predefinita viene utilizzato l'account di servizio predefinito ([e-mail]) per l'autenticazione.
• Assicurati che il tuo account di servizio abbia il ruolo IAM Application Integration Invoker. 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:

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.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per saperne di più, consulta Attivare una nuova regione.
   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 di integrazione.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai abilitato la governance dell'integrazione per la regione selezionata.
   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 Call Integration nell'editor dell'integrazione.
6. Fai clic sull'elemento attività Call Integration (Integrazione chiamata) nel designer per visualizzare l'elemento Call Integration di configurazione delle attività.
7. Configura i seguenti dettagli dell'integrazione secondaria:
   1. ID trigger API:digita l'ID trigger API dell'integrazione da chiamare. Puoi chiamare una singola integrazione o più integrazioni con lo stesso ID trigger.
   2. Esegui tutte le integrazioni con questo ID attivatore API: seleziona questa opzione per chiamare tutte le integrazioni che hanno lo stesso ID attivatore dell'API.

      Ad esempio, se le integrazioni A e B hanno lo stesso ID trigger dell'API, vengono eseguite entrambe.

      Nota: se selezioni questa opzione, la risposta delle sottointegrazioni non sarà disponibile nell'integrazione principale. Se vuoi accedere alla risposta delle sub-integrazioni, 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. Puoi accedere e mappare la risposta della sottointegrazione configurando i campi descritti in Mappa le variabili di risposta della sottointegrazione.

   4. Strategia di esecuzione: seleziona le modalità di esecuzione per le sottointegrazioni che vuoi chiamare.
      • SYNC: esegue la sottointegrazione in modalità sincrona. In questa modalità, l'integrazione principale attende il completamento delle sottointegrazioni prima di continuare con le attività a valle.

      • ASYNC: esegue l'integrazione secondaria in modalità asincrona. In questa modalità, l'integrazione principale non attende il completamento delle sottointegrazioni. Immediatamente dopo aver chiamato le integrazioni secondarie, l'integrazione principale esegue le attività a valle.

        Se questa opzione è selezionata, imposta il Ritardo nell'esecuzione (in millisecondi). Se impostato, specifica il ritardo di tempo fino all'esecuzione dell'integrazione.

      Tutte le modifiche apportate alle proprietà vengono salvate automaticamente.

Mappa le variabili di risposta della sottointegrazione

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

Proprietà	Descrizione
Map to sub-integration input(s)	Mappa i valori dall'integrazione principale a quella secondaria. 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, se vuoi mappare la variabile productID dell'integrazione principale alla variabile di sottointegrazione subIntProductID, seleziona productID dal campo Variabile di integrazione da mappare e inserisci subIntProductID nel campo Input di sottointegrazione.
Map values to sub-integration output(s)	Mappa le variabili di output della sottointegrazione alle variabili di integrazione principali. Fai clic su Output della sottointegrazione da cui eseguire la mappatura e seleziona la sottointegrazione. Fai clic su Integration Variable to Map to (Variabile di integrazione a cui 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 SYNC.

Best practice

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