Consulta los conectores compatibles con Application Integration.

Tarea de JavaScript

Obsoleto: A partir del 24 de enero del 2025, Application Integration dejará de admitir Rhino como motor de ejecución de JavaScript. Todas las tareas de JavaScript publicadas seguirán usando Rhino y se podrán migrar a V8 manualmente. Las tareas de JavaScript que se creen a partir de ahora usarán exclusivamente V8. Consulta más información sobre el motor de ejecución de JavaScript.

La tarea JavaScript te permite escribir fragmentos de código JavaScript personalizados para tu integración.

Con el editor de JavaScript, puede codificar una lógica de asignación de datos compleja para su integración, asignar variables y añadir o modificar variables de integración.

El editor de JavaScript admite las siguientes funciones:

• Un minimapa que muestra una vista general del código de la secuencia de comandos y ayuda a desplazarse rápidamente por él.
• Resaltado de sintaxis o código, sangría y numeración de líneas para facilitar la lectura del código y el reconocimiento de la estructura.
• Resaltado de errores para encontrar y monitorizar errores en el código.
• Plegado para desplegar y contraer regiones del código de la secuencia de comandos.
• Opción para copiar el código de la secuencia de comandos en el portapapeles con un solo clic.

Configurar la tarea de JavaScript

Para añadir una tarea de JavaScript a tu integración, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
5. Haz clic en el elemento JavaScript y colócalo en el editor de integración.
6. Haga clic en el elemento JavaScript del diseñador para ver el panel de configuración de tareas JavaScript.
7. Haz clic en Abrir editor de secuencias de comandos para ver y editar el editor de JavaScript. También puedes usar Gemini para generar código JavaScript haciendo clic en Secuencia de comandos con Gemini. Para obtener información sobre cómo usar Gemini para generar código JavaScript, consulta Configurar tareas de JavaScript con la ayuda de Gemini.
8. Escribe el código JavaScript dentro de la función executesScript(event) que se crea automáticamente en el editor de JavaScript. Cuando hayas terminado, cierra el editor. Los cambios se guardarán automáticamente.
   Advertencia: No elimines la función executesScript(event). Esta función se llama cuando se ejecuta la tarea JavaScript.

   Para obtener información sobre cómo acceder a las variables de integración y a las funciones admitidas, consulta el artículo Usar el editor de JavaScript.

   Para obtener información sobre cómo ver los registros de ejecución generados, consulta Registros de ejecución.

En la siguiente imagen se muestra un ejemplo de diseño del editor de JavaScript:

Usar el editor de JavaScript

Para ver y editar el editor de JavaScript, ve al panel de configuración de la tarea JavaScript y haz clic en Abrir editor de secuencias de comandos. El editor de JavaScript contiene de forma predeterminada una función llamada executesScript(event), donde:

• executesScript(): la función a la que se llama cuando Application Integration ejecuta la tarea JavaScript durante la ejecución de una integración.
• event: el objeto en memoria de Application Integration.

  Para obtener información sobre los métodos admitidos del objeto event, consulte Acceder a variables de integración.

Advertencia: No elimines la función executesScript(event). Esta función se llama cuando se ejecuta la tarea JavaScript.

Motor de ejecución de JavaScript

Obsoleto: A partir del 24 de enero del 2025, Application Integration dejará de admitir Rhino como motor de ejecución de JavaScript. Todas las tareas de JavaScript publicadas seguirán usando Rhino y se podrán migrar a V8 manualmente. Las tareas de JavaScript que se creen a partir de ahora usarán exclusivamente V8.

Application Integration admitía Rhino como motor de ejecución de JavaScript para ejecutar tareas de JavaScript. Para aprovechar las ventajas de rendimiento y seguridad del motor JavaScript de alto rendimiento y de código abierto de Google, Rhino dejará de estar disponible y todas las ejecuciones de JavaScript utilizarán V8, el motor JavaScript de alto rendimiento y de código abierto de Google.

Ventajas de V8

El motor JavaScript V8 ofrece las siguientes ventajas:

• Rendimiento: V8 es significativamente más rápido que Rhino, lo que mejora la velocidad de ejecución de tus tareas de JavaScript. Los scripts con variables de gran tamaño y cálculos complejos se pueden ejecutar más rápido.
• Cumplimiento de los estándares: V8 es compatible con ECMAScript 2024, lo que garantiza una mayor compatibilidad y facilidad de mantenimiento.
• Seguridad: V8 se beneficia de las actualizaciones y mejoras de seguridad continuas, lo que proporciona un entorno más seguro para tus integraciones.
• Funciones modernas: V8 admite las funciones más recientes de JavaScript, lo que te permite aprovechar las estructuras y bibliotecas de lenguaje modernas.

Migrar tareas de JavaScript a V8

