Consulta los conectores compatibles con Application Integration.
Tarea JavaScript
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:
- En la consola de Google Cloud, ve a la página Application Integration.
- 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.
- 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:
- Ingresa un nombre y una descripción en el panel Crear integración.
- Selecciona una región para la integración.
- 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 Integration summary de la barra de herramientas de integración.
- Haz clic en Crear.
Esto abrirá la integración en la página del editor de integración.
- En la barra de navegación del editor de integración, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
- Haz clic y coloca el elemento JavaScript en el editor de integración.
- Haz clic en el elemento JavaScript en el diseñador para ver el panel de configuración de tareas de JavaScript.
- Haz clic en Abrir editor de secuencias de comandos para ver y editar el Editor de JavaScript.
- 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.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:
Cómo usar 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:
-
executesScript()
: Es la función a la que se llama cuando Application Integration ejecuta la tarea de JavaScript durante la ejecución de una integración. -
event
: Es el objeto en la memoria de Application Integration.Para obtener información sobre los métodos compatibles del objeto event, consulta Variables de integración de acceso.
Motor de ejecución de JavaScript
Application Integration usa el motor de ejecución de JavaScript basado en Rhino 1.7.14, que no admite toda la sintaxis ES6; por ejemplo, no se admite la declaración de variables con let
. Solo se admite el autocompletado de la sintaxis ES5. Para ver toda la sintaxis de ES6 compatible, consulta Asistencia de Rhino ES2015.
Accede a variables de integración
Se puede acceder a las variables definidas en tu integración desde el editor de JavaScript a través del objeto event de Application Integration.
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 | |
---|---|---|---|
|
Muestra el ID de ejecución de ejecución de la integración.
Tipo de datos que se muestra: String |
Sintaxis: Ejemplo: function executeScript(event) { event.getEventExecutionInfoId(); } |
|
|
Muestra el ID del proyecto de Google Cloud.
Tipo de datos que se muestra: String |
Sintaxis:
Ejemplo: function executeScript(event) { event.getGcpProjectId(); } |
|
|
Muestra el nombre actual de la integración.
Tipo de datos que se muestra: String |
Sintaxis:
Ejemplo: function executeScript(event) { event.getIntegrationName(); } |
|
|
Muestra el valor de la variable de integración proporcionada.
Tipo de datos: tipo de datos de la variable de integración |
Sintaxis:
Parámetro de entrada: Es el nombre de la variable de integración. Si Ejemplo: function executeScript(event) { event.getParameter("var1"); } |
|
|
Muestra el nombre de la región de integración.
Tipo de datos que se muestra: String |
Sintaxis:
Ejemplo: function executeScript(event) { event.getRegion(); } |
|
|
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:
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"); } |
|
|
Establece o actualiza el valor de una variable de integración. |
Sintaxis:
Parámetro de entrada: Esta función toma los siguientes argumentos:
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
para la tarea de JavaScript, selecciona una de las siguientes opciones:
Console
- Ve a la página de Application Integration.
- Selecciona una integración. Se abrirá el editor de integración.
- Haz clic en > Descargar integración > Versión de la integración. La versión de integración se descarga como un archivo JSON. Acción
-
Abre el archivo de versión de integración en un editor y, luego, haz lo siguiente:
-
Busca el campo
taskConfigs
con la tarea comoJavaScriptTask
. En el campoparameters
, ubica el parámetro llamadoscript
."taskConfigs": [{ "task": "JavaScriptTask", "taskId": 1, "parameters": { "script": { "key": "script", "value": { "stringValue": "function that is called during the JavaScriptTask execution" } }" }]
-
En este campo
parameters
, agrega los parámetros que se usan en el campoJavaScriptTask
con la siguiente plantilla:"ParamName": { "key": "ParamName", "value": { "stringValue": "$ParamName$" } }
-
Busca el campo
- Guarda los cambios que realizaste en el archivo de versión de integración.
- Sube el archivo de versión de integración a la integración.
API
- Para descargar la versión de integración, realiza una llamada al método
projects.locations.integrations.versions.download
con elfilFormat
establecido enJSON
. -
Abre el archivo de versión de integración en un editor y, luego, haz lo siguiente:
-
Busca el campo
taskConfigs
con la tarea comoJavaScriptTask
. En el campoparameters
, ubica el parámetro llamadoscript
."taskConfigs": [{ "task": "JavaScriptTask", "taskId": 1, "parameters": { "script": { "key": "script", "value": { "stringValue": "function that is called during the JavaScriptTask execution" } }" }]
-
En este campo
parameters
, agrega los parámetros que se usan en el campoJavaScriptTask
con la siguiente plantilla:"ParamName": { "key": "ParamName", "value": { "stringValue": "$ParamName$" } }
-
Busca el campo
- Para subir la versión de la integración, llama 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 todas las tareas y los activadores.
- Obtén información para probar y publicar una integración.
- Obtén información sobre la manejo de errores.
- Obtén información sobre los registros de ejecución de integración.