Consulta los conectores compatibles para Application Integration.

Tarea JavaScript

Obsoleto: A partir del 24 de enero de 2025, Application Integration ya no admitirá Rhino como motor de ejecución de JavaScript. Todas las tareas de JavaScript publicadas existentes seguirán usando Rhino y se pueden migrar a V8 de forma manual. Las tareas de JavaScript creadas recientemente usarán exclusivamente V8. Consulta el motor de ejecución de JavaScript para obtener más información.

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

Con el Editor de JavaScript, puedes codificar una lógica de asignación de datos compleja para tu integración, realizar asignaciones de variables y agregar o modificar variables de integración.

El Editor de JavaScript es compatible con las siguientes funciones:

• Un minimapa que muestra una descripción general de alto nivel del código de la secuencia de comandos y ayuda con la navegación rápida.
• Resaltado de sintaxis o código, sangría y numeración de líneas para facilitar la legibilidad del código y el reconocimiento de estructuras.
• Resaltado de errores para encontrarlos y hacer un seguimiento de ellos en el código.
• Plegado para expandir y contraer regiones del código de la secuencia de comandos.
• Opción de hacer clic para copiar el código de la secuencia de comandos en el portapapeles.

Configura la tarea de JavaScript

Para agregar una tarea JavaScript a tu integración, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

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

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

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa 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 enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes 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 en la barra de herramientas de la integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la gobernanza de integración para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
5. Haz clic y coloca el elemento JavaScript en el editor de integración.
6. Haz clic en el elemento JavaScript en el diseñador para ver el panel de configuración de tareas de 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. Para ello, haz clic en Secuencia de comandos con Gemini. Para obtener información sobre cómo usar Gemini para generar código JavaScript, consulta Cómo configurar tareas de JavaScript con la asistencia de Gemini.
8. Escribe tu código de JavaScript dentro de la función executesScript(event), que se crea de forma automática en el Editor de JavaScript. Cierra el editor una vez que se complete, y los cambios se guardarán automáticamente.
   Advertencia: No borres la función executesScript(event). Se llama a esta función cuando se ejecuta la tarea JavaScript.

   Para obtener información sobre cómo acceder a las variables de integración y las funciones compatibles, consulta Usa 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:

Usa el editor de JavaScript

Para ver y editar el Editor de JavaScript, ve al panel de configuración de tareas de JavaScript y haz clic en Abrir editor de secuencias de comandos. De forma predeterminada, el Editor de JavaScript contiene una función llamada executesScript(event), en la que se cumple lo siguiente:

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

  Para obtener información sobre los métodos compatibles del objeto event, consulta Variables de integración de acceso.

Advertencia: No borres la función executesScript(event). Se llama a esta función cuando se ejecuta la tarea JavaScript.

Motor de ejecución de JavaScript

Obsoleto: A partir del 24 de enero de 2025, Application Integration ya no admitirá Rhino como motor de ejecución de JavaScript. Todas las tareas de JavaScript publicadas existentes seguirán usando Rhino y se pueden migrar a V8 de forma manual. Las tareas de JavaScript creadas recientemente usarán exclusivamente V8.

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

Beneficios de V8

El motor de JavaScript V8 ofrece los siguientes beneficios:

• Rendimiento: V8 es mucho más rápido que Rhino, lo que mejora las velocidades de ejecución de tus tareas de JavaScript. Las secuencias de comandos con variables de gran tamaño y cálculos complejos se pueden ejecutar más rápido.
• Cumplimiento de estándares: V8 admite ECMAScript 2024, lo que garantiza una mejor compatibilidad y mantenibilidad.
• 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 construcciones y bibliotecas de lenguaje modernas.

Cómo migrar tareas de JavaScript existentes a V8

Para migrar tus tareas de JavaScript existentes que se ejecutan en Rhino a V8, haz lo siguiente:

1. Identifica las integraciones publicadas que contienen tareas de JavaScript y anula su publicación.
2. Para cada JavaScript, haz clic en Abrir editor de secuencias de comandos en el panel de configuración de tareas.

   Application Integration actualiza automáticamente la secuencia de comandos existente para usar V8.

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

Accede a variables de integración

Se puede acceder a las variables definidas en tu integración desde el Editor de JavaScript mediante el objeto de evento en la memoria de Integration for Applications.

Los siguientes métodos son compatibles con el acceso a las variables de integración desde tu Editor de JavaScript:

Nombre de la función	Descripción	Uso
getEventExecutionInfoId	Muestra el ID de ejecución de ejecución de la integración. Tipo de datos que se muestra: String	Sintaxis: event.getEventExecutionInfoId() Ejemplo: function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Muestra el ID del proyecto de Google Cloud. Tipo de datos que se muestra: String	Sintaxis: event.getGoogleCloudProjectId() Ejemplo: function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Muestra el nombre actual de la integración. Tipo de datos que se muestra: String	Sintaxis: event.getIntegrationName Ejemplo: function executeScript(event) { event.getIntegrationName(); }
getParameter	Muestra el valor de la variable de integración proporcionada. Tipo de datos: tipo de datos de la variable de integración	Sintaxis: event.getParameter("variable_name") Parámetro de entrada: Es el nombre de la variable de integración. Si variable_name es una variable generada automáticamente, colócala entre acentos graves (``). Por ejemplo, `responseBody`. Ejemplo: function executeScript(event) { event.getParameter("var1"); }
getRegion	Muestra el nombre de la región de integración. Tipo de datos que se muestra: String	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	Establece o actualiza el valor de una variable de integración.	Sintaxis: event.setParameter("variable_name", "variable_value") Parámetro de entrada: Esta función toma los siguientes argumentos: Primer argumento: nombre de la variable. Si variable_name es una variable generada automáticamente, colócala entre acentos graves (``). Por ejemplo, `responseBody`. Segundo argumento: valor. Ejemplo: function executeScript(event) { event.setParameter("`responseBody`", "NewStringValue"); }

Establece parámetros de tareas

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

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

Console

1. Ve a la página Application Integration.

   Ve a Application Integration

2. Selecciona una integración. Se abrirá el editor de integración.
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 integración en un editor y, luego, haz lo siguiente:
   1. Busca el campo taskConfigs con la tarea como JavaScriptTask. En el campo parameters, busca 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, agrega 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 realizaste en el archivo de versión de integración.
6. Sube el archivo de versión de integración a la integración.

API

1. Para descargar la versión de integración, realiza una llamada al método projects.locations.integrations.versions.download con el filFormat configurado como JSON.
2. Abre el archivo de versión de integración en un editor y, luego, haz lo siguiente:
   1. Busca el campo taskConfigs con la tarea como JavaScriptTask. En el campo parameters, busca 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, agrega 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 integración, realiza una llamada al método projects.locations.integrations.versions.upload con el archivo de versión de integración actualizado.

Estrategia de manejo de errores

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

Cuotas y límites

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

¿Qué sigue?

• Obtén información sobre lo siguiente:
  • Cómo configurar tareas de JavaScript con la asistencia de Gemini
  Todas las tareas y los activadores
  • Prueba y publica integraciones
  • Manejo de errores
  • Registros de ejecución de integración