Tarea de secuencia de comandos del transformador de datos
La tarea Secuencia de comandos del transformador de datos te permite escribir, editar y evaluar plantillas Jsonnet personalizadas para realizar la asignación de datos en tu integración.
Para obtener información sobre la asignación de datos en Application Integration, consulta la Descripción general de la asignación de datos.
Configura la tarea de secuencia de comandos del transformador de datos
Para agregar una tarea de Secuencia de comandos del transformador de datos a tu integración, realiza los siguientes 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 enumeran 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 Secuencia de comandos del transformador de datos en el editor de integración.
- Haz clic en el elemento Data Transformer Script en el diseñador para ver el panel de configuración de tareas de Data Transformer Script.
- Haz clic en Abrir editor de secuencias de comandos de transformación de datos.
- Aparecerá el editor de secuencias de comandos de Data Transformer que muestra un ejemplo predeterminado de plantilla de Jsonnet comentada.
- Escribe el código de Jsonnet y cierra el editor cuando se complete. Los cambios se guardarán automáticamente.
Usa el editor de secuencias de comandos de transformación de datos
Puedes usar el editor de secuencias de comandos de Data Transformer para acceder a las variables de integración, realizar asignaciones de variables y agregar o modificar variables en tu integración. El editor de secuencias de comandos del transformador de datos proporciona las siguientes funciones para enriquecer la experiencia de secuencia de comandos:
- 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.
- 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.
- Opción de hacer clic para copiar el código de la secuencia de comandos en el portapapeles.
Para abrir el editor, ve al panel de configuración de la tarea Secuencia de comandos del transformador de datos y haz clic en Editor de la secuencia de comandos del transformador de datos de datos.
De forma predeterminada, el editor de secuencias de comandos de Data Transformer importa functions
, una biblioteca personalizada predefinida que contiene un conjunto de funciones de Jsonnet para la asignación de datos en Application Integration. Para obtener detalles sobre las funciones personalizadas disponibles, consulta Funciones de transformador de datos.
En la imagen siguiente, se muestra el diseño de muestra del editor de secuencias de comandos del transformador de datos:
Accede a variables de integración
Para leer una variable de integración existente desde el Editor de secuencias de comandos de Transformador de datos, usa la función extVar
de la biblioteca predefinida functions
.
Ejemplo: Lee y actualiza las variables de integración existentes con el editor de secuencias de comandos de Transformador de datos.
Secuencia de comandos Jsonnet
local f = import "functions"; // Import predefined Data Transformer function library local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello" local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World" { OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar" "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var" }
Resultado
Referencia de uso de Jsonnet
Jsonnet es un lenguaje puramente funcional y sus programas están compuestos por expresiones. Para obtener información sobre cómo formar estas expresiones, consulta Expresiones de Jsonnet.
Cuotas y límites
Para obtener más información sobre los límites de uso que se aplican a la tarea Secuencia de comandos del transformador de datos, consulta Límites de uso.
¿Qué sigue?
- Obtén información sobre todas las tareas y los activadores.
- Obtén información sobre las funciones de Transformación de datos (vista previa).
- Obtén información para probar y publicar una integración.
- Obtén más información sobre el manejo de errores.
- Obtén información sobre los registros de ejecución de integración.