Vista previa — Data Transformer Script task

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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 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 con 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 Create Integration.
   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 integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integraciones 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 Tasks para ver la lista de tareas 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 access 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.

El editor de secuencias de comandos de Data Transformer importa de forma predeterminada 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.

Precaución: Jsonnet no permite usar guiones (-) como parte de un nombre de identificador. Por ejemplo, un nombre de variable o de función. Si deseas usar un guion (-) como parte de un nombre de variable, la variable debe declararse entre comillas dobles, como se muestra en el siguiente ejemplo.

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"
}

Salida

prácticas recomendadas

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?

• Consulta Funciones de Data Transformer (vista previa).