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:

  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 enumeran 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.
    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 Integration summary de la barra de herramientas de integración.
    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 Secuencia de comandos del transformador de datos en el editor de integración.
  6. 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.
  7. Haz clic en Abrir editor de secuencias de comandos de transformación de datos.
  8. Aparecerá el editor de secuencias de comandos de Data Transformer que muestra un ejemplo predeterminado de plantilla de Jsonnet comentada.
  9. 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:

Imagen que muestra el editor de secuencias de comandos del transformador de datos Imagen que muestra el 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

Imagen que muestra un ejemplo de secuencia de comandos de transformador de datos Imagen que muestra un ejemplo de secuencia de comandos de transformador de datos

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?