Cómo listar usuarios de organización
Consulta los usuarios externos visibles de una organización, revisa su estado, contacto y ubicaciones asociadas, y filtra el listado con búsqueda y paginación server-side.
En este artículo
El listado de usuarios de organización ayuda a responsables y administradores de acceso a comprobar quién puede trabajar con el grupo, qué estado tiene cada acceso y a qué ubicaciones está asociado.
La pantalla vive en Usuarios y roles y se apoya en una consulta paginada de servidor. La búsqueda filtra por señales de contacto sin convertir el listado en una gestión manual de staff.
Antes de empezar
- Tener sesión iniciada y una organización seleccionada.
- Tener permiso `users:view` en scope `organization` para que el backend cargue el listado.
- Abrir Configuración > Organización > Usuarios y roles y entrar en la pestaña Usuarios.
- Con `users:manage` aparecen acciones de gestión como invitar, editar o eliminar, pero ese permiso no sustituye a `users:view` en la consulta.
Instrucciones
- 1.
Abre Usuarios y roles
Desde la configuración de organización, entra en Usuarios y roles. La pestaña Usuarios aparece cuando el contexto tiene permisos de usuarios sobre la organización.
- 2.
Revisa la tabla
Comprueba las filas de usuarios externos visibles. El listado muestra nombre, estado, email, teléfono y ubicaciones asociadas; los usuarios internos quedan fuera de esta vista.
- 3.
Busca por nombre o contacto
Escribe en el buscador para filtrar por nombre completo, email o teléfono. La búsqueda se aplica tras una breve espera, vuelve a la página 1 y no envía `query` cuando el campo queda vacío.
- 4.
Interpreta estados y ubicaciones
Lee el badge antes de operar sobre una fila. El propietario puede aparecer como owner, las membresías aceptadas se muestran como active o inactive, y las ubicaciones se resumen con avatares y contador cuando hay más de tres.
- 5.
Abre el detalle
Selecciona una fila o usa la acción principal. Sin `users:manage` se presenta como Ver; con gestión se presenta como Editar y pueden aparecer acciones adicionales, salvo retirada del propietario.
Validaciones y límites
- Si no hay organización seleccionada, la pantalla muestra el estado de organización no encontrada y no consulta usuarios.
- Si no hay permisos de usuarios ni roles, se muestra No tienes permisos para esta sección; si solo hay permisos de roles, la pestaña Usuarios no aparece.
- La tabla no incluye usuarios con `primary_auth_provider = 'internal-credentials'`.
- Los contactos vacíos se muestran como `-`.
- La paginación es server-side, usa 10 filas por defecto y ajusta la página si el total cambia.
- La búsqueda vacía no manda `query`; con texto compara nombre completo, email y teléfono.
- El UI estándar no expone filtro de `status`, aunque el endpoint lo soporta.
- `users:manage` no equivale a `users:view`: el frontend puede mostrar opciones de gestión, pero `GET /api/app/{orgId}/users` exige `users:view`.
Resultado esperado
El responsable obtiene una vista clara de los usuarios externos de la organización, su estado operativo, sus datos de contacto y las ubicaciones donde tienen relación, con búsqueda y paginación controladas desde servidor.