Consulta i connettori supportati per Application Integration.

Attività di Data Transformer

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e 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à Data Transformer (Trasformatore dati) offre due modalità, Diagramma e Script, per trasformare i dati. Nella modalità Diagramma, utilizzi un riquadro di mappatura visiva, chiamato editor di Data Transformer, per eseguire assegnazioni e mappature dei dati nell'integrazione. Inoltre, puoi utilizzare le trasformazioni supportate per trasformare i dati in variabili e formati significativi e renderli accessibili alle altre attività o agli altri trigger dell'integrazione. Nella modalità Script, puoi 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 trasformazione dei dati

Per aggiungere un'attività di trasformazione dei dati all'integrazione, svolgi i seguenti 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.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   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.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   Viene visualizzata l'integrazione nell'editor di 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 Trasformatore dati nell'editor di integrazione.
6. Fai clic sull'elemento Trasformatore dati per visualizzare il riquadro di configurazione dell'attività.
7. Fai clic su Apri editor di Data Transformer. Nella pagina Editor di attività di Data Transformer (anteprima), seleziona una delle seguenti opzioni:
• Per impostazione predefinita, si apre la modalità Diagramma. La modalità Diagramma offre un'esperienza basata su console per selezionare le variabili di input e di output ed eseguire trasformazioni nell'editor di trasformazione dei dati.

  In modalità Diagramma, puoi eseguire visivamente la mappatura dei dati tra le variabili di input e di output.

• Per eseguire trasformazioni dei dati nell'integrazione scrivendo, modificando e valutando modelli Jsonnet personalizzati, vai alla modalità script facendo clic su Script. Puoi utilizzare la modalità Script se hai requisiti di trasformazione dei dati complessi e se vuoi utilizzare le funzioni Jsonnet.

  Viene visualizzato l'editor del trasformatore di dati, che mostra un esempio di modello Jsonnet commentato predefinito. Scrivi il codice Jsonnet e chiudi l'editor al termine. Eventuali modifiche verranno salvate automaticamente.

Per la procedura dettagliata sull'aggiunta di una mappatura, vedi Aggiungere una mappatura.

Aggiungere una mappatura

Per aggiungere una mappatura, puoi utilizzare la modalità Diagramma o la modalità Script.

Utilizzare la modalità Diagramma

La modalità Diagramma offre un'esperienza basata su console per selezionare le variabili di input e di output ed eseguire trasformazioni nell'editor di trasformazione dei dati. Per aggiungere la mappatura utilizzando la modalità Diagramma:

1. Nel riquadro di configurazione dell'attività di trasformazione dei dati, fai clic su Apri editor di trasformazione dei dati.

   Per impostazione predefinita, è aperta la modalità Diagramma.

   

2. Per aggiungere la variabile di input per la mappatura, fai clic su + Aggiungi input. Viene visualizzata la finestra di dialogo Scegli variabile di input o valore. La scheda Variabile è selezionata per impostazione predefinita.
   Input: origine dell'input della trasformazione dei dati. L'origine può essere un valore letterale, una funzione di base o una variabile di input con funzioni di mappatura.

   

   Poi:

   1. Nell'elenco Seleziona una o più variabili, seleziona le variabili di input. Se vuoi creare una nuova variabile, fai clic su + Aggiungi nuova variabile.
   2. Fai clic su Invia.

   Se vuoi aggiungere una costante, fai clic sulla scheda Costante.

   A differenza delle variabili, le costanti non sono accessibili ad altri trigger o attività nell'integrazione e possono essere utilizzate solo nell'attività Trasformazione dei dati in cui vengono create. Ad esempio, puoi utilizzare le costanti per aggiungere delimitatori o mappare un valore costante a una variabile.

   

   Poi:

   1. Nel campo Identificatore costante, inserisci il nome della costante.
   2. Nell'elenco Tipo di dati, seleziona uno dei seguenti tipi di dati:
      • Stringa
      • Valore booleano
      • Numero
   3. Nel campo Inserisci il valore costante, inserisci il valore.
   4. Fai clic su Invia.
3. Per aggiungere la variabile di output per la mappatura, fai clic su + Aggiungi output e seleziona la variabile di output o creane una nuova.

   

