Ir al contenido principal

Herramienta Aggregator

S
Escrito por Support Team

El Aggregator agrupa filas de datos individuales en un solo array. Funciona como lo opuesto a la herramienta Iterator:

El Iterator divide un array en elementos separados. El Aggregator combina esos elementos de nuevo en un array.

Si el Iterator te permite procesar cada elemento por separado, el Aggregator te ayuda a ensamblar todo en el formato correcto para el paso final.

Por qué necesitas el Aggregator

Cuando un paso espera un array (por ejemplo, las líneas de un producto en una factura), el sistema debe recibir ese array como un solo objeto estructurado.

Si mapeas campos directamente desde distintos pasos después de un Iterator, el sistema no puede combinarlos automáticamente en un solo array. Esto genera un conflicto de estructura y produce un error.

El Aggregator resuelve este problema. Combina datos de varios pasos en un único array estructurado. El paso final recibe entonces todo desde una sola fuente, correctamente formateado y sin conflictos.

Flujo de trabajo típico:

Iterator → Procesamiento de datos → Aggregator → Paso final.

Cómo configurar el Aggregator

aggregator2.png

En la configuración, debes agregar campos. Cada campo representa una columna del futuro array.

aggregator1.png

Para cada campo, se configuran dos parámetros:

Nombre Tú defines el nombre del campo. Este nombre estará disponible en los siguientes pasos.

Seleccionar un campo La fuente de datos de cualquier paso anterior en la automatización. Estos valores seleccionados formarán las nuevas secciones de fila que luego se pasan como un array.

Dentro de un mismo paso de Aggregator, puedes recolectar datos simultáneamente:

desde el Iterator; desde herramientas de procesamiento (por ejemplo, Operación matemática); desde otros pasos anteriores.

Ejemplo: crear una factura en Zoho Books con líneas de pedido

Veamos un ejemplo real de automatización. El objetivo es crear una factura en Zoho Books cuando se recibe un nuevo pedido, y pasar todas las posiciones del pedido como líneas de producto. La automatización se ve así:

Webhook → Buscar cliente → Iterator → Procesamiento de datos → Aggregator → Crear factura

aggregator3.png

Paso 1. Webhook entrante

La automatización comienza con Webhook: Webhook entrante.

El webhook envía un pedido que incluye un array de productos. Cada elemento contiene:

nombre del producto; precio; cantidad; impuesto; envío; código promocional.

En esta etapa, los datos existen como un solo objeto que contiene un array de elementos.

Paso 2. Buscar al cliente

El siguiente paso es Google Sheets: Buscar una fila.

Aquí, la automatización usa el correo recibido desde el webhook para buscar al cliente correspondiente en una tabla de Google Sheets. Una vez que se encuentra la fila correcta, se obtiene el ID del cliente, necesario para crear la factura en Zoho Books.

Esta lógica es independiente del procesamiento del array, pero es necesaria para el paso final.

Paso 3. Iterator

En este paso, el Iterator selecciona el array de Items recibido desde el webhook.

aggregator4.png

Al elegir Webhook entrante, la automatización divide los elementos del pedido en filas individuales. Cada producto se procesa entonces por separado en los siguientes pasos.

Esto permite calcular impuestos, modificar descripciones o ajustar valores para cada elemento antes de volver a ensamblarlos en un array estructurado.

Paso 4-5. Procesamiento de cada elemento

Después del Iterator, cada elemento se procesa por separado.

En esta etapa, puedes aplicar herramientas adicionales, por ejemplo:

usar la herramienta Eliminar Etiquetas para limpiar la descripción del producto; usar la herramienta Operación matemática para calcular el impuesto u otros valores.

aggregator5.png

Paso 6. Aggregator

Después del procesamiento, se añade el paso Herramienta: Aggregator.

aggregator6.png

Aquí es donde ocurre la transformación clave.

En la configuración del Aggregator, se agregan los campos:

Text → desde Eliminar Etiquetas UnitCost → desde Iterator Quantity → desde Iterator Item tax → desde Iterator Discount → desde Webhook entrante Shipping → desde Iterator Tax% → desde Operación matemática Product name → desde Iterator

¿Qué sucede después?

El Aggregator:

Toma la primera iteración. Recolecta todos los campos especificados. Forma una fila del array. Pasa a la segunda iteración. Repite el proceso.

Como resultado, se crea un nuevo array estructurado. Este array se convierte en la única fuente de datos para el siguiente paso.

Paso 7. Reemplazo de tabla

Después del Aggregator, se usa la herramienta Table lookup para transformar valores específicos antes de enviarlos a Zoho Books.

En este paso, el sistema verifica el valor recibido del paso anterior (por ejemplo, un porcentaje de impuesto o un código interno) y lo reemplaza por el ID correspondiente que requiere Zoho Books.

Esto es necesario porque Zoho Books no acepta porcentajes en bruto como 5 o 20. En su lugar, requiere Tax IDs internos. El paso Table lookup mapea los valores legibles a los IDs exactos que espera el servicio.

Paso 8. Crear la factura en Zoho Books

Después de configurar los pasos anteriores, se agrega la acción Zoho Books: Create Invoice.

aggregator7.png

En la sección Line items, cada campo se mapea desde el resultado del Aggregator:

Name → Aggregator: Product name Description → Aggregator: Text Rate → Aggregator: UnitCost Quantity → Aggregator: Quantity Percentage tax → Aggregator: Tax%

Esto significa que Zoho Books recibe un array de líneas de producto completamente estructurado, con todos los valores requeridos ya procesados y formateados correctamente.

Conclusión

El Aggregator asegura que los datos basados en arrays se transmitan correctamente al servicio final.

Combina las filas procesadas en un único array estructurado que el servicio receptor puede aceptar sin conflictos ni problemas de formato.

Si tu automatización usa el Iterator y recolecta datos de array desde varios pasos, el Aggregator se vuelve una parte esencial del flujo de trabajo. Hace que las automatizaciones complejas sean estables, predecibles y técnicamente correctas.

¿Ha quedado contestada tu pregunta?