Anteprima - Data Transformer Script task

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. 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.

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:

1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

   Vai ad Application Integration

2. 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.

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.
      Nota:nel menu a discesa Regioni sono elencate solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. 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.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance di integrazione per la regione selezionata.
   4. Fai clic su Crea.

   L'integrazione viene aperta nell'editor di integrazione.

4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività disponibili.
5. Fai clic sull'elemento Script per la trasformazione dei dati e posizionalo 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, che mostra un esempio di modello Jsonnet con commento predefinito.
9. 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.

Attenzione: Jsonnet non consente l'utilizzo dei trattini (-) come parte del nome di un identificatore. Ad esempio, il nome di una variabile o di una funzione. Se vuoi utilizzare un trattino (-) nel nome di una variabile, quest'ultima deve essere dichiarata tra virgolette doppie, come mostrato nell'esempio seguente.

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)