4. Configura la mappatura:
   1. Aggiungi una mappatura da una variabile o dal relativo sottocampo dell'elenco Variabili nella sezione Input alla variabile o al relativo sottocampo dell'elenco Variabili nella sezione Output.

      

   2. Per aggiungere una funzione di trasformazione, passa il mouse sopra la riga di mappatura e fai clic su per aggiungere la funzione di trasformazione dei dati. Nel canvas viene visualizzato il pulsante Trasformazione.

      In alternativa, puoi fare clic su Aggiungi trasformazione per aggiungere la funzione di trasformazione.

      Poi:

      1. Per aggiungere la trasformazione, fai clic sul pulsante Trasformazione. Viene visualizzato il riquadro Trasformazione.

         

         Poi:

         1. Fai clic su + Aggiungi operazione. Viene visualizzata la finestra di dialogo Aggiungi operazione.

            

         2. Nel campo Operazioni di ricerca, inserisci l'operazione che vuoi aggiungere. In alternativa, puoi selezionare l'operazione dall'elenco delle operazioni.

            Se vuoi aggiungere un'operazione personalizzata, seleziona Espressione funzione e inserisci l'espressione funzione. Per copiare le variabili, fai clic su nell'elenco Variabili e incollale nell'editor di espressioni.

            

         3. Fai clic su Fine.
      2. A seconda dell'operazione, compila i dettagli richiesti. Se vuoi, puoi aggiungere più operazioni in una trasformazione. Se vuoi scegliere il risultato dell'operazione precedente nell'operazione successiva, seleziona la variabile Risultato operazione precedente come mostrato nell'immagine seguente:

         

      3. Per rimuovere l'operazione, fai clic su Elimina accanto all'operazione.
   3. Se vuoi, puoi aggiungere la mappatura da più variabili di input a una funzione di trasformazione. Tuttavia, è possibile aggiungere una sola mappatura per ogni variabile di output di una funzione di trasformazione.
   4. Per rimuovere le variabili di input e di output, fai clic su > Elimina.
   5. Se vuoi, per eliminare una riga di mappatura o una trasformazione, seleziona la mappatura e premi Elimina.
   6. Una volta completata la mappatura, chiudi Editor di mappatura dei dati. Eventuali modifiche verranno salvate automaticamente.

   Esempio: mappatura di un vecchio sistema di gestione dei ticket relativi ai bug a un nuovo sistema di ticket

   Supponiamo che tu abbia un sistema legacy per la gestione dei bug di cui vuoi eseguire la migrazione a un nuovo sistema. Puoi utilizzare l'opzione Diagramma per mappare i campi dal vecchio al nuovo sistema, come mostrato nell'immagine seguente:

   

   Per aggiungere un valore costante per uno dei campi, fai clic su Aggiungi input e aggiungi una nuova costante. Puoi mappare la costante appena aggiunta dalla sezione Input al campo nella sezione Output.

   

   Per aggiungere la trasformazione per i campi che non possono essere mappati direttamente, fai clic su Trasformazione e aggiungi l'operazione di trasformazione facendo clic su + Aggiungi operazione:

   

   Al termine della trasformazione, puoi eseguire l'integrazione per mappare il vecchio sistema di ticketing al nuovo sistema.

   Utilizzare la modalità Script

   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 le 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 di alto livello del codice dello script e consente una navigazione rapida.
   • Opzione di copia tramite clic 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:

   

   Accedere 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 di trattini (-) all'interno del nome di un identificatore. Ad esempio, un nome di variabile o di funzione. Se vuoi utilizzare un trattino (-) all'interno del nome di una variabile, la variabile 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

   

   Riferimento all'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.

   Strategia di gestione degli errori

   Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non va a buon fine a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e sui diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.

   Quote e limiti

   Per informazioni sui limiti di utilizzo che si applicano all'attività Data Transformer, consulta Limiti di utilizzo.

   Passaggi successivi

   • Scopri di più su:
     • Tutte le attività e gli attivatori.
     • Funzioni di Data Transformer (anteprima)
     • Test e pubblicazione delle integrazioni.
     • Gestione degli errori.
     • Log di esecuzione dell'integrazione.