Cómo listar usuarios de ubicación
Consulta los usuarios vinculados a Marea Gran Via, revisa su estado de acceso, sus datos de contacto y el rol de empleado cuando existe.
En este artículo
El listado de usuarios de ubicación ayuda a operaciones a saber quién tiene acceso a un local concreto sin revisar varias pantallas. En el demo ES se documenta sobre Grupo Marea Demo y la ubicación Marea Gran Via.
La vista es de solo lectura para esta acción: permite buscar, paginar, abrir el detalle y revisar estados, pero las operaciones de invitar, crear, editar o retirar usuarios pertenecen a acciones hermanas.
Antes de empezar
- Sesión iniciada en Antylogic con acceso a Grupo Marea Demo.
- Ubicación Marea Gran Via seleccionada en el contexto de la aplicación.
- Permiso efectivo `users:view` sobre la ubicación; para capturas, usar propietario, system-admin o un rol que incluya `users:view`.
- Pantalla de acceso de ubicación abierta con la pestaña Usuarios visible.
Instrucciones
- 1.
Abre Usuarios de la ubicación
Entra en la sección de acceso de Marea Gran Via y selecciona Usuarios. La pantalla trabaja en scope de ubicación, así que el listado queda limitado al local seleccionado.
- 2.
Revisa contactos y roles
Lee la tabla para comprobar Nombre, Estado, Email, Teléfono y Rol de empleado. Cuando falta email, teléfono o rol, la tabla muestra `-`.
- 3.
Interpreta el estado de acceso
Usa Estado para distinguir propietario, invitaciones, accesos activos o inactivos, accesos internos de empleado o dispositivo y usuarios aceptados sin permisos efectivos cuando aplique.
- 4.
Busca por texto
Escribe en el buscador para filtrar por nombre, email o teléfono. En el demo de Grupo Marea, buscar `Marta` localiza a Marta Ruiz si el runtime la tiene vinculada como usuaria de Marea Gran Via.
- 5.
Usa la paginación
Cambia de página cuando haya más usuarios que el tamaño de página. La pantalla usa `page=1` y `page_size=10` por defecto y conserva la paginación en la ruta.
- 6.
Abre el detalle
Pulsa una fila para abrir el detalle del usuario. En modo visor la acción es Ver; con permisos de gestión pueden aparecer acciones hermanas, pero el listado por sí mismo no modifica permisos ni roles.
Validaciones y límites
- El backend del listado exige `users:view`; `users:manage` puede hacer visible la pestaña, pero no sustituye ese permiso en la API.
- La lista solo incluye usuarios vinculados a la ubicación actual y comprueba que la ubicación pertenezca a la organización.
- La búsqueda se recorta antes de enviarse y filtra por nombre completo, email o teléfono.
- Al buscar, la pantalla reinicia la página a 1.
- Los parámetros inválidos de página y tamaño vuelven a enteros positivos por defecto.
- El rol de empleado mostrado es informativo y no se edita desde esta superficie.
- El propietario se identifica como `owner` y no puede retirarse desde la fila.
- Los filtros API `status` y `without_staff` existen para consumo directo, pero no aparecen como controles en esta pantalla.
Resultado esperado
El responsable ve quién tiene acceso a Marea Gran Via, con estado, contacto, rol de empleado cuando existe y una vía directa para abrir el detalle sin ejecutar cambios de gestión.