Attività di script per la trasformazione dei dati

L'attività Script per la trasformazione dei dati consente di scrivere, modificare e valutare modelli Jsonnet personalizzati per eseguire la mappatura dei dati nell'integrazione.

Per informazioni sulla mappatura dei dati in Apigee Integration, consulta la panoramica sulla mappatura dei dati.

Configura l'attività di script per la trasformazione dei dati

Per aggiungere un'attività di script per la trasformazione dei dati all'integrazione, segui questi passaggi:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > Integrazioni.
  3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
    2. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
    3. Fai clic su Crea.

    Viene aperta l'integrazione nel designer dell'integrazione.

  4. Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un attivatore > Tasks per visualizzare l'elenco delle attività disponibili.
  5. Fai clic sull'elemento Data Transformer Script e posizionalo nell'editor dell'integrazione.
  6. Fai clic sull'elemento Script per la trasformazione dei dati nel designer per visualizzare il riquadro di configurazione dell'attività Script per la trasformazione dei dati.
  7. Fai clic su Apri editor di script per la trasformazione dei dati.
  8. Viene visualizzato l'editor di script per la trasformazione dei dati con un esempio di modello Jsonnet commentato predefinito.
  9. Scrivi il codice Jsonnet e chiudi l'editor al termine. Eventuali modifiche verranno salvate automaticamente.

Utilizzo dell'editor di script per la trasformazione dei dati

Puoi utilizzare l'editor di script per la trasformazione dei dati per accedere alle variabili di integrazione, eseguire assegnazioni di variabili e aggiungere o modificare variabili nell'integrazione. L'editor di script per la trasformazione dei dati fornisce le seguenti funzionalità per arricchire la tua esperienza di scripting:

  • Evidenziazione di sintassi/codice, rientro e numerazione di riga per semplificare la leggibilità del codice e il riconoscimento della struttura.
  • Una mini mappa che mostra una panoramica generale del codice dello script e consente una navigazione rapida.
  • Fai clic per copiare l'opzione per copiare il codice dello script negli appunti.

Per aprire l'editor, vai al riquadro di configurazione dell'attività Script per la trasformazione dei dati e fai clic su Apri editor di script per la trasformazione dei dati.

Per impostazione predefinita, l'editor di script per la trasformazione dei dati importa functions, una libreria personalizzata predefinita contenente un set di funzioni Jsonnet per la mappatura dei dati in Apigee Integration. Per maggiori dettagli sulle funzioni personalizzate disponibili, vedi Funzioni del Trasformatore dati.

L'immagine seguente mostra il layout di esempio dell'editor di script per la trasformazione dei dati:

immagine che mostra l'editor di script per la trasformazione dei dati immagine che mostra l'editor di script per la trasformazione dei dati

Accedi alle variabili di integrazione

Per leggere una variabile di integrazione esistente dall'editor di script per la trasformazione dei dati, utilizza la funzione extVar dalla libreria functions predefinita.

Esempio: leggere e aggiornare le variabili di integrazione esistenti utilizzando l'editor di script per la trasformazione dei dati.

Script jsonnet

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

Output

immagine che mostra un esempio di script per la trasformazione dei dati immagine che mostra un esempio di script per la trasformazione dei dati

Best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Script per la trasformazione dei dati, vedi Limiti di utilizzo.