Buscar dentro de tablas
Reduce las filas visibles de una tabla de reporting escribiendo parte del nombre en el buscador del bloque, sin cambiar el periodo ni volver a pedir datos al backend.
En este artículo
En las tablas de reporting compatibles, Antylogic permite localizar productos o categorías dentro de las filas ya cargadas. El buscador aparece cuando el bloque de tabla trae `search_placeholder`, como ocurre en Productos vendidos y Categorías dentro del reporting de catálogo.
La búsqueda está pensada para revisar rápido el periodo activo: filtra la primera columna de la tabla, mantiene los mismos datos del dashboard y también se aplica al subconjunto exportable cuando la tabla ofrece exportación.
Antes de empezar
- Iniciar sesión con una organización y una ubicación seleccionadas.
- Tener acceso a reportes de la ubicación, o un permiso operativo aceptado por la app como `tpv:view`, `tpv:use`, `catalog:view`, `reservation:view` o `staff:view`.
- Abrir una tabla de reporting con buscador, actualmente Productos vendidos o Categorías en el área de catálogo.
- Para capturas con coincidencias, usar un periodo con ventas agregadas. En el demo ES de Marea Gran Via puede probarse con Croquetas si `Croquetas de jamon` aparece en el periodo mostrado.
Instrucciones
- 1.
Abre la tabla de catálogo
Entra en Productos vendidos o Categorías desde reporting de catálogo. La pantalla carga el dashboard de reportes para la ubicación y los periodos activos antes de mostrar la tabla.
- 2.
Localiza el buscador
Busca el campo con el texto `¿Qué elemento estás buscando?`. Si el bloque no trae texto de búsqueda, la tabla se muestra completa y sin campo de búsqueda.
- 3.
Escribe parte del nombre
Introduce una parte del valor de la primera columna. En Productos vendidos se busca por Nombre; en Categorías se busca por Nombre de categoría.
- 4.
Revisa la tabla filtrada
La tabla se reduce al instante a las filas cuyo nombre contiene el texto escrito. El periodo no cambia y la pantalla no solicita un nuevo dashboard.
- 5.
Reconoce una búsqueda sin resultados
Si ninguna fila coincide, el bloque muestra su mensaje vacío. Para documentarlo en capturas puede usarse una cadena improbable como `zzzzz`.
- 6.
Exporta si corresponde
Cuando la tabla permite exportación, el archivo usa la misma consulta del buscador y solo incluye las filas exportables que coinciden.
Validaciones y límites
- La consulta de reportes solo se habilita cuando existen organización, ubicación y permisos suficientes.
- El buscador solo aparece si el payload del bloque incluye `search_placeholder`.
- La búsqueda ignora espacios al inicio y al final, y compara en minúsculas.
- La coincidencia es parcial y solo usa la primera celda de cada fila visible.
- Si el campo queda vacío o solo contiene espacios, vuelven a mostrarse todas las filas cargadas.
- No hay endpoint específico de búsqueda; el dashboard completo ya debe estar cargado.
- La búsqueda no se guarda en la URL ni se comparte con otras páginas.
- Si no quedan filas visibles, se muestra `empty_copy` del bloque o el texto genérico de la tabla.
- La exportación filtrada depende de que el bloque tenga filas exportables disponibles.
Resultado esperado
El usuario ve solo las filas que coinciden con el texto escrito dentro de la tabla actual, conserva el periodo activo y puede exportar el mismo subconjunto filtrado cuando la tabla lo permite.