Consulta los conectores compatibles con Application Integration.

Tarea de transformación de datos

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

La tarea Transformador de datos ofrece dos modos (Diagrama y Secuencia de comandos) para transformar los datos. En el modo Diagrama, se usa un lienzo de asignación visual, llamado editor de Data Transformer, para asignar y mapear datos en la integración. Además, puedes usar las transformaciones admitidas para convertir tus datos en variables y formatos significativos, de modo que otros activadores o tareas de tu integración puedan acceder a ellos. En el modo Secuencia de comandos, puedes escribir, editar y evaluar plantillas Jsonnet personalizadas para asignar datos en tu integración.

Para obtener información sobre la asignación de datos en Application Integration, consulta el resumen de la asignación de datos.

Configurar la tarea Transformador de datos

Para añadir una tarea Data Transformer a su integración, siga estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe 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 muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede 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 de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
5. Haga clic en el elemento Transformador de datos y colóquelo en el editor de integraciones.
6. Haga clic en el elemento Transformador de datos para ver el panel de configuración de la tarea.
7. Haz clic en Abrir editor de transformador de datos. En la página Editor de tareas de Data Transformer (vista previa), seleccione una de las siguientes opciones:
• De forma predeterminada, se abre el modo Diagrama. El modo Diagrama proporciona una experiencia basada en consola para seleccionar las variables de entrada y salida, y realizar transformaciones en el editor de transformación de datos.

  En el modo Diagrama, puede asignar datos visualmente entre variables de entrada y salida.

• Para transformar los datos de 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 quieres aprovechar las funciones de Jsonnet.

  Se muestra el editor de transformador de datos con un ejemplo de plantilla de Jsonnet predeterminado comentado. Escribe tu código Jsonnet y cierra el editor cuando hayas terminado. Los cambios se guardarán automáticamente.

Para obtener instrucciones detalladas sobre cómo añadir una asignación, consulta Añadir una asignación.

Añadir una asignación

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

Usar el modo Diagrama

El modo Diagrama ofrece una experiencia basada en la consola para seleccionar las variables de entrada y salida, así como para realizar transformaciones en el editor de transformación de datos. Para añadir una asignación con el modo Diagrama, sigue estos pasos:

1. En el panel de configuración de la tarea Transformador de datos, haga clic en Abrir editor de Transformador de datos.

   De forma predeterminada, se abre el modo Diagrama.

   

2. Para añadir la variable de entrada de la asignación, haz clic en + Añadir entrada. Aparecerá el cuadro de diálogo Elegir variable o valor de entrada. La pestaña Variable está seleccionada de forma predeterminada.
   Entrada: fuente de la entrada de la transformación de datos. La fuente puede ser un valor literal, una función base o una variable de entrada, con funciones de asignación.

   

   A continuación, haz lo siguiente:

   1. En la lista Seleccionar variables, elija las variables de entrada. Si quieres crear una variable, haz clic en + Añadir variable.
   2. Haz clic en Enviar.

   Si quiere añadir una constante, haga clic en la pestaña Constante.

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

   

   A continuación, haz lo siguiente:

   1. En el campo Identificador de constante, introduce el nombre de la constante.
   2. En la lista Tipo de datos, seleccione uno de los siguientes tipos de datos:
      • String
      • Booleano
      • Número
   3. En el campo Introduce el valor de la constante, escribe el valor.
   4. Haz clic en Enviar.
3. Para añadir la variable de salida de la asignación, haz clic en + Añadir salida y selecciona la variable de salida o crea una nueva.

   

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

      

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

      También puedes hacer clic en Añadir transformación para añadir la función de transformación.

      A continuación, haz lo siguiente:

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

         

         A continuación, haz lo siguiente:

         1. Haz clic en + Añadir operación. Aparecerá el cuadro de diálogo Añadir operación.

            

         2. En el campo Operaciones de búsqueda, introduce la operación que quieras añadir. También puedes seleccionar la operación en la lista de operaciones.

            Si quiere añadir una operación personalizada, seleccione Expresión de función e introduzca la expresión de función. Para copiar las variables, haga clic en en la lista Variables y péguelas en el editor de expresiones.

            

         3. Haz clic en Listo.
      2. En función de la operación, rellena los detalles necesarios. También puedes añadir varias operaciones en una transformación. Si quieres 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 Eliminar junto a la operación.
   3. También puedes añadir una asignación de varias variables de entrada a una función de transformación. Sin embargo, solo se puede añadir una asignación por cada variable de salida de una función de transformación.
   4. Para quitar las variables de entrada y salida, haga clic en > Eliminar.
   5. Si quieres eliminar una fila de asignación o una transformación, selecciona la asignación y pulsa Eliminar.
   6. Cierra el Editor de asignación de datos cuando hayas terminado de asignar los datos. Los cambios se guardarán automáticamente.

   Ejemplo: Asignar un sistema antiguo de gestión de incidencias a un sistema nuevo

   Supongamos que tienes un sistema antiguo de incidencias de errores que quieres migrar a un nuevo sistema de incidencias. Puedes usar la opción Diagrama para asignar los campos del sistema antiguo al nuevo, tal como se muestra en la siguiente imagen:

   

   Para añadir un valor constante a uno de los campos, haz clic en Añadir entrada y añade una constante. Puedes asignar la constante recién añadida de la sección Entrada al campo de la sección Salida.

   

   Para añadir la transformación de los campos que no se pueden asignar directamente, haz clic en Transformación y añade la operación de transformación haciendo clic en + Añadir operación:

   

   Una vez completada la transformación, puedes ejecutar la integración para asignar el antiguo sistema de asistencia al nuevo.

   Usar el modo Secuencia de comandos

   Puede usar el editor de secuencia de comandos del transformador de datos para acceder a las variables de integración, asignar variables y añadir o modificar variables en su integración. El editor de secuencia de comandos del transformador de datos ofrece las siguientes funciones para mejorar tu experiencia con las secuencias de comandos:

   • Resaltado de sintaxis o código, sangría y numeración de líneas para facilitar la lectura del código y el reconocimiento de la estructura.
   • Un minimapa que muestra una vista general del código de la secuencia de comandos y ayuda a desplazarse rápidamente por él.
   • Opción para copiar el código de la secuencia de comandos en el portapapeles con un solo clic.

   Para abrir el editor, vaya al panel de configuración de la tarea Secuencia de comandos del transformador de datos y haga clic en Abrir editor de secuencia de comandos del transformador de datos.

   El editor de secuencias de comandos del 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 Integration Builder. Para obtener información detallada sobre las funciones personalizadas disponibles, consulta Funciones del transformador de datos.

   En la siguiente imagen se muestra un ejemplo del diseño del editor de secuencia de comandos del transformador de datos:

   

   Acceder a las variables de integración

   Para leer una variable de integración del editor de secuencia de comandos del transformador de datos, usa la función extVar de la biblioteca functions predefinida.

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

   Ejemplo: Leer y actualizar variables de integración con el editor de secuencias de comandos del 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

   

   Referencia de uso de Jsonnet

   Jsonnet es un lenguaje puramente funcional y sus programas se componen de expresiones. Para obtener información sobre cómo formar estas expresiones, consulte Expresiones de Jsonnet.

   Estrategia de gestión de errores

   Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.

   Cuotas y límites

   Para obtener información sobre los límites de uso que se aplican a la tarea Transformador de datos, consulta Límites de uso.

   Siguientes pasos

   • Consulta la siguiente información:
     • Todas las tareas y los activadores.
     • Funciones de Data Transformer (vista previa)
     • Probar y publicar integraciones.
     • Gestión de errores.
     • Registros de ejecución de la integración.