Consulta i connettori supportati per Application Integration.

Variabili

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

• Le variabili possono essere definite staticamente 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 a tutte le attività o a livello locale a un'attività specifica.

Tipi di variabili

Application Integration supporta quattro tipi di variabili:

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

• Acquisite 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 delle variabili elencati sopra non si escludono a vicenda. Una determinata 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 staticamente nell'integrazione. I valori delle variabili possono essere passati a un'integrazione tramite l'utilizzo di un attivatore. Tuttavia, se una variabile è definita staticamente nell'integrazione e la stessa variabile viene fornita dinamicamente con il trigger, l'assegnazione dinamica del valore 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
• Numero intero e array di numeri interi
• Doppio e doppio array
• Booleano e array booleano
• JSON

Variabili dell'attività

Le variabili dell'attività sono variabili predefinite generate automaticamente di un'attività. Se un'attività ha un output, tutti gli 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 questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. 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, come i dettagli del connettore, i dettagli di autenticazione o gli endpoint URL basati sull'ambiente di sviluppo (QA, staging o produzione). Non devi 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 visualizzare e modificare le variabili di configurazione definite nell'integrazione, fai clic sulla variable_add Variabile di configurazione dell'integrazione nel riquadro Variabili. Per scoprire come creare variabili di configurazione e utilizzarle, consulta il tutorial Crea 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 al trigger. 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 del 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 totali alle variabili 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:

Visualizzare e modificare le variabili di configurazione

Anteprima

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. 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.

Per visualizzare le variabili di configurazione definite nell'integrazione, fai clic su variable_add Variabile di configurazione dell'integrazione nel riquadro Variabili. Viene visualizzato il riquadro Variabili di configurazione, che mostra tutte le variabili di configurazione definite nell'integrazione. Per modificare il valore della variabile di configurazione, è sufficiente fare clic sul campo Valore.

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

Creare una variabile

Per creare una variabile, segui questi 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 per l'integrazione	Durante l'esecuzione, la variabile verrà fornita come input al trigger eseguito.
   Output dell'integrazione	Il valore finale della variabile al termine dell'esecuzione deve essere restituito al chiamante dell'integrazione.
   Input e output dell'integrazione	Durante l'esecuzione, la variabile verrà fornita come input al trigger eseguito e il suo valore finale verrà restituito 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
      Doppia	30.5
      Boolean	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array di stringhe	Alex, Kai, Raha
      Array di numeri interi	30, 25, 22
      Doppio array	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:nessun 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 attivare la maschera per la variabile nei log di esecuzione dell'integrazione. Per attivare la maschera per la variabile, devi attivare le variabili di mascheramento per l'integrazione e la regione. Per informazioni su come attivare la maschera per l'integrazione e la regione, vedi Modificare un'integrazione e Modificare le regioni.

      Per informazioni sul mascheramento, vedi Mascherare 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 iniziata l'esecuzione, i dati di input vengono convertiti in un oggetto in memoria chiamato Evento.

Dopo aver creato l'oggetto Evento, viene creato un grafico 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 i dati nell'oggetto Evento,per essere utilizzati dalle attività successive o per formare i dati di output dell'integrazione.

Riferimenti alle variabili

Le attività, gli attivatori e i bordi 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 limite 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 l'integrazione.
• Scopri come mascherare i dati sensibili nei log.
• Aggiungere e configurare un'attività di mappatura dei dati