Cómo revisar los roles de un usuario
Consulta qué roles tiene asignados un usuario dentro de una organización o de una ubicación. En el detalle de acceso, Antylogic carga las asignaciones del usuario, las cruza con el catálogo de roles disponible y marca las filas correspondientes en la tabla.
En este artículo
La revisión de roles empieza en Acceso > Usuarios. Al abrir el detalle, la pantalla usa el alcance activo para cargar el usuario, el catálogo de roles y las asignaciones actuales en paralelo.
En Grupo Marea Demo puedes revisar roles de organización; en Marea Gran Via puedes revisar roles de ubicación. Esta guía describe la consulta: cambiar la selección y guardar pertenece a las acciones de asignar o quitar roles.
Antes de empezar
- Sesión autenticada en Antylogic.
- Grupo Marea Demo activo como organización.
- Para el flujo de ubicación, Marea Gran Via activa como ubicación.
- Abrir el detalle desde Acceso > Usuarios con un userId válido en la ruta.
- Permisos para ver usuarios y roles: users:view o users:manage, y permissions:view. Para cambiar la selección hace falta permissions:manage.
Instrucciones
- 1.
Elegir el alcance
Entra en Acceso desde organización o desde ubicación según lo que quieras revisar. Usa organization/access para Grupo Marea Demo y location/access para Marea Gran Via.
- 2.
Abrir el usuario
Desde la pestaña Usuarios, abre el detalle del usuario. La ruta debe ser organization/access/users/:userId o location/access/users/:userId y necesita el contexto activo correspondiente.
- 3.
Revisar los roles marcados
En la sección de roles, comprueba las filas seleccionadas. Esas marcas salen de las asignaciones leídas para el usuario en el alcance actual.
- 4.
Distinguir consulta y gestión
Si el operador solo puede consultar roles, la tabla sirve como lectura. Si también tiene permissions:manage, aparecen controles para cambiar selección y guardar; esos cambios no forman parte de esta acción de listado.
- 5.
Identificar el propietario
Si el usuario es propietario, puede aparecer el rol owner como asignación especial. Ese rol queda bloqueado y no se gestiona como un rol ordinario de la tabla.
Validaciones y límites
- La pantalla solo consulta roles asignados cuando existen los ids de contexto y el operador puede ver roles.
- En organización se usa GET /api/app/{orgId}/users/{userId}/roles.
- En ubicación se usa GET /api/app/{orgId}/{locationId}/users/{userId}/roles.
- La acción devuelve asignaciones UserRole; nombres, descripciones y scope visible vienen del catálogo de roles cargado aparte.
- La consulta de ubicación filtra por location_id y no mezcla asignaciones de organización, salvo el rol sintético owner.
- permissions:manage puede mostrar controles de edición, pero la lectura backend exige permissions:view.
- El rol owner puede aparecer aunque no exista como rol ordinario del catálogo; su checkbox queda deshabilitado.
- Esta acción es de solo lectura: no crea ni elimina asignaciones.
Resultado esperado
El detalle muestra qué roles tenía asignados el usuario en el alcance revisado, con el contador y las filas marcadas coherentes con las asignaciones leídas.