Attività integrazione chiamate

L'attività Call Integration consente di richiamare o chiamare altre integrazioni create all'interno del 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à 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 impostazione predefinita viene utilizzato l'account di servizio predefinito (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) per l'autenticazione.
  • Assicurati che l'account di servizio abbia il 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à Call Integration:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > Integrazioni.
  3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
    2. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
    3. Fai clic su Crea.

    Viene aperta l'integrazione nel designer dell'integrazione.

  4. Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un attivatore > Tasks per visualizzare l'elenco delle attività 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 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 la stessa API ID trigger, entrambe le integrazioni A e B vengono eseguite correttamente.

    3. Esegui una singola integrazione: seleziona questa opzione per chiamare solo l'integrazione specificata nel Campo Integration name (Nome integrazione). Puoi accedere alla risposta e mapparla dall'integrazione secondaria configurando i campi descritti in Mappare le variabili di risposta all'integrazione secondaria.

    4. Strategia di esecuzione: seleziona le modalità di esecuzione per le integrazioni secondarie che vuoi chiamare.
      • SYNC: 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 sottointegrazioni. Subito dopo la chiamata all'iscritto integrazioni, l'integrazione principale esegue le attività downstream.

        Se questa opzione è selezionata, imposta il Ritardo nell'esecuzione (in millisecondi). Se impostato, specifica che deve trascorrere prima che l'integrazione venga eseguita.

      Tutte le modifiche apportate alle proprietà vengono salvate automaticamente.

Mappa variabili di risposta di integrazione secondaria

La tabella seguente descrive le proprietà di configurazione per mappare le variabili tra l'integrazione principale e le integrazioni secondarie:
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 subIntProductID variabile di integrazione secondaria, seleziona productID in Variabile di integrazione da cui eseguire la mappatura e inserisci subIntProductID nel campo Input Subintegration 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 sottointegrazione da cui eseguire la mappatura e seleziona la una sottointegrazione. Fai clic su Integration Variable to Map to (Variabile di integrazione a cui mappare) e seleziona la variabile di integrazione principale corrispondente.

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