Transformación de datos

Operaciones de transformación de datos para filtrar, asignar y agrupar colecciones.

Transforma los datos utilizando una variedad de operaciones. El nodo Transformación de datos y sus nodos de operación individuales (Filtro, Mapa, Agrupar por) están disponibles como nodos seleccionables independientes en la paleta de nodos.

Cuándo utilizar Transformación de datos frente a Script

Utiliza operaciones de transformación de datos cuando la transformación es una operación a nivel de campo en una colección. Las operaciones disponibles cubren:

• Filtrar
• Asignación
• Agrupación

Usa Script cuando la transformación requiera lógica condicional, aritmética o manipulación de cadenas, o cuando ninguna operación dedicada cubra el caso. Ambos pueden combinarse: una operación de Transformación de datos puede filtrar o remodelar una colección y luego pasar el resultado a un nodo de Script.

Salida

Todos los nodos de operación de Transformación de datos emiten su resultado como output, accesible en sentido descendente como $vars.<nodeName>.output.

Filtro

Mantiene solo las entradas de una colección que coinciden con tus condiciones.

Configuración

Campo	Obligatorio	Descripción
Entrada	Sí	La colección (matriz) que se va a filtrar. Referencia como $vars.<nodeName>.output.
Condiciones	Sí	Una o más condiciones. Una entrada se mantiene solo si se cumplen todas las condiciones.

Ejemplo

Mantener solo los pedidos con un status de "completed":

• Entrada: $vars.fetchOrders1.output.body
• Condición: status es igual a completed

Salida disponible como $vars.filter1.output.

Mapa

Transforma cada entrada de una colección modificando o reformando sus campos.

Configuración

Campo	Obligatorio	Descripción
Entrada	Sí	La colección (matriz) que se va a transformar.
Asignaciones de campos	Sí	Para cada campo de destino, define el nombre y el campo o expresión de origen.

Ejemplo

Cambia el nombre de los campos firstName y lastName a first y last:

Campo de destino	Asignación de origen
first	firstName
last	lastName

Salida disponible como $vars.map1.output.

Agrupar por

Agrupa una colección por un campo compartido y agrega valores como totales, promedios o recuentos.

Configuración

Campo	Obligatorio	Descripción
Entrada	Sí	La colección (matriz) que se va a agrupar.
Agrupar por campo	Sí	El campo cuyo valor determina el grupo.
Agregaciones	No	Campos calculados adicionales por grupo (recuento, suma, promedio, mínimo, máximo, primero, último, recopilar).

Ejemplo

Agrupa una lista de pedidos por region y cuenta el número de pedidos por región:

• Entrada: $vars.fetchOrders1.output.body
• Agrupar por: region
• Agregación: orderCount = recuento

Salida disponible como $vars.groupBy1.output.

Problemas comunes

Incidencia	Resolución
La salida está vacía después del filtro	Las condiciones no coinciden con ninguna entrada. Inspecciona la colección de entrada en el seguimiento de ejecución para verificar los nombres y valores de los campos.
La salida del mapa tiene undefined campos	La ruta del campo de origen no existe en las entradas de entrada. Utiliza el seguimiento de ejecución para confirmar la estructura de entrada.