Cómo filtrar empleados
Localiza empleados de la ubicación activa por búsqueda, rol, visibilidad de inactivos y página. Es una acción de solo lectura: cambia la vista de la tabla, pero no crea, edita, archiva ni restaura empleados.
En este artículo
Usa esta guía cuando necesites reducir el listado de personal de Marea Gran Via sin modificar ningún registro.
La búsqueda, el rol y la página se aplican en la pantalla. Solo la opción Mostrar empleados inactivos cambia la petición del listado para incluir registros archivados.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Acceso a Empleados y roles en la pestaña Empleados desde location/staff?tab=staff.
- Permiso para ver empleados de la ubicación. Para filtrar por nombres reales de rol, también debe cargarse el catálogo de roles de personal.
Instrucciones
- 1.
Abrir Empleados
Entra en la pestaña Empleados. La pantalla muestra el buscador, el selector de rol, la tabla, la paginación y la casilla Mostrar empleados inactivos.
- 2.
Buscar por texto
Escribe en Buscar por nombre, email o rol. Por ejemplo, Marta reduce el listado hasta Marta Ruiz, recorta espacios sobrantes y vuelve a la página 1.
- 3.
Filtrar por rol
Abre el selector de rol y elige Sala para ver solo empleados asignados a ese rol. Para recuperar el listado completo, selecciona Todos.
- 4.
Mostrar inactivos
Activa Mostrar empleados inactivos para incluir empleados archivados junto con los activos. La pantalla recarga el listado con show_deleted=true, vuelve a la página 1 y muestra el estado de cada fila.
- 5.
Cambiar de página
Usa la paginación para recorrer los resultados filtrados. Si staff_page no es válido o queda fuera de rango, la pantalla lo ajusta a una página válida.
Validaciones y límites
- La acción es de solo lectura: filtrar no crea, edita, archiva ni restaura empleados.
- La búsqueda compara nombre completo, email, teléfono y nombre de rol sin distinguir mayúsculas.
- staff_query, staff_role_id y staff_page se aplican localmente en la pantalla; no se envían como filtros al listado de empleados.
- Sin Mostrar empleados inactivos, los empleados con deleted_at no aparecen. Con la opción activa, el listado se pide con show_deleted=true.
- El filtro por rol compara staff_role_id. Si el rol de la ruta ya no existe tras cargar roles, la pantalla limpia el filtro.
- staff_page_size está tipado en la ruta, pero esta pantalla no lo usa; el tamaño de página depende del alto disponible.
- La tabla no ofrece ordenación manual, multiselección de roles ni filtro específico de empleados sin rol.
Resultado esperado
La tabla queda filtrada por texto, rol, visibilidad de inactivos y página, manteniendo intactos los datos del personal.