Para migrar las tareas de JavaScript que se ejecutan en Rhino a V8, sigue estos pasos:

1. Identifica las integraciones publicadas que contengan tareas de JavaScript y anula su publicación.
2. En cada JavaScript, haga clic en Abrir editor de secuencias de comandos en el panel de configuración de la tarea.

   Integración de aplicaciones actualiza automáticamente la secuencia de comandos para usar V8.

3. Revisa y prueba el código JavaScript.
4. Publica las integraciones.

Acceder a las variables de integración

Se puede acceder a las variables definidas en su integración desde el editor de JavaScript mediante el objeto event en memoria de la integración de aplicaciones.

Se pueden usar los siguientes métodos para acceder a las variables de integración desde el editor de JavaScript:

Nombre de la función	Descripción	Uso
getEventExecutionInfoId	Devuelve el ID de ejecución de la integración. Tipo de valor devuelto: cadena	Sintaxis: event.getEventExecutionInfoId() Ejemplo: function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Devuelve el ID del proyecto de Google Cloud. Tipo de valor devuelto: cadena	Sintaxis: event.getGoogleCloudProjectId() Ejemplo: function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Devuelve el nombre actual de la integración. Tipo de valor devuelto: cadena	Sintaxis: event.getIntegrationName Ejemplo: function executeScript(event) { event.getIntegrationName(); }
getParameter	Devuelve el valor de la variable de integración proporcionada. Tipo de valor devuelto: tipo de datos de la variable de integración	Sintaxis: event.getParameter("variable_name") Parámetro de entrada: nombre de la variable de integración. Si variable_name es una variable generada automáticamente, encierra la variable entre comillas inversas (``). Por ejemplo, `responseBody`. Ejemplo: function executeScript(event) { event.getParameter("var1"); }
getRegion	Devuelve el nombre de la región de integración. Tipo de valor devuelto: cadena	Sintaxis: event.getRegion() Ejemplo: function executeScript(event) { event.getRegion(); }
log	Escribe el valor especificado en los registros de ejecución. Para obtener información sobre cómo ver los registros de ejecución generados, consulta Registros de ejecución.	Sintaxis: event.log(value) Parámetro de entrada: cualquier variable o función que se use en la secuencia de comandos. Ejemplo 1: function executeScript(event) { event.log(event.getParameter("var1")); } Ejemplo 2: function executeScript(event) { event.log("Lorem ipsum"); }
setParameter	Define o actualiza el valor de una variable de integración.	Sintaxis: event.setParameter("variable_name", "variable_value") Parámetro de entrada: esta función usa los siguientes argumentos: Primer argumento: nombre de la variable. Si variable_name es una variable generada automáticamente, encierra la variable entre comillas inversas (``). Por ejemplo, `responseBody`. Segundo argumento: valor. Ejemplo: function executeScript(event) { event.setParameter("`responseBody`", "NewStringValue"); }

Definir parámetros de tarea

Si tu integración tiene varios parámetros de gran tamaño que no usa la tarea de JavaScript, puedes definir el campo TaskParameter de la tarea de JavaScript para mejorar el rendimiento.

Para definir el campo TaskParameter de la tarea de JavaScript, selecciona una de las siguientes opciones:

Consola

1. Ve a la página Integración de aplicaciones.

   Ir a Application Integration

2. Selecciona una integración. Se abrirá el editor de integraciones.
3. Haz clic en Acción > Descargar integración > Versión de integración. La versión de la integración se descarga como un archivo JSON.
4. Abre el archivo de versión de la integración en un editor y haz lo siguiente:
   1. Busca el campo taskConfigs con la tarea JavaScriptTask. En el campo parameters, busque el parámetro llamado script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. En este campo parameters, añada los parámetros que se usan en el campo JavaScriptTask con la siguiente plantilla:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

5. Guarda los cambios que hayas hecho en el archivo de versión de integración.
6. Sube el archivo de la versión de la integración a la integración.

API

1. Para descargar la versión de la integración, llama al método projects.locations.integrations.versions.download con el valor de filFormat definido como JSON.
2. Abre el archivo de versión de la integración en un editor y haz lo siguiente:
   1. Busca el campo taskConfigs con la tarea JavaScriptTask. En el campo parameters, busque el parámetro llamado script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. En este campo parameters, añada los parámetros que se usan en el campo JavaScriptTask con la siguiente plantilla:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

3. Para subir la versión de la integración, llama al método projects.locations.integrations.versions.upload con el archivo de la versión actualizada de la integración.

Estrategia de gestión de errores

Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos

• Consulta la siguiente información:
  • Configurar tareas de JavaScript con la ayuda de Gemini
  Todas las tareas y los activadores
  • Probar y publicar integraciones
  • Gestión de errores
  • Registros de ejecución de la integración