Consulta i connettori supportati per Application Integration.

Attività JavaScript

L'attività JavaScript ti consente di scrivere snippet di codice JavaScript personalizzati per la tua integrazione.

Con l'Editor JavaScript, puoi codificare logiche di mappatura dei dati complesse per la tua integrazione, eseguire assegnazioni di variabili e aggiungere o modificare variabili di integrazione.

L'Editor JavaScript supporta le seguenti funzionalità:

• Una mini mappa che mostra una panoramica generale del codice dello script e facilita la navigazione rapida.
• Evidenziazione della sintassi/del codice, rientro e numerazione delle righe per una leggibilità del codice e un riconoscimento della struttura più semplici.
• Errore durante l'evidenziazione per trovare e monitorare gli errori nel codice.
• Compressione per espandere e comprimere le regioni del codice dello script.
• Opzione "Fai clic per copiare" per copiare il codice dello script negli appunti.

Configura l'attività JavaScript

Per aggiungere un'attività JavaScript 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 JavaScript e posizionalo nell'editor di integrazione.
6. Fai clic sull'elemento JavaScript nel designer per visualizzare il riquadro di configurazione dell'attività JavaScript.
7. Fai clic su Apri editor di script per visualizzare e modificare l'Editor JavaScript.
8. Scrivi il codice JavaScript all'interno della funzione executesScript(event) creata automaticamente nell'Editor JavaScript. Al termine, chiudi l'editor e le eventuali modifiche verranno salvate automaticamente.
   Avviso: non eliminare la funzione executesScript(event). Questa funzione viene richiamata quando viene eseguita l'attività JavaScript.

   Per informazioni sull'accesso alle variabili di integrazione e alle funzioni supportate, consulta Utilizzo dell'editor JavaScript.

   Per informazioni sulla visualizzazione dei log di esecuzione generati, consulta Log di esecuzione.

L'immagine seguente mostra un layout di esempio dell'editor JavaScript:

Utilizzo dell'editor JavaScript

Per visualizzare e modificare l'Editor JavaScript, vai al riquadro di configurazione dell'attività JavaScript e fai clic su Apri editor di script. Per impostazione predefinita, l'Editor JavaScript contiene una funzione denominata executesScript(event).

Dove:

• executesScript() è la funzione che viene richiamata quando Application Integration esegue l'attività JavaScript durante l'esecuzione di un'integrazione.
• event è l'oggetto in memoria di Application Integration.

  Per informazioni sui metodi supportati dell'oggetto event, consulta Variabili di integrazione dell'accesso.

Avviso: non eliminare la funzione executesScript(event). Questa funzione viene richiamata quando viene eseguita l'attività JavaScript.

Il motore di esecuzione JavaScript utilizzato da Application Integration si basa su Rhino 1.7.14, che non supporta tutta la sintassi ES6. È supportato soltanto il completamento automatico della sintassi ES5. Per visualizzare tutta la sintassi ES6 supportata, consulta il Supporto di Rhino ES2015.

Accedi alle variabili di integrazione

È possibile accedere alle variabili definite nella tua integrazione dall'Editor JavaScript utilizzando l'oggetto event in memoria di Application Integration.

Per accedere alle variabili di integrazione dall'Editor JavaScript sono supportati i seguenti metodi:

1. getEventExecutionInfoId
2. getGoogleCloudProjectId
3. getIntegrationName
4. getParameter
5. getRegion
6. log
7. setParameter

Nome funzione	Descrizione	Utilizzo
getEventExecutionInfoId	Restituisce l'ID esecuzione di esecuzione dell'integrazione. Tipo restituito: stringa	Sintassi: event.getEventExecutionInfoId() Esempio: function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Restituisce l'ID progetto Google Cloud. Tipo restituito: stringa	Sintassi: event.getGoogleCloudProjectId() Esempio: function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Restituisce il nome corrente dell'integrazione. Tipo restituito: stringa	Sintassi: event.getIntegrationName Esempio: function executeScript(event) { event.getIntegrationName(); }
getParameter	Restituisce il valore della variabile di integrazione fornita. Tipo restituito: il tipo di dati della variabile di integrazione.	Sintassi: event.getParameter("value") Parametro di input:nome della variabile di integrazione. Esempio: function executeScript(event) { event.getParameter("var1"); }
getRegion	Restituisce il nome della regione di integrazione. Tipo restituito: stringa	Sintassi: event.getRegion() Esempio: function executeScript(event) { event.getRegion(); }
log	Scrive il valore specificato nei log di esecuzione. Per informazioni sulla visualizzazione dei log di esecuzione generati, consulta Log di esecuzione.	Sintassi: event.log(value) Parametro di input:qualsiasi variabile o funzione utilizzata nello script. Esempio 1: function executeScript(event) { event.log(event.getParameter("var1")); } Esempio 2: function executeScript(event) { event.log("Lorem ipsum"); }
setParameter	Imposta o aggiorna il valore di una variabile di integrazione.	Sintassi: event.setParameter(value, value) Parametro di input:questa funzione accetta i seguenti argomenti: Primo argomento: nome variabile. Secondo argomento: valore. Esempio: function executeScript(event) { event.setParameter("var1", "NewStringValue"); }

Strategia di gestione degli errori

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