Consulta los conectores compatibles con Application Integration.

Tarea de Data Transformer

Vista previa

Este producto o función está sujeto 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. Los productos y las funciones que se encuentran en la 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 Data Transformer proporciona dos modos, Diagrama y Secuencia de comandos, para transformar tus datos. En el modo Diagram, usas un lienzo de asignación visual, llamado editor de Data Transformer, para realizar asignaciones de datos en tu integración. Además, puedes usar las transformaciones compatibles para transformar tus datos en variables y formatos significativos a fin de que sean accesibles para las otras tareas o activadores en tu integración. En el modo Secuencia de comandos, puedes 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 del transformador de datos

Para agregar una tarea de Data Transformer a tu integración, sigue estos 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 enumerarán 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.
      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 Integration summary de la barra de herramientas de integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integración 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 y conectores disponibles.
5. Haz clic y coloca el elemento Data Transformer en el editor de integración.
6. Haz clic en el elemento Data Transformer para ver el panel de configuración de tareas.
7. Haz clic en Abrir editor de Data Transformer. En la página Editor de tareas de Data Transformer (versión preliminar), selecciona una de las siguientes opciones:
• De forma predeterminada, se abre el modo Diagrama. El modo Diagram proporciona una experiencia basada en la consola que permite seleccionar las variables de entrada y salida, y realizar transformaciones en el editor de transformación de datos.

  En el modo Diagrama, puedes realizar visualmente la asignación de datos entre las variables de entrada y salida.

• Para realizar transformaciones de datos en tu integración escribiendo, editando y evaluando plantillas Jsonnet personalizadas, ve al modo de secuencia de comandos haciendo clic en Secuencia de comandos. Puedes usar el modo Secuencia de comandos si tienes requisitos complejos de transformación de datos y deseas aprovechar las funciones de Jsonnet.

  Aparecerá el editor 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.

Para obtener pasos detallados sobre cómo agregar una asignación, consulta Agrega una asignación.

Agrega una asignación

Para agregar una asignación, puedes usar el modo Diagrama o el modo Secuencia de comandos.

Cómo usar el modo de diagrama

El modo Diagram proporciona una experiencia basada en la consola para seleccionar las variables de entrada y salida, y realizar transformaciones en el editor de transformación de datos. Para agregar una asignación con el modo Diagrama, sigue estos pasos:

1. En el panel de configuración de la tarea de Data Transformer, haz clic en Abrir editor de Data Transformer.

   De forma predeterminada, se abre el modo Diagrama.

   

2. Para agregar la variable de entrada para la asignación, haz clic en + Agregar entrada. Aparecerá el diálogo Choose Input Variable or Value. La pestaña Variable está seleccionada de forma predeterminada.
   Entrada: Fuente de la entrada de transformación de datos. El origen puede ser un valor literal, una función base o una variable de entrada con funciones de asignación.

   

   A continuación, sigue estos pasos:

   1. En la lista Seleccionar variables, selecciona las variables de entrada. Si deseas crear una variable nueva, haz clic en + Agregar variable nueva.
   2. Haz clic en Enviar.

   De manera opcional, si quieres agregar una constante, haz clic en la pestaña Constante.

   A diferencia de las variables, otras tareas o activadores no pueden acceder a las constantes en tu integración y solo se pueden usar en la tarea de Transformación de datos en la que se crean. Por ejemplo, puedes usar constantes para agregar delimitadores o para asignar un valor constante a una variable.

   

   A continuación, sigue estos pasos:

   1. En el campo Identificador de constante, ingresa el nombre de la constante.
   2. En la lista Tipo de datos, selecciona uno de los siguientes tipos de datos:
      • String
      • Booleano
      • Número
   3. En el campo Ingresar el valor constante, ingresa el valor.
   4. Haz clic en Enviar.
3. Para agregar la variable de salida para la asignación, haz clic en + Agregar salida y selecciona la variable de salida o crea una variable nueva.

   

4. Configura la asignación:
   1. Agrega una asignación de una variable o su subcampo de la lista Variables en la sección Entrada a la variable o su subcampo de la lista Variables en la sección Salida.

      

   2. Para agregar una función de transformación, coloca el cursor sobre la línea de asignación y haz clic en para agregar la función de transformación de datos. El botón Transformación aparece en el lienzo.

      Como alternativa, puedes hacer clic en Agregar transformación para agregar la función de transformación.

      A continuación, sigue estos pasos:

      1. Para agregar la transformación, haz clic en el botón Transformación. Aparecerá el panel Transformación.

         

         A continuación, sigue estos pasos:

         1. Haz clic en + Agregar operación. Aparecerá el diálogo Add Operation.

            

         2. En el campo Operaciones de búsqueda, ingresa la operación que deseas agregar. Como alternativa, puedes seleccionar la operación de la lista de operaciones.

            Si deseas agregar una operación personalizada, selecciona Expresión de la función y, luego, ingresa la expresión de la función. Para copiar las variables, haz clic en en la lista Variables y pégalas en el editor de expresiones.

            

         3. Haz clic en Listo.
      2. Según la operación, completa los detalles obligatorios. De manera opcional, puedes agregar varias operaciones en una transformación. Si deseas elegir el resultado de la operación anterior en la operación siguiente, selecciona la variable Resultado de la operación anterior, como se muestra en la siguiente imagen:

         

      3. Para quitar la operación, haz clic en Borrar junto a ella.
   3. De forma opcional, puedes agregar la asignación de múltiples variables de entrada a una función de transformación. Sin embargo, solo se puede agregar una asignación para cada variable de salida de una función de transformación.
   4. Para quitar las variables de entrada y salida, haz clic en > Borrar.
   5. De manera opcional, para borrar una fila de asignación o una transformación, selecciónala y presiona Borrar.
   6. Cierra el Editor de asignación de datos una vez que se complete la asignación. Los cambios se guardarán automáticamente.

   Ejemplo: Asigna un sistema de tickets de errores anterior a un sistema de tickets nuevo

   Supongamos que tienes un sistema de generación de tickets heredado que deseas migrar a un sistema de tickets nuevo. Puedes usar la opción Diagrama para asignar los campos del sistema anterior al nuevo, como se muestra en la siguiente imagen:

   

   Para agregar un valor constante para uno de los campos, haz clic en Agregar entrada y agrega una nueva constante. Puedes asignar la constante recién agregada de la sección Entrada al campo de la sección Salida.

   

   Para agregar la transformación de los campos que no se pueden asignar directamente, haz clic en Configuración Transformación y, luego, en + Agregar operación para agregar la operación de transformación:

   

   Una vez que se complete la transformación, puedes ejecutar la integración para asignar el sistema de tickets anterior al nuevo.

   Usa el modo de secuencia de comandos

   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 aplicaciones. 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

   

   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.

   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 los límites de uso que se aplican a la tarea de Transformación de datos, consulta Límites de uso.

   ¿Qué sigue?

   • Obtén información sobre los siguientes temas:
     • Todas las tareas y activadores.
     • Funciones de transformador de datos (vista previa)
     • Prueba y publica integraciones.
     • Manejo de errores.
     • Registros de ejecución de integración.