Consulta i connettori supportati per Application Integration.

Variabili

Una variabile è un elemento di integrazione che contiene e trasporta i dati tra le attività, gli trigger 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 esecuzione.
• Le variabili possono fare riferimento ad altre variabili in un'integrazione.
• Le variabili possono essere accessibili a livello globale a tutte le attività o localmente a un'attività specifica.

Tipi di variabili

Application Integration supporta quattro tipi di variabili:

• Voci di integrazione: consentono di tenere traccia dei dati durante l'esecuzione dell'intera integrazione.
• Voci di attività: tieni traccia dei dati per la durata di una singola attività.
• Variabili di configurazione: memorizzano i dati di configurazione dell'integrazione.
• Variabili di sistema: memorizzano i dati di configurazione dell'integrazione.

Variabili di integrazione

Le variabili di integrazione sono simili alle variabili 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:

• Prese in considerazione come input dell'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 sopra non sono mutuamente esclusivi. Qualsiasi 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 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 sono supportati i seguenti tipi di dati:

• Stringa e array di stringhe
• Array di numeri interi e interi
• Array di doppi e doppi
• Booleano e array booleano
• JSON

Variabili di attività

Le variabili di 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 memorizzato 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, come i dettagli del connettore, i dettagli di autenticazione o gli endpoint URL in base all'ambiente di sviluppo (QA, staging o produzione). Non è necessario aggiornare manualmente l'integrazione prima di caricarla in un nuovo ambiente. L'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.

Variabili di sistema

Le variabili di sistema vengono generate automaticamente quando crei un'integrazione. Puoi utilizzare queste variabili nelle attività di integrazione e per la gestione degli errori. L'integrazione contiene le seguenti variabili generate dal sistema:

• ErrorInfo: quando l'esecuzione non va a buon fine, puoi accedere ai dettagli dell'errore con la variabile ErrorInfo:

  {
    "ErrorInfo": {
    "message": String,
    "code": Number
    }
  }
  

  Al momento, puoi accedere ai messaggi di errore creando una variabile di integrazione denominata ErrorMessage. Tuttavia, ti consigliamo di utilizzare la variabile ErrorInfo.message generata dal sistema per accedere ai messaggi di errore.

• ExecutionMode: la modalità di esecuzione in base all'attivatore. I valori validi sono SYNC e ASYNC.
• ExecutionId: l'ID esecuzione dell'integrazione.
• IntegrationName: il nome dell'integrazione.
• Region: la regione dell'integrazione.
• ProjectId: l'ID progetto che contiene l'integrazione.

Visualizza variabili

Puoi utilizzare il riquadro Variabili per creare, modificare, visualizzare, duplicare ed eliminare le 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, svolgi i seguenti passaggi:

1. Nella barra di navigazione dell'editor dell'integrazione, fai clic su (Attiva/disattiva riquadro) 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 all'attivatore eseguito.
   Output dell'integrazione	Il valore finale della variabile al termine dell'esecuzione deve essere visualizzato per l'utente che chiama l'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 all'autore della chiamata 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 di numeri interi	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.
      • Deduzione 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.
      • Deduzione dal valore predefinito:genera uno schema JSON utilizzando il valore predefinito fornito.
      • Nessuna:nessun 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.

Utilizzare le variabili nelle integrazioni

Durante l'esecuzione di un'integrazione, i dati di runtime vengono passati 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 grafo in memoria delle attività utilizzando la definizione di 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 nuovamente i dati nell'oggetto Event,per essere utilizzati dalle attività successive o per formare i dati di output dell'integrazione.

Riferimenti alle variabili

Le attività, gli attivatori e gli edge di un'integrazione leggono e scrivono nelle variabili utilizzando i riferimenti alle 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.

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