Utilizzo delle variabili nell'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 contiene e trasporta i dati tra le attività, gli attivatori e i margini di un'integrazione.

• Le variabili possono essere definite in modo statico in fase di progettazione o passate 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à o accessibili localmente per un'attività specifica.

Sono disponibili tre tipi di variabili:

• Variabili di integrazione: tieni traccia dei dati nel corso di un'intera esecuzione dell'integrazione.
• Variabili attività: tieni traccia dei dati per la durata di una singola attività.
• Variabili di configurazione: archivia 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 tutta l'esecuzione dell'integrazione.

Le variabili di integrazione possono essere utilizzate nei seguenti modi:

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

Il valore delle variabili non deve essere necessariamente definito in modo statico nell'integrazione. I valori delle variabili possono essere trasmessi in un'integrazione tramite un attivatore. Tuttavia, se una variabile è definita in modo statico nell'integrazione e la stessa variabile viene fornita in modo dinamico con il trigger, l'assegnazione dei valori dinamici 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
• Numero intero e array intero
• Array doppio e doppio
• array booleani e booleani
• JSON

Variabili attività

Le variabili attività sono variabili predefinite generate automaticamente di un'attività. Se un'attività ha un output, tutti questi output 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 ti consentono di esternalizzare la configurazione per l'integrazione. Con le variabili di configurazione, puoi configurare aspetti dell'integrazione, ad esempio dettagli del connettore, dettagli di autenticazione o 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 Creare una 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 un conteggio dei riferimenti alle variabili totali all'interno dell'integrazione.

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

L'immagine seguente mostra un layout di esempio del riquadro Variabili:

Crea una variabile

Per creare una variabile:

1. Nella barra di navigazione dell'editor delle integrazioni, fai clic su (Attiva/disattiva riquadro) per visualizzare il riquadro Variabili.
2. Fai clic su +Crea.
3. Nel riquadro Crea variabile, segui questi passaggi:
   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 dell'integrazione	Durante l'esecuzione, la variabile viene fornita come input per il trigger eseguito.
   Output dell'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 all'attivatore 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
      Booleano	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array di stringhe	Alex, Kai, Raha
      Array intero	30, 25, 22
      Array doppio	30.5, 25.34, 22.134
      Array booleano	true, false, false

      Per informazioni sui tipi di dati supportati, consulta la sezione Tipi di dati supportati.

   4. Valore predefinito: inserisci il valore predefinito per la variabile. Questo 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 ignorato 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 abilitare il mascheramento per la variabile, devi abilitare il mascheramento delle variabili per l'integrazione e la regione. Per informazioni su come attivare il mascheramento per l'integrazione e la regione, consulta gli articoli Modificare un'integrazione e Modificare le regioni.

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

4. Fai clic su Crea.

Utilizzo di 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 iniziata l'esecuzione, i dati di input vengono convertiti in un oggetto in memoria denominato evento.

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