Employee Directory en grandes organizaciones: paginación, caché, totales y límites de exportación

Introducción

El tiempo de carga depende del tamaño del directorio, la red, el navegador y la configuración. En un inquilino con miles o decenas de miles de cuentas, el modo de obtener los usuarios influye en el tiempo de la primera página, la respuesta de búsquedas y refinadores, la precisión de los totales y la duración de la exportación a Excel.

La solución ofrece dos elementos web con modelos distintos. Employee Directory (Entra ID) carga todo el directorio una vez en el navegador y después trabaja en memoria. Employee Directory envía una consulta al servidor por cada búsqueda y carga una página cada vez. Este artículo explica ambos modelos, las opciones que los afectan y la configuración para grandes organizaciones.

Los dos modelos de carga de un vistazo

Employee Directory (Entra ID): todo el directorio en el navegador

Primera carga

Si no hay caché, el elemento web lee todos los usuarios de Microsoft Graph en páginas de 900 cuentas y sigue los vínculos de paginación hasta recibir la última. La lista solo aparece al terminar; mientras tanto, se muestra un indicador de carga. Por ello, el tiempo aumenta con el número de cuentas.

Dos opciones modifican lo que devuelve Microsoft Graph:

• Excluir usuarios bloqueados, activada de forma predeterminada en Excluir empleados, se aplica en Microsoft Graph: las cuentas deshabilitadas no se descargan y se acorta la carga.
• La columna Responsable: si aparece en la lista o tarjeta, mediante Mostrar en la lista o Mostrar en la tarjeta, se solicita cada usuario junto con su responsable. Esto aumenta el peso de las solicitudes y la caché. Si se oculta en ambos lugares, no se solicitan responsables.

Las demás exclusiones se aplican en el navegador después de recibir los datos. Siempre se omiten invitados, y Excluir a los empleados sin licencia, Excluir empleados con Departamento vacío, Excluir empleados con título de trabajo en blanco y el filtro predefinido limitan la lista. Reducen la lista mostrada, pero no la descarga.

Caché del navegador y actualización

Tras una carga correcta, se guarda la lista como JSON comprimido en el almacenamiento local, con la clave Vitextra.EmployeeDirectory.Data y la hora de carga. En la siguiente visita:

1. El directorio utiliza la lista en caché antes de actualizarla en segundo plano. Las fotos, la presencia y otras funciones pueden solicitar datos adicionales.
2. Si la copia supera 24 horas, los datos se recargan en segundo plano. La lista permanece visible hasta que llega la nueva y se sustituye.

Última actualización: muestra la antigüedad de los datos sobre los resultados, por ejemplo, tres horas. Actualizar, a su lado, recarga todo el directorio desde Microsoft Graph cuando se solicita. La actualización manual muestra el indicador de carga, como la primera vez.

Si falla una actualización en segundo plano o manual y ya hay una lista cargada no vacía, se conservan esa lista y su fecha de actualización original. Aparece la advertencia No se pudo actualizar la lista. Se muestra la copia guardada., posiblemente seguida de detalles técnicos. Tras una actualización manual fallida, el indicador de carga da paso de nuevo a la lista anterior. Si no hay una lista previamente cargada no vacía, se muestra un error. Vuelva a intentar Actualizar más tarde; si la advertencia persiste, compruebe la conexión y los permisos aprobados de Microsoft Graph.

Tenga en cuenta lo siguiente:

• Almacenamiento del navegador. La caché se comparte dentro del mismo perfil de navegador y origen de SharePoint, sin separarse por cuenta de Microsoft 365. Otros perfiles y dispositivos tienen su propio almacenamiento. Borrar los datos del navegador elimina la caché.
• Una copia para todos los elementos web. Todos los Employee Directory (Entra ID) abiertos en el mismo navegador y dominio de SharePoint comparten una copia, independientemente de la página.
• Los cambios de Entra ID aparecen al actualizar. Los cambios devueltos por Microsoft Graph se reflejan tras una actualización correcta, manual o en segundo plano, según los filtros y exclusiones configurados.
• Algunas opciones recargan y otras no. Cambiar Excluir a los empleados sin licencia, Excluir empleados con Departamento vacío, Excluir empleados con título de trabajo en blanco, Excluir usuarios bloqueados o Columnas personalizadas recarga desde Graph. Mostrar Responsable no lo hace: la caché se cargó sin responsables.

Si el almacenamiento del navegador está lleno

El almacenamiento local tiene capacidad limitada y se comparte con otros datos del mismo origen. Si no se guarda el directorio comprimido, la lista cargada sigue disponible en memoria. Puede conservarse una copia anterior; si no hay ninguna utilizable, la próxima visita requiere una carga completa.

Señales habituales: abrirlo siempre tarda tanto como la primera vez y Última actualización: indica que acaba de actualizarse. Para reducir los datos, mantenga Excluir usuarios bloqueados activado, oculte Responsable si no lo necesita y configure solo las Columnas personalizadas utilizadas.

Operaciones en memoria

La búsqueda de texto, refinadores, navegación A–Z, Mi departamento, ordenación, agrupación, totales y exportación procesan la lista cargada en el navegador. La velocidad depende del tamaño y del dispositivo. La búsqueda por aptitudes, los filtros personales, la pertenencia a roles, las fotos, la presencia y los detalles aún pueden realizar solicitudes de red.

Mostrar los elementos en páginas de: no cambia la descarga. Solo limita cuántas personas se representan a la vez; Mostrar más resultados... muestra la siguiente parte de los datos ya cargados.

Employee Directory: una página del servidor cada vez

Employee Directory no conserva el directorio en el navegador. Al abrir la página, buscar, seleccionar un refinador o activar Mi departamento, envía una nueva consulta al origen de Origen de datos y recibe solo la primera página:

• Perfiles de usuario: realiza una búsqueda de personas de SharePoint. El tamaño determina las filas devueltas y cada página empieza después de las ya cargadas. SharePoint devuelve los valores de refinamiento en cada consulta.
• Entra ID (Azure AD): consulta usuarios a Microsoft Graph con el tamaño de página como número de resultados. Graph devuelve un vínculo para obtener la siguiente parte.

Si hay más resultados, aparece Mostrar más resultados.... Solicita la siguiente página y la añade a la lista; durante la solicitud, aparece Buscar... en lugar del botón.

Solicitar una sola página reduce la transferencia inicial. Cada búsqueda del servidor o selección de refinador requiere una solicitud cuya latencia depende del servicio y de la consulta. Los resultados reflejan la respuesta de Microsoft Graph o el índice de búsqueda de SharePoint.

Mi equipo, Personas con las que trabajo y Favoritos son una excepción en ambos elementos web: muestran listas cortas propias, filtradas en el navegador y sin paginación.

Configurar el tamaño de página

El control Mostrar los elementos en páginas de: de Origen de datos establece el tamaño. El intervalo y el valor predeterminado varían:

No hay una opción independiente para mostrar todo: en Employee Directory (Entra ID), establezca 0. En Employee Directory siempre hay paginación y Mostrar más resultados... carga el resto.

Totales

Con Mostrar totales activado en Apariencia, como ocurre de forma predeterminada, la barra muestra Número total de resultados:. Su significado depende del modelo:

• Employee Directory (Entra ID) cuenta la lista filtrada en memoria después de exclusiones, filtro predefinido, filtro rápido, refinadores, letras A–Z y texto de búsqueda. El recuento es exacto y abarca todos los resultados, no solo la página actual.
• Employee Directory muestra el total del servidor para la consulta, de SharePoint o Graph. Con Entra ID (Azure AD) y Buscar por aptitudes, se añaden las personas encontradas por aptitudes. El total abarca todas las coincidencias, no solo las páginas cargadas.
• Con Mi equipo, Personas con las que trabajo y Favoritos, ambos elementos web cuentan las personas de esa lista.

Opciones que afectan al rendimiento

Exportar grandes resultados a Excel

Con Hoja de cálculo de Microsoft Excel activado en Exportar, aparece Exportar a Excel sobre los resultados. Ambos elementos web crean employee-directory.xlsx con una tabla Employees y el estilo Table Style Medium 2. Contiene las columnas de Detalles con Mostrar en la lista, en su orden configurado, incluidas las personalizadas, salvo Imagen y Estado.

El contenido depende del modelo:

• Employee Directory (Entra ID) exporta toda la lista filtrada con su orden actual, después de exclusiones, filtros, refinadores, A–Z y búsqueda, no solo la página actual. Los datos ya están en memoria y no se requieren más solicitudes.
• Employee Directory vuelve a consultar todos los resultados del texto de búsqueda, Consulta guardada, refinadores y Mi departamento, en páginas de 100, y después crea el archivo. Con muchos resultados tarda, pues cada página es una solicitud independiente.
• Con Mi equipo, Personas con las que trabajo o Favoritos, ambos exportan las personas de esa lista.

Durante la recopilación de páginas, el vínculo de exportación está oculto. Tanto Detalles como Contacto muestran Exportando a Excel y un contador, por ejemplo «Registros 1 ... 300 de 1250». Mantenga la página abierta hasta que empiece la descarga.

Recomendaciones por tamaño de organización

Son recomendaciones generales. El tiempo real depende del servicio, la red, el navegador y las columnas configuradas. Pruebe con un perfil nuevo del navegador o tras borrar los datos del sitio para medir una carga sin caché.

Síntomas y soluciones

Artículos relacionados