Utilizzo delle variabili in Apigee Integration

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

Una variabile è un elemento di integrazione che conserva e trasporta i dati tra le attività, gli attivatori e i bordi di un'integrazione.

• Le variabili possono essere definite in modo statico in fase di progettazione o trasmesse dinamicamente all'integrazione in fase di runtime.
• Le variabili possono fare riferimento ad altre variabili in un'integrazione.
• Le variabili possono essere accessibili a livello globale per tutte le attività oppure localmente per un'attività specifica.

Sono disponibili tre tipi di variabili:

• Variabili di integrazione: tieni traccia dei dati nel corso di un'intera esecuzione di integrazione.
• Variabili attività: tieni traccia dei dati per la durata di una singola attività.
• Variabili di configurazione: memorizza i dati di configurazione dell'integrazione.

Variabili di integrazione

Le variabili di integrazione sono simili a quelle utilizzate in un linguaggio di programmazione. I dati nelle variabili possono essere letti e scritti durante l'esecuzione dell'integrazione.

Le variabili di integrazione possono essere utilizzate nei seguenti modi:

• Presi come input per l'integrazione (variabili di input).
• Restituiti come output dell'integrazione (variabili di output).
• Utilizzato per mantenere lo stato temporaneo durante l'esecuzione di un'integrazione.
Nota: i ruoli variabili elencati sopra non si escludono a vicenda. Ogni variabile può essere una variabile di input, una variabile di output, entrambe o nessuna delle due.

Il valore di una variabile non deve essere definito in modo statico nell'integrazione. I valori delle variabili possono essere trasmessi in un'integrazione tramite l'uso di un trigger. Tuttavia, se una variabile viene definita in modo statico nell'integrazione e la stessa variabile viene fornita in modo dinamico con il trigger, l'assegnazione del valore dinamico sovrascriverà l'assegnazione statica.

Tipi di dati supportati per le variabili di integrazione

Per le variabili di integrazione sono supportati i seguenti tipi di dati:

• Stringa e array di stringhe
• Array di numeri interi e interi
• Array doppio e doppio
• Array booleani e booleani
• JSON

Variabili attività

Le variabili attività sono variabili predefinite generate automaticamente per un'attività. Se un'attività ha un output, tutte queste uscite sono disponibili in una variabile dell'attività. Non puoi eliminare o modificare una variabile dell'attività. Ad esempio, per l'attività Chiama endpoint REST, il corpo della risposta viene archiviato nella variabile responseBody.

Variabili di configurazione

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Le variabili di configurazione consentono di esternalizzare la configurazione per l'integrazione. Con le variabili di configurazione, puoi configurare aspetti dell'integrazione, ad esempio i dettagli del connettore, i dettagli di autenticazione o gli endpoint URL basati sull'ambiente di sviluppo (QA, gestione temporanea o produzione). Non è necessario aggiornare manualmente l'integrazione prima di caricarla in un nuovo ambiente. Application Integration ti consente di inserire i valori per le variabili di configurazione quando pubblichi l'integrazione.

Per scoprire come creare variabili di configurazione e utilizzarle, consulta il tutorial Creazione di CICD per l'integrazione.

Visualizza variabili

Puoi utilizzare il riquadro Variabili per creare, modificare, visualizzare, duplicare ed eliminare variabili nell'integrazione. Il riquadro Variabili mostra anche il conteggio dei riferimenti alle variabili totali all'interno dell'integrazione.

Per visualizzare il riquadro Variabili, fai clic su (riquadro di attivazione/disattivazione) nella barra di navigazione del designer.

La seguente immagine mostra un layout di esempio del riquadro Variabili:

Crea una variabile

Per creare una variabile:

1. Nella barra di navigazione dell'editor di integrazione, fai clic su (riquadro di attivazione/disattivazione) per visualizzare il riquadro Variabili.
2. Fai clic su +Crea.
3. Nel riquadro Crea variabile:
   1. Nome:inserisci il nome della variabile.
   2. Tipo di variabile:scegli il tipo di variabile.

   Tipo di dati	Descrizione
   Nessuna	Una variabile locale in un'integrazione.
   Variabile di configurazione per l'integrazione	Una variabile di configurazione in un'integrazione.
   Input all'integrazione	Durante l'esecuzione, la variabile verrà fornita come input per il trigger eseguito.
   Output dall'integrazione	Il valore finale della variabile al termine dell'esecuzione deve essere inviato al chiamante dell'integrazione.
   Input e output dell'integrazione	Al momento dell'esecuzione, la variabile verrà fornita come input per il trigger eseguito e il suo valore finale verrà inviato al chiamante dell'integrazione.

   3. Tipo di dati: scegli il tipo di dati della variabile. Puoi identificare il tipo di dati di una variabile utilizzando l'icona accanto al suo nome.

      Tipo di dati	Esempio
      Stringa	Alex
      Numero intero	30
      Doppio	30.5
      Valore booleano	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array di stringhe	Alex, Kai, Raha
      Array di numero intero	30, 25, 22
      Array doppio	30.5, 25.34, 22.134
      Array booleano	true, false, false

      Per informazioni sui tipi di dati supportati, vedi Tipi di dati supportati.

   4. Valore predefinito:inserisci il valore predefinito per la variabile. Questo è un campo facoltativo.
   5. Schema: seleziona lo schema JSON per la variabile.
      • Deduci da un payload JSON di esempio:genera uno schema JSON da un payload JSON di esempio. Il payload di esempio viene eliminato dopo la generazione dello schema. Verrà salvato solo lo schema generato.
      • Inserisci uno schema JSON:inserisci manualmente un intero schema JSON.
      • Deduci dal valore predefinito:genera uno schema JSON utilizzando il valore predefinito fornito.
      • Nessuno: nessuno schema JSON.
      Nota:questo campo viene visualizzato solo per le variabili di tipo di dati JSON.
   6. Maschera la variabile nei log (anteprima): seleziona questa opzione per abilitare il mascheramento della variabile nei log di esecuzione dell'integrazione. Per attivare il mascheramento per la variabile, devi abilitare le variabili per l'integrazione e la regione. Per informazioni su come attivare il mascheramento per l'integrazione e la regione, consulta Modificare un'integrazione e Modificare le regioni.

      Per informazioni sul mascheramento, consulta Mascherare i dati sensibili nei log.

4. Fai clic su Crea.

Utilizzare dati variabili nelle integrazioni

Durante l'esecuzione di un'integrazione, i dati di runtime vengono trasmessi come variabili dichiarate per l'integrazione o l'attività. Una volta avviata l'esecuzione, i dati di input vengono convertiti in un oggetto in memoria chiamato evento.

Dopo aver creato l'oggetto Event, viene creato un grafico in memoria delle attività utilizzando la definizione dell'integrazione. I valori delle variabili in entrata vengono passati alle attività in base alla configurazione. Durante l'esecuzione dell'integrazione, le attività leggono e scrivono i dati nell'oggetto Event,per essere utilizzati nelle attività successive o per formare i dati di output dell'integrazione.