Employee Directory dans les grandes organisations : pagination, cache, totaux et limites de l’exportation

Introduction

Le temps de chargement dépend de la taille de l’annuaire, du réseau, du navigateur et de la configuration. Dans un locataire comptant des milliers ou des dizaines de milliers de comptes, la manière dont un composant WebPart récupère les personnes commence à compter : le temps d’affichage de la première page, la réactivité de la recherche et des affinements, la précision des totaux et la durée d’une exportation vers Excel.

La solution propose deux composants WebPart d’annuaire qui suivent deux modèles de chargement différents. Employee Directory (Entra ID) charge une fois l’annuaire complet dans le navigateur, puis travaille en mémoire. Employee Directory envoie une requête au serveur à chaque recherche et charge les résultats page par page. Cet article explique les deux modèles, les paramètres qui les influencent et la façon de configurer l’annuaire pour une grande organisation.

Les deux modèles de chargement en bref

Employee Directory (Entra ID) : l’annuaire complet dans le navigateur

Premier chargement

Lorsque le composant WebPart s’ouvre sans données en cache, il lit tous les utilisateurs depuis Microsoft Graph par pages de 900 comptes et suit les liens de pagination jusqu’à l’arrivée de la dernière page. Ce n’est qu’ensuite que la liste apparaît ; jusque-là, le composant WebPart affiche un indicateur de chargement. La durée de ce premier chargement augmente donc avec le nombre de comptes du locataire.

Deux paramètres modifient ce que renvoie Microsoft Graph :

• Exclure les utilisateurs bloqués (dans Exclure les employés, activé par défaut) est appliqué côté Microsoft Graph : les comptes désactivés ne sont pas du tout téléchargés, ce qui raccourcit le chargement.
• La colonne Responsable : lorsqu’elle est affichée dans la liste ou sur la fiche (Afficher dans la liste ou Afficher sur la carte), chaque utilisateur est demandé avec son responsable. Les requêtes Microsoft Graph deviennent plus lourdes et les données en cache plus volumineuses. Lorsque la colonne est masquée aux deux endroits, les responsables ne sont pas demandés.

Toutes les autres exclusions sont appliquées dans le navigateur, une fois les données arrivées : les comptes invités sont toujours écartés, et Exclure les employés sans licence, Exclure les employés avec un service vide, Exclure les employés dont le titre de poste est vide ainsi que le filtre prédéfini réduisent encore la liste. Ils raccourcissent la liste, mais ne réduisent pas la quantité de données téléchargées.

Cache du navigateur et actualisation

Après un chargement réussi, le composant WebPart enregistre la liste dans le stockage local du navigateur sous forme de JSON compressé, sous la clé Vitextra.EmployeeDirectory.Data, avec l’heure du chargement. Lors de la visite suivante :

1. L’annuaire utilise la liste en cache avant toute actualisation en arrière-plan. Les photos, la présence et d’autres fonctions peuvent demander des données supplémentaires.
2. Si la copie en cache date de plus de 24 heures, le composant WebPart recharge les données depuis Microsoft Graph en arrière-plan. La liste en cache reste affichée pendant le chargement et est remplacée à l’arrivée des nouvelles données.

Au-dessus des résultats, Dernière mise à jour : indique l’âge des données (par exemple « Dernière mise à jour : il y a 3 heures »), et le lien Actualiser situé à côté recharge à la demande l’annuaire complet depuis Microsoft Graph. Une actualisation manuelle affiche l’indicateur de chargement, comme un premier chargement.

Si une actualisation en arrière-plan ou manuelle échoue alors qu’une liste non vide a déjà été chargée, le composant conserve cette liste et son horodatage et affiche l’avertissement Impossible de mettre à jour la liste. La copie enregistrée est affichée. Des détails techniques peuvent suivre. Après l’échec d’une actualisation manuelle, la liste précédente réapparaît à la place de l’indicateur de chargement. Si aucune liste non vide n’a été chargée auparavant, une erreur s’affiche à la place. Réessayez Actualiser plus tard ; si l’avertissement persiste, vérifiez la connexion et les autorisations Microsoft Graph approuvées.

Tenez compte du comportement du cache :

• Stockage du navigateur. Le cache est partagé dans un même profil de navigateur et une même origine SharePoint ; il n’est pas séparé par compte Microsoft 365 connecté. Les autres profils et appareils ont leur propre stockage. Effacer les données du navigateur supprime le cache.
• Une seule copie pour tous les composants WebPart. Tous les composants WebPart Employee Directory (Entra ID) ouverts dans le même navigateur sur le même domaine SharePoint partagent une seule copie en cache, quelle que soit la page sur laquelle ils se trouvent.
• Les modifications dans Entra ID apparaissent après une actualisation. Les modifications renvoyées par Microsoft Graph sont prises en compte après une actualisation réussie, manuelle ou en arrière-plan, selon les filtres et exclusions configurés.
• Certains paramètres rechargent les données, d’autres non. La modification de Exclure les employés sans licence, Exclure les employés avec un service vide, Exclure les employés dont le titre de poste est vide, Exclure les utilisateurs bloqués ou des Colonnes personnalisées recharge l’annuaire depuis Microsoft Graph. L’affichage de la colonne Responsable ne le fait pas : la copie en cache a été chargée sans les responsables.

Lorsque le stockage du navigateur est plein

Le stockage local est limité et partagé avec les autres données de la même origine. Si l’enregistrement de l’annuaire compressé échoue, la liste chargée reste utilisable en mémoire. Une ancienne copie en cache peut subsister ; sans copie utilisable, la prochaine visite nécessite un chargement complet.

Signes typiques : l’annuaire met toujours autant de temps à s’ouvrir qu’à la toute première visite, et Dernière mise à jour : indique toujours un instant à peine écoulé. Pour réduire la quantité de données, laissez Exclure les utilisateurs bloqués activé, masquez la colonne Responsable si vous n’en avez pas besoin et ne configurez que les Colonnes personnalisées que la page utilise réellement.

Ce qui fonctionne en mémoire

La recherche textuelle, les affinements, la navigation A–Z, Mon service, le tri, le regroupement, les totaux et l’export traitent la liste chargée dans le navigateur. Leur vitesse dépend de sa taille et de l’appareil. La recherche par compétences, les filtres personnels, les appartenances aux rôles, les photos, la présence et les détails peuvent encore envoyer des requêtes réseau.

Afficher les éléments par pages de : ne modifie pas ce qui est téléchargé. Ce paramètre limite uniquement le nombre de personnes affichées à la fois ; Afficher plus de résultats... sous la liste affiche la portion suivante des données déjà chargées.

Employee Directory : une page à la fois depuis le serveur

Le composant WebPart Employee Directory ne conserve pas l’annuaire dans le navigateur. Chaque fois que la page s’ouvre, qu’une recherche est lancée, qu’un affinement est sélectionné ou que le filtre rapide Mon service est activé, il envoie une nouvelle requête à la source choisie dans Source de données et ne reçoit que la première page de résultats :

• Profils utilisateur - le composant WebPart exécute une recherche de personnes SharePoint. La taille de page est transmise comme nombre de lignes à renvoyer, et chaque page suivante commence après les lignes déjà chargées. Les valeurs du panneau d’affinement sont renvoyées par la recherche SharePoint avec chaque requête.
• Entra ID (Azure AD) - le composant WebPart envoie une requête d’utilisateurs à Microsoft Graph avec la taille de page comme nombre de résultats ; Microsoft Graph renvoie un lien vers la page suivante, que le composant WebPart utilise pour la portion suivante.

Lorsqu’il existe d’autres résultats, Afficher plus de résultats... apparaît sous la liste. Le bouton demande la page suivante au serveur et l’ajoute à la liste ; pendant la requête, Rechercher... s’affiche à la place du bouton.

Demander une seule page réduit le transfert initial. Chaque recherche serveur ou sélection d’affinement nécessite une requête dont le délai dépend du service et de la recherche. Les résultats reflètent la réponse actuelle de Microsoft Graph ou l’index de recherche SharePoint.

Les filtres rapides Mon équipe, Personnes avec qui je travaille et Favoris constituent une exception dans les deux composants WebPart : ils affichent leurs propres listes courtes de personnes, sont filtrés dans le navigateur et ne sont pas paginés.

Paramètres de taille de page

La taille de page est définie par le curseur Afficher les éléments par pages de : du groupe Source de données. Sa plage et sa valeur par défaut diffèrent selon le composant WebPart :

Il n’existe pas d’option distincte pour afficher tous les éléments : dans Employee Directory (Entra ID), réglez le curseur sur 0. Dans Employee Directory, les résultats sont toujours paginés, et Afficher plus de résultats... charge le reste.

Totaux

Lorsque Afficher les totaux est activé (dans Apparence, activé par défaut), la barre d’outils au-dessus des résultats affiche Nombre total de résultats :. Ce nombre n’a pas la même signification dans les deux modèles :

• Employee Directory (Entra ID) compte les personnes de la liste filtrée en mémoire - après les exclusions, le filtre prédéfini, le filtre rapide, les affinements, les lettres A–Z et le texte de recherche. Le nombre est exact et couvre l’ensemble du résultat, pas seulement les personnes affichées sur la page actuelle.
• Employee Directory affiche le total indiqué par le serveur pour la requête en cours : le nombre de résultats de la recherche SharePoint ou le nombre renvoyé par Microsoft Graph. Avec la source Entra ID (Azure AD) et Rechercher par compétences activé, les personnes trouvées grâce à leurs compétences s’ajoutent à ce nombre. Le total couvre toutes les personnes correspondantes, pas seulement les pages chargées jusqu’ici.
• Pour les filtres rapides Mon équipe, Personnes avec qui je travaille et Favoris, les deux composants WebPart comptent les personnes de cette liste.

Paramètres qui influent sur les performances

Exportation vers Excel pour les grands ensembles de résultats

Lorsque le bouton bascule Feuille de calcul Microsoft Excel est activé dans le groupe Exporter, le lien Exporter vers Excel apparaît au-dessus des résultats. Dans les deux composants WebPart, il crée le fichier employee-directory.xlsx contenant un seul tableau nommé Employees au style Table Style Medium 2. Le tableau contient les colonnes affichées dans l’affichage Détails (Afficher dans la liste) dans l’ordre configuré, y compris les colonnes personnalisées, à l’exception de Image et État.

Le contenu du fichier dépend du modèle de chargement :

• Employee Directory (Entra ID) exporte la liste filtrée complète dans l’ordre de tri actuel - toutes les personnes qui satisfont les exclusions, le filtre prédéfini, le filtre rapide, les affinements, les lettres A–Z et le texte de recherche, et pas seulement celles affichées sur la page actuelle. Les données étant déjà en mémoire, le fichier est créé sans autre requête.
• Employee Directory interroge de nouveau le serveur pour obtenir tous les résultats de la requête en cours - le texte de recherche, la Requête enregistrée, les affinements sélectionnés et le filtre rapide Mon service - par pages de 100, puis crée le fichier. Pour un grand ensemble de résultats, cela prend du temps, car chaque page de 100 est une requête distincte.
• Avec le filtre rapide Mon équipe, Personnes avec qui je travaille ou Favoris, les deux composants WebPart exportent les personnes de cette liste.

Pendant la collecte des pages, le lien d’export est masqué. Les affichages Détails et Fiche contact montrent tous deux Exportation vers Excel et un compteur, par exemple « Enregistrements 1 ... 300 sur 1250 ». Laissez la page ouverte jusqu’au début du téléchargement.

Recommandations selon la taille de l’organisation

Ces recommandations sont générales. Le temps de chargement dépend du service, du réseau, du navigateur et des colonnes configurées. Testez avec un nouveau profil de navigateur ou après avoir effacé les données du site pour mesurer un chargement sans cache.

Symptômes et solutions

Articles connexes