Consulta i connettori supportati per Application Integration.

Variabili

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

• Le variabili possono essere definite in modo statico in fase di progettazione o trasmesse dinamicamente all'integrazione in fase di esecuzione.
• Le variabili possono fare riferimento ad altre variabili in un'integrazione.
• Le variabili possono essere globali accessibile a tutte le attività o localmente per una specifica attività.

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. Dati nelle variabili possono essere lette e scritte durante l'esecuzione dell'integrazione.

Le variabili di integrazione possono essere utilizzate nei seguenti modi:

• Presi come input per l'integrazione (variabili di input).
• Restituito come output dell'integrazione (variabili di output).
• Viene 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. Qualsiasi dato 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 a un'integrazione tramite l'utilizzo di un attivatore. Tuttavia, se una variabile è definita in modo statico nell'integrazione e la stessa variabile viene fornita dinamicamente con l'attivatore, 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 di numeri doppi e doppi
• array booleani e booleani
• JSON

Riferimenti alle variabili

Le attività, gli attivatori e i perimetri di un'integrazione vengono letti e scritti nelle variabili utilizzando riferimenti a variabili. Un riferimento a una variabile ha il formato $paramKey$, dove paramKey è il nome della variabile. Ad esempio, una condizione di confine potrebbe avere il seguente aspetto:

NOT ($isNameUnique$ = false OR $numAccounts$ > 1)

In questo esempio, isNameUnique è una variabile di tipo di dati booleano e numAccounts è un parametro di tipo di dati intero.

Variabili di 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 di attività. Ad esempio, per l'attività Chiama endpoint REST, il corpo della risposta viene archiviato nella 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 e utilizzare le variabili di configurazione, consulta il tutorial Creare 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:

Creare 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, procedi nel seguente modo:
   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 verrà fornita come input all'attivatore 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 nome della variabile.

      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, vedi 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 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. Nascondi la variabile nei log (anteprima): seleziona questa opzione per attivare il mascheramento della variabile nei log di esecuzione dell'integrazione. Per attivare il mascheramento per la variabile, devi attivare le variabili di mascheramento 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, vedi Nascondere i dati sensibili nei log.

4. Fai clic su Crea.

Utilizzo di dati variabili nelle integrazioni

Durante l'esecuzione di un'integrazione, i dati relativi al tempo di esecuzione vengono trasmessi come variabili 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 grafo in memoria delle attività utilizzando la definizione dell'integrazione. I valori della variabile in entrata vengono passati alle attività in base alla tua configurazione. Durante l'esecuzione dell'integrazione, le attività leggono e scrivono nuovamente i dati nell'oggetto Event, per essere utilizzati dalle attività successive o per formare i dati di output dell'integrazione.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi

• Scopri come creare CI/CD per la tua integrazione.
• Scopri come mascherare i dati sensibili nei log.
• Aggiungere e configurare un'attività di mappatura dei dati