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 Application Integration, vedi Panoramica della 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. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

    Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
    4. Fai clic su Crea.

    L'integrazione viene aperta nell'editor dell'integrazione.

  4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
  5. Fai clic e posiziona l'elemento Script per la trasformazione dei dati nell'editor di 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 offre le seguenti funzionalità per arricchire la tua esperienza di scripting:

  • Evidenziazione della sintassi/del codice, rientro e numerazione delle righe per una maggiore leggibilità del codice e 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 insieme di funzioni Jsonnet per la mappatura dei dati in Application Integration. Per informazioni dettagliate sulle funzioni personalizzate disponibili, consulta Funzioni di Data Transformer.

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: 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

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

Informazioni sull'utilizzo di Jsonnet

Jsonnet è un linguaggio puramente funzionale e i suoi programmi sono composti da espressioni. Per informazioni su come formare queste espressioni, consulta Espressioni Jsonnet.

Quote e limiti

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

Passaggi successivi