Consulta i connettori supportati per Application Integration.
Attività JavaScript
L'attività JavaScript ti consente di scrivere snippet di codice JavaScript personalizzati per l'integrazione.
Utilizzando l'Editor JavaScript, puoi codificare una logica di mappatura dei dati complessa per l'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 consente una navigazione rapida.
- Evidenziazione della sintassi/del codice, rientro e numerazione delle righe per una maggiore leggibilità del codice e riconoscimento della struttura.
- Errore durante l'evidenziazione per trovare e monitorare gli errori nel codice.
- Comprimi ed espandi le regioni del codice dello script.
- Fai clic per copiare l'opzione per copiare il codice dello script negli appunti.
Configura l'attività JavaScript
Per aggiungere un'attività JavaScript all'integrazione, segui questi passaggi:
- Nella console Google Cloud, vai alla pagina Application Integration.
- 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.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nel riquadro Crea integrazione.
- Seleziona una regione per l'integrazione.
- 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.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor dell'integrazione.
- Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
- Fai clic e posiziona l'elemento JavaScript nell'editor di integrazione.
- Fai clic sull'elemento JavaScript nella finestra di progettazione per visualizzare il riquadro di configurazione dell'attività JavaScript.
- Fai clic su Apri editor di script per visualizzare e modificare l'editor JavaScript.
- Scrivi il codice JavaScript all'interno della funzione
executesScript(event)
creata automaticamente nell'Editor JavaScript. Chiudi l'editor una volta completato. Tutte le modifiche verranno salvate automaticamente.Per informazioni sull'accesso alle variabili di integrazione e sulle funzioni supportate, consulta Utilizzare l'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:
Utilizzare l'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. L'Editor JavaScript per impostazione predefinita contiene una funzione denominata executesScript(event)
, in cui:
-
executesScript()
: la funzione chiamata 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 di Access.
Motore di esecuzione di JavaScript
Application Integration utilizza il motore di esecuzione JavaScript basato su Rhino 1.7.14, che non supporta tutta la sintassi ES6: ad esempio, la dichiarazione di variabili con let
non è supportata. È supportato solo il completamento automatico della sintassi ES5. Per visualizzare tutta la sintassi ES6 supportata, consulta Supporto di Rhino ES2015.
Accedi alle variabili di integrazione
Puoi accedere alle variabili definite nell'integrazione dall'editor JavaScript utilizzando l'oggetto event in memoria dell'integrazione dell'applicazione.
I seguenti metodi sono supportati per accedere alle variabili di integrazione dall'editor JavaScript:
Nome funzione | Descrizione | Utilizzo | |
---|---|---|---|
|
Restituisce l'ID esecuzione dell'integrazione.
Tipo restituito: stringa |
Sintassi: Esempio: function executeScript(event) { event.getEventExecutionInfoId(); } |
|
|
Restituisce l'ID progetto Google Cloud.
Tipo restituito: stringa |
Sintassi:
Esempio: function executeScript(event) { event.getGcpProjectId(); } |
|
|
Restituisce il nome corrente dell'integrazione.
Tipo restituito: stringa |
Sintassi:
Esempio: function executeScript(event) { event.getIntegrationName(); } |
|
|
Restituisce il valore della variabile di integrazione fornita.
Tipo restituito: tipo di dati della variabile di integrazione. |
Sintassi:
Parametro di input: nome della variabile di integrazione. Se Esempio: function executeScript(event) { event.getParameter("var1"); } |
|
|
Restituisce il nome della regione di integrazione.
Tipo restituito: stringa |
Sintassi:
Esempio: function executeScript(event) { event.getRegion(); } |
|
|
Scrive il valore specificato nei log di esecuzione.
Per informazioni sulla visualizzazione dei log di esecuzione generati, consulta Log di esecuzione. |
Sintassi:
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"); } |
|
|
Imposta o aggiorna il valore di una variabile di integrazione. |
Sintassi:
Parametro di input: questa funzione accetta i seguenti argomenti:
Esempio: function executeScript(event) { event.setParameter("`responseBody`", "NewStringValue"); } |
Imposta parametri dell'attività
Se l'integrazione ha più parametri di grandi dimensioni che non vengono utilizzati dall'attività JavaScript, puoi impostare il campo TaskParameter
per l'attività JavaScript per migliorare il rendimento.
Per impostare il campo TaskParameter
per l'attività JavaScript, seleziona una delle seguenti opzioni:
Console
- Vai alla pagina Integrazione applicazioni.
- Seleziona un'integrazione. Si apre l'editor dell'integrazione.
- Fai clic su > Scarica integrazione > Versione integrazione. La versione dell'integrazione viene scaricata come file JSON. Azione
-
Apri il file della versione dell'integrazione in un editor, quindi:
-
Individua il campo
taskConfigs
con l'attivitàJavaScriptTask
. Nel campoparameters
, individua il parametro denominatoscript
."taskConfigs": [{ "task": "JavaScriptTask", "taskId": 1, "parameters": { "script": { "key": "script", "value": { "stringValue": "function that is called during the JavaScriptTask execution" } }" }]
-
In questo campo
parameters
, aggiungi i parametri utilizzati nel campoJavaScriptTask
utilizzando il seguente modello:"ParamName": { "key": "ParamName", "value": { "stringValue": "$ParamName$" } }
-
Individua il campo
- Salva le modifiche apportate al file della versione dell'integrazione.
- Carica il file della versione dell'integrazione nell'integrazione.
API
- Per scaricare la versione dell'integrazione, effettua una chiamata al metodo
projects.locations.integrations.versions.download
confilFormat
impostato suJSON
. -
Apri il file della versione dell'integrazione in un editor e poi procedi nel seguente modo:
-
Individua il campo
taskConfigs
con l'attivitàJavaScriptTask
. Nel campoparameters
, individua il parametro denominatoscript
."taskConfigs": [{ "task": "JavaScriptTask", "taskId": 1, "parameters": { "script": { "key": "script", "value": { "stringValue": "function that is called during the JavaScriptTask execution" } }" }]
-
In questo campo
parameters
, aggiungi i parametri utilizzati nel campoJavaScriptTask
utilizzando il seguente modello:"ParamName": { "key": "ParamName", "value": { "stringValue": "$ParamName$" } }
-
Individua il campo
- Per caricare la versione dell'integrazione, effettua una chiamata al metodo
projects.locations.integrations.versions.upload
con il file della versione dell'integrazione aggiornato.
Strategia di gestione degli errori
Una strategia di gestione degli errori per un'attività specifica l'azione da eseguire 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 l'articolo Strategie di gestione degli errori.
Quote e limiti
Per informazioni su quote e limiti, consulta Quote e limiti.
Passaggi successivi
- Scopri di più su tutte le attività e gli attivatori.
- Scopri come testare e pubblicare un'integrazione.
- Scopri di più sulla gestione degli errori.
- Scopri di più sui log di esecuzione dell'integrazione.