Saltearse al contenido
Nappai Documentation

Flatten By Key

Flatten By Key “despliega” una lista que está dentro de un registro. Si un pedido tiene un campo lineas con tres productos, el componente devuelve tres registros, uno por producto, y cada uno conserva los datos del pedido (número, cliente, fecha). Así puedes tratar cada elemento por separado en los siguientes pasos.

Cuándo usarlo

  • Cada pedido trae una lista de productos y quieres una fila por producto en una hoja de cálculo.
  • Un cliente tiene varias direcciones y necesitas un registro por dirección.
  • Una factura incluye varias líneas y quieres revisar o clasificar cada línea.
  • Una respuesta de una API agrupa resultados en una lista y quieres procesarlos uno a uno.

Configuración

CampoQué hace
DataLos registros que quieres desplegar.
Key to Flatten (obligatorio)El nombre del campo que contiene la lista, por ejemplo lineas.

Resultado

La salida Flattened Data devuelve un registro por cada elemento de la lista, con los demás campos del registro original copiados en todos.

  • Si cada elemento de la lista tiene sus propios campos (por ejemplo producto y cantidad), esos campos pasan al primer nivel del nuevo registro. Si alguno se llama igual que un campo del registro original, prevalece el del elemento.
  • Si los elementos son valores sueltos (por ejemplo, etiquetas), cada nuevo registro guarda el valor en el mismo campo indicado.
  • Si el campo no es una lista sino un solo valor, sale un único registro.
  • Los registros que no tienen el campo se omiten.

Ejemplo

Una tienda quiere analizar sus ventas por producto.

Cada pedido llega así: número 1001, cliente Ferretería López y un campo lineas con dos productos (tornillos, 200 unidades; tacos, 150 unidades).

  1. Conecta los pedidos a Data.
  2. En Key to Flatten, escribe lineas.
  3. El resultado son dos registros: 1001, Ferretería López, tornillos, 200 y 1001, Ferretería López, tacos, 150. Conéctalos al componente que escribe en la hoja de ventas.

Componentes relacionados