Attività 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 nella tua integrazione.
Per informazioni sulla mappatura dei dati in Application Integration, consulta Panoramica della mappatura dei dati.
Configura l'attività Script per la trasformazione dei dati
Per aggiungere un'attività di script per la trasformazione dei dati all'integrazione, segui questi passaggi:
- Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
- Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, in cui sono elencate tutte le integrazioni disponibili nel progetto Google Cloud.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nel riquadro Crea integrazione.
- Seleziona una regione per l'integrazione.
- Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli di un account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti di integrazione.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor di integrazione.
- Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività disponibili.
- Fai clic sull'elemento Script per la trasformazione dei dati e posizionalo nell'editor di integrazione.
- 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.
- Fai clic su Apri editor di script per la trasformazione dei dati.
- Viene visualizzato l'editor di script per la trasformazione dei dati, che mostra un esempio di modello Jsonnet con commento predefinito.
- Scrivi il tuo codice Jsonnet e chiudi l'editor una volta completato. Le 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 access alle variabili di integrazione, eseguire assegnazioni di variabili e aggiungere o modificare variabili nell'integrazione. L'editor di script per la trasformazione dei dati offre le seguenti funzionalità per arricchire l'esperienza di scripting:
- Evidenziazione della sintassi/del codice, rientro e numerazione delle righe per una leggibilità del codice e un riconoscimento della struttura più semplici.
- Una mini mappa che mostra una panoramica generale del codice dello script e facilita la navigazione rapida.
- Opzione "Fai clic per copiare" 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.
L'editor di script per la trasformazione dei dati importa per impostazione predefinita functions
, una libreria personalizzata predefinita contenente un set di funzioni Jsonnet per la mappatura dei dati in Application Integration. Per maggiori dettagli sulle funzioni personalizzate disponibili, consulta Funzioni di trasformazione dati.
La seguente immagine mostra il layout di esempio dell'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
della libreria functions
predefinita.
Esempio: leggi e aggiorna 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
best practice
Per informazioni sui limiti di utilizzo che si applicano all'attività Script per la trasformazione dei dati, consulta Limiti di utilizzo.
Passaggi successivi
- Consulta Funzioni di trasformazione dati (anteprima)