Consulta los conectores compatibles para Application Integration.
Descripción general de la asignación de datos
En esta página, se proporciona una descripción general de la asignación de datos y las diferentes formas de realizarla en Application Integration.
Los datos empresariales pueden estar en diferentes fuentes y formatos, lo que dificulta enormemente su integración en un modelo de datos unificado o en una canalización de datos. La asignación de datos es el proceso de extraer y estandarizar datos de varias fuentes para establecer una relación entre ellos y los campos de datos de destino relacionados en el destino. Algunos ejemplos del uso de la asignación de datos en una integración incluyen los siguientes:
- Extraer campos de una estructura de datos compleja, como un JSON
- Asignar la fuente de datos al esquema de destino
- Transformar de datos mediante la aplicación de funciones de transformación
- Generar valores de salida y almacenarlos o usarlos como variables de integración
Application Integration te permite realizar la asignación de datos mediante las siguientes tareas:
Tarea de secuencia de comandos del transformador de datos
La tarea Secuencia de comandos de Data Transformer es una función de asignación de datos basada en motores de plantillas disponible en Application Integration. Usa el lenguaje de configuración Jsonnet de Google para crear y editar plantillas de Jsonnet que definen las relaciones de asignación para las variables de integración de origen y de destino especificadas en tu integración.
Con el editor de secuencias de comandos del transformador de datos y las funciones del transformador de datos compatibles, puedes escribir la lógica de asignación de datos personalizada, realizar asignaciones de variables y agregar o modificar variables de integración.
En la imagen siguiente, se muestra el diseño de muestra del editor de secuencias de comandos del transformador de datos:
Para obtener información sobre cómo agregar y configurar la tarea Secuencia de comandos del transformador de datos, consulta Tarea de secuencia de comandos del transformador de datos.
Tarea Asignación de datos
La tarea Asignación de datos es una función sin código y con poco código en Application Integration que proporciona un lienzo de mapeo visual (editor de asignación de datos) para realizar asignaciones y asignaciones de datos en tus integraciones. Además, puedes usar las funciones de asignación compatibles para transformar aún más tus datos en variables o formatos significativos a fin de que sean accesibles para las otras tareas o activadores en tu integración.
Con la tarea Asignación de datos, puedes hacer lo siguiente:
- Usa el Editor de asignación de datos a fin de visualizar y definir la asignación de variables únicas o anidadas.
- Transformar las variables de un tipo de datos a otro. La tarea de asignación de datos te permite aplicar varias funciones de asignación (incluidas las funciones anidadas) para transformar los datos de las variables.
Editor y diseño de la asignación de datos
El Editor de asignación de datos proporciona un lienzo visual que contiene los siguientes elementos de integración:
- Panel Variables: muestra los diferentes tipos de variables disponibles para la integración:
- Entradas. Variables de entrada de la integración.
- Salidas. Variables de resultado de la integración.
- Variables locales. Variables que existen dentro del alcance de la integración.
Si no aparece ninguna variable, haz clic en Agregar + para configurar una nueva.
Haz clic en (Expandir) para expandir cada variable y ver los subcampos disponibles de esa variable. Para buscar cualquier variable o su subcampo de la lista de variables disponibles, haz clic en (Buscar variables).Para obtener más información sobre las variables en Application Integration, consulta Cómo usar variables en Application Integration.
- Columna Entrada: Muestra las filas de asignación de entrada que contienen la fuente de la entrada de asignación de datos. El origen puede ser un valor literal, una función base o una variable de entrada con funciones de asignación. Haz clic en Variable o Valor en una fila de asignación de entradas para agregar una fuente.
- Columna Resultado: Muestra las filas de asignación de salida que contienen las variables de destino relacionadas para la fila de asignación de entrada correspondiente. Las variables de destino se pueden usar para la asignación en filas de entrada posteriores. Para asignar una variable de salida, puedes crear una variable nueva o arrastrar y soltar directamente una variable de salida existente desde la columna Variables.
Funciones de asignación
La tarea Asignación de datos proporciona varias funciones de asignación predefinidas para transformar y estandarizar los datos de asignación en tu integración. Una función de asignación puede tener uno o más parámetros de entrada, y cada parámetro puede contener un valor literal, una variable o una función base con funciones de asignación aplicadas. Puedes usar varias funciones de asignación para una sola fuente de entrada y formar una expresión de transformación de asignación.
El tipo de datos finales de una fuente de entrada se basa en el tipo de datos que se muestra de la expresión de transformación definida en la fila de entrada de la asignación de datos correspondiente. El Editor de asignación de datos muestra un error de validación en la fila de entrada de asignación de datos correspondiente si el tipo de datos de la fuente de entrada no coincide con el de la variable de destino de asignación de salida correspondiente.
Expresión de transformación
Una expresión de transformación es una combinación de varias funciones de asignación que se encadenan en serie o en una estructura anidada. Con el editor de asignación de datos, puedes insertar, modificar o quitar fácilmente una función o un parámetro de función en una expresión de transformación definida. Si la expresión de transformación definida no es válida, el Editor de asignación de datos muestra un error de validación junto a la función o parámetro de función correspondiente que causa el error en la expresión. Para ver el mensaje de error completo, mantén el puntero sobre el ícono de error de validación .
En la siguiente imagen, se muestra una asignación de muestra con errores de validación en el Editor de asignación de datos:
Si deseas obtener más información para configurar una asignación en una tarea Asignación de datos, consulta Agrega una asignación.
Para obtener información sobre las funciones de asignación predefinidas compatibles con Application Integration, consulta Tipos de datos y funciones de asignación compatibles.
Orden de asignación
Las asignaciones especificadas en el Editor de asignación de datos se ejecutan en secuencia de arriba abajo. Por ejemplo, en la imagen anterior,Num1 se asigna a Num1ToInt en la primera fila, lo que hace que Num1ToInt esté disponible para la asignación en las filas posteriores.
¿Qué sigue?
- Agrega y configura una tarea de secuencia de comandos de Data Transformer (vista previa).
- Consulta Funciones de Data Transformer (vista previa).
- Agrega y configura una tarea de asignación de datos