Cómo buscar usuarios del directorio
Encuentra usuarios existentes para preparar una invitación desde Acceso de organización o ubicación. La búsqueda es de solo lectura: muestra candidatos, pero no crea usuarios, membresías ni invitaciones.
En este artículo
El directorio de usuarios ayuda a localizar perfiles ya existentes antes de invitarlos a Grupo Marea Demo o a Marea Gran Via. El flujo vive dentro del modal `Invitar usuarios`, no en una pantalla separada.
Desde una ubicación se usa el mismo directorio de organización. El indicador `en organización` ayuda a interpretar el contexto, pero la búsqueda base sigue consultando `GET /api/app/{orgId}/users/directory?query={query}`.
Antes de empezar
- Sesión autenticada en la aplicación.
- Organización activa: Grupo Marea Demo (`ORG_ID`).
- Para ubicación, ubicación activa: Marea Gran Via (`LOCATION_ID`).
- Permiso `users:manage`; con solo `users:view` se puede ver la tabla, pero no aparece `Invitar usuario`.
- Modal `Invitar usuarios` abierto desde `organization/access?tab=users` o `location/access?tab=users`.
- Para ver resultados positivos debe existir un usuario no interno, ya creado, que coincida por nombre o email y no esté en la página visible actual de la tabla.
Instrucciones
- 1.
Abre Acceso en Usuarios
Entra en la pestaña `Usuarios` de Acceso de organización o de ubicación. En el demo ES, los puntos de entrada son Grupo Marea Demo y Marea Gran Via.
- 2.
Abre Invitar usuarios
Pulsa `Invitar usuario`. El modal muestra el campo `Buscar por nombre o email`, los contadores de selección y disponibilidad, y el botón `Invitar (0)` deshabilitado.
- 3.
Escribe la búsqueda
Introduce parte del nombre o email de un usuario existente. La interfaz recorta espacios y espera 240 ms antes de lanzar la consulta del directorio.
- 4.
Revisa los candidatos
El modal lista candidatos con avatar, nombre, email y casilla de selección. Esta guía termina en la revisión de resultados; seleccionar y enviar invitaciones pertenece a otros flujos.
- 5.
Comprueba la variante de ubicación
Desde `location/access?tab=users`, el modal añade el indicador `en organización`, pero no cambia de endpoint ni consulta un directorio por ubicación.
- 6.
Interpreta el estado vacío
Si no hay coincidencias, o si la búsqueda queda vacía tras recortar espacios, el modal puede mostrar `No hay usuarios disponibles.` sin modificar datos.
Validaciones y límites
- La acción es de solo lectura: no crea usuarios, no crea invitaciones y no modifica membresías.
- `Invitar usuario` solo se muestra con `users:manage` en el contexto de la pantalla.
- La consulta se habilita con `selectedOrgId`, `users:manage`, modal abierto y búsqueda no vacía.
- La ruta usada por la UI es `GET /api/app/{orgId}/users/directory?query={query}` con credenciales de sesión.
- No existe una variante `GET /api/app/{orgId}/{locationId}/users/directory`.
- El backend exige `users:manage` en contexto de organización y `orgID` no vacío.
- La búsqueda compara coincidencias parciales en minúsculas contra email y nombre completo.
- No aparecen usuarios con `primary_auth_provider = "internal-credentials"`.
- La respuesta es `User[]`, no una respuesta paginada.
- La UI oculta candidatos que ya están en la página visible actual de la tabla.
Resultado esperado
El operador identifica candidatos existentes del directorio y puede decidir si continúa con una invitación, sin haber creado ni cambiado ningún dato durante la búsqueda.