Tarea de secuencia de comandos del transformador de datos

Anuncio: Ahora la integración de aplicaciones está disponible para tu proyecto de Google Cloud. Ahora puedes usar la integración de Apigee y la integración de aplicaciones dentro del mismo proyecto de Google Cloud. Más información

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.

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 más información sobre la asignación de datos en Apigee 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 IU de Apigee, selecciona tu organización de Apigee.
2. Haz clic en Desarrollar > Integraciones.
3. Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.

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

   1. Ingresa un nombre y una descripción en el diálogo Crear integración.
   2. En la lista de regiones compatibles, selecciona Región para la integración.
   3. Haz clic en Crear.

   Esto abrirá la integración en la página del diseñador de integración.

4. En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas 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 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.

El editor de secuencias de comandos de transformador de datos importa de forma predeterminada functions, una biblioteca personalizada predefinida que contiene un conjunto de funciones de Jsonnet para la asignación de datos en la integración de Apigee. 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"
}

Resultado

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.