Attività di script per la trasformazione dei dati

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

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.

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 Sviluppa > 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 integration designer, 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 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 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:

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.

Attenzione:Jsonnet non consente l'utilizzo di trattini (-) nei nomi di identificatori. Ad esempio, il nome di una variabile o di una funzione. Se vuoi utilizzare un trattino (-) all'interno del nome di una variabile, questa deve essere dichiarata tra virgolette, come mostrato nell'esempio seguente.

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"
}

Salvaguardie

Best practice

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