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 di sintassi/codice, rientro e numerazione di riga per semplificare la leggibilità del codice e il riconoscimento della struttura.
  • Errore durante l'evidenziazione per trovare e monitorare gli errori nel codice.
  • Piegare per espandere e comprimere 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:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > 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 del designer dell'integrazione, fai clic su +Aggiungi un'attività/un attivatore > Tasks per visualizzare l'elenco delle attività disponibili.
  5. Fai clic e posiziona l'elemento JavaScript nell'editor dell'integrazione.
  6. Fai clic sull'elemento JavaScript nella finestra di progettazione 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. 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: immagine che mostra l'editor JavaScript immagine che mostra l'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 che viene chiamata quando Apigee Integration esegue l'attività JavaScript durante l'esecuzione di un'integrazione.
  • event: l'oggetto in memoria di Apigee Integration.

    Per informazioni sui metodi supportati dell'oggetto event, vedi Accedere alle variabili di integrazione.

Motore di esecuzione di JavaScript

Apigee 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 tutte le sintassi supportate per ES6, vedi Assistenza di Rhino ES2015.

Accedi alle variabili di integrazione

È possibile accedere alle variabili definite nell'integrazione dall'Editor JavaScript utilizzando l'oggetto evento in memoria di Apigee Integration.

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

Nome funzione Descrizione Utilizzo

getEventExecutionInfoId

 Restituisce l'ID 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: tipo di dati della variabile di integrazione.

Sintassi: event.getParameter("variable_name")

Parametro di input: nome della variabile di integrazione. Se variable_name è una variabile generata automaticamente, racchiudila tra apici inversi (``). Ad esempio, `responseBody`.

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("variable_name", "variable_value")

Parametro di input: questa funzione accetta i seguenti argomenti:

  • Primo argomento: nome della variabile. Se variable_name è una variabile generata automaticamente, racchiudila tra apici inversi (``). Ad esempio, `responseBody`.
  • Secondo argomento: valore.

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 le prestazioni.

Per impostare il campo TaskParameter per l'attività JavaScript, seleziona una delle seguenti opzioni:

Console

  1. Vai alla pagina Application Integration.

    Vai ad Application Integration

  2. Seleziona un'integrazione. Si apre l'editor dell'integrazione.
  3. Fai clic su Azione > Scarica integrazione > Versione integrazione. La versione dell'integrazione viene scaricata come file JSON.
  4. Apri il file della versione dell'integrazione in un editor, quindi:
    1. Individua il campo taskConfigs con l'attività JavaScriptTask. Nel campo parameters, individua il parametro denominato script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. In questo campo parameters, aggiungi i parametri utilizzati nel campo JavaScriptTask usando il seguente modello: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  5. Salva le modifiche apportate al file della versione dell'integrazione.
  6. Carica il file della versione dell'integrazione nell'integrazione.

API

  1. Per scaricare la versione dell'integrazione, effettua una chiamata al metodo projects.locations.integrations.versions.download con filFormat impostato su JSON.
  2. Apri il file della versione dell'integrazione in un editor, quindi:
    1. Individua il campo taskConfigs con l'attività JavaScriptTask. Nel campo parameters, individua il parametro denominato script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. In questo campo parameters, aggiungi i parametri utilizzati nel campo JavaScriptTask usando il seguente modello: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  3. 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 Strategie di gestione degli errori.