Cómo listar roles de acceso
Consulta los roles de acceso disponibles en organización o ubicación, revisa scope, propietario y descripción, y abre el detalle sin modificar permisos ni asignaciones.
En este artículo
El listado de roles ayuda a entender qué accesos existen antes de crear, editar o asignar permisos. En Grupo Marea Demo se puede revisar la vista de organización y, desde Marea Gran Via, la vista de ubicación.
La búsqueda, el filtro por scope y la paginación son controles locales de la tabla. La acción no envía payload de listado ni cambia roles, permisos o asignaciones.
Antes de empezar
- Sesión autenticada en Antylogic con la organización Grupo Marea Demo seleccionada.
- Para revisar la variante de ubicación, tener seleccionada la ubicación Marea Gran Via.
- Tener `permissions:view` o `permissions:manage` en el scope correspondiente, o acceso `system-admin`.
- Abrir `organization/access?tab=roles` o `location/access?tab=roles` para entrar directamente en Roles de usuario.
Instrucciones
- 1.
Abre Roles de usuario
Entra en Usuarios y roles desde organización o ubicación. Si `tab=roles` está disponible, la pantalla abre directamente la pestaña Roles de usuario; si no, cae en la primera pestaña permitida.
- 2.
Revisa nombre, scope y propietario
Lee cada fila por nombre y scope. En escritorio también aparecen descripción y propietario, lo que permite distinguir roles de Grupo Marea Demo, de Marea Gran Via o de origen sistema.
- 3.
Busca por nombre o descripción
Usa el buscador para localizar roles por el texto visible traducido o por los valores internos de nombre y descripción. La búsqueda se aplica en local y vuelve a la página 1.
- 4.
Filtra por scope
Cuando haya varios scopes cargados, usa el filtro para ver roles de organización, ubicación o sistema si están presentes. Todos los scopes limpia el filtro.
- 5.
Cambia de página
Usa la paginación de la tabla cuando el listado supera el tamaño de página. El tamaño por defecto es 10 y la paginación no cambia la petición al backend.
- 6.
Abre una fila
Pulsa un rol para consultar su detalle. Con `permissions:manage`, la interfaz puede mostrar edición o eliminación solo si el rol pertenece al scope actual; los roles globales o heredados quedan como consulta.
Validaciones y límites
- Sin `permissions:view` ni `permissions:manage` no se muestra la pestaña Roles de usuario; si no hay pestañas disponibles, la sección muestra falta de permisos.
- Si falta la organización seleccionada, o falta la ubicación en la variante de ubicación, la pantalla muestra estado no encontrado.
- `GET /api/app/{orgId}/roles` y `GET /api/app/{orgId}/{locationId}/roles` no reciben payload de búsqueda, filtro ni paginación.
- En organización no aparecen roles propios de una ubicación concreta; en ubicación aparecen roles de scope `location` aplicables a la ubicación actual.
- Los roles llegan ordenados por nombre ascendente desde el repositorio.
- La edición y el borrado requieren `permissions:manage` y propiedad del rol en el scope actual.
- Los endpoints actuales de esta acción no devuelven roles de scope `system`; si esa opción no aparece en el filtro, no es un error del listado.
Resultado esperado
El operador queda con una lectura clara de los roles aplicables al contexto seleccionado y puede abrir detalles sin crear, editar, borrar ni asignar permisos.