Employee Directory in grote organisaties: paginering, caching, totalen en exportbeperkingen

Inleiding

De laadtijd hangt af van de directorygrootte, het netwerk, de browser en de configuratie. Bij duizenden of tienduizenden accounts wordt de manier van laden belangrijk: hoe snel verschijnt de eerste pagina, hoe snel reageren zoeken en verfijningen, hoe nauwkeurig zijn de totalen en hoe lang duurt een Excel-export?

De oplossing bevat twee directorywebonderdelen met verschillende laadmodellen. Employee Directory (Entra ID) laadt eenmaal de volledige lijst in de browser en werkt daarna in het geheugen. Employee Directory verstuurt bij elke zoekopdracht een serverquery en laadt de resultaten per pagina. Dit artikel beschrijft beide modellen, de relevante instellingen en de configuratie voor grote organisaties.

De twee laadmodellen in één oogopslag

Employee Directory (Entra ID): de volledige lijst in de browser

Eerste keer laden

Zonder cache leest het webonderdeel alle gebruikers uit Microsoft Graph in pagina's van 900 accounts. Het volgt de pagineringskoppelingen tot de laatste pagina binnen is. Pas daarna verschijnt de lijst. Tot dat moment ziet u een laadindicator. De laadtijd neemt dus toe met het aantal accounts in de tenant.

Twee instellingen veranderen wat Microsoft Graph retourneert:

• Geblokkeerde gebruikers uitsluiten, standaard aan in Medewerkers uitsluiten, wordt toegepast door Microsoft Graph. Uitgeschakelde accounts worden niet gedownload, wat het laden verkort.
• De kolom Manager: als Toon in de lijst of Toon op de kaart is ingeschakeld, wordt elke gebruiker samen met diens manager opgevraagd. Dit maakt aanvragen zwaarder en de cache groter. Als de kolom op beide plaatsen verborgen is, worden managers niet opgevraagd.

Alle overige uitsluitingen worden na het laden in de browser toegepast. Gastaccounts worden altijd weggelaten. Medewerkers zonder licentie uitsluiten, Werknemers met lege afdeling uitsluiten, Werknemers met lege functie uitsluiten en het vooraf ingestelde filter beperken de lijst verder. Ze verkorten de lijst, maar verminderen niet de gedownloade hoeveelheid gegevens.

Browsercache en vernieuwen

Na succesvol laden bewaart het webonderdeel de lijst als gecomprimeerde JSON in lokale browseropslag onder Vitextra.EmployeeDirectory.Data, samen met het laadtijdstip. Bij een volgend bezoek:

1. De directory gebruikt de gebruikerslijst uit de cache voordat een achtergrondvernieuwing plaatsvindt. Foto’s, aanwezigheid en andere functies kunnen aanvullende gegevens opvragen.
2. Als de kopie ouder is dan 24 uur, worden de gegevens op de achtergrond opnieuw geladen. De gecachte lijst blijft zichtbaar en wordt vervangen zodra de nieuwe gegevens beschikbaar zijn.

Boven de resultaten toont Laatst bijgewerkt: de ouderdom van de gegevens, bijvoorbeeld drie uur. Met Vernieuwen ernaast laadt u op verzoek de hele lijst opnieuw uit Microsoft Graph. Bij handmatig vernieuwen verschijnt de laadindicator, net als bij de eerste keer laden.

Mislukt een achtergrondvernieuwing of handmatige vernieuwing terwijl al een niet-lege lijst is geladen, dan behoudt het webonderdeel die lijst en het oorspronkelijke bijwerktijdstip. De waarschuwing De lijst kon niet worden bijgewerkt. De opgeslagen kopie wordt weergegeven. verschijnt, eventueel gevolgd door technische foutdetails. Na een mislukte handmatige vernieuwing maakt de laadindicator weer plaats voor de vorige lijst. Zonder eerder geladen niet-lege lijst verschijnt een foutmelding. Probeer Vernieuwen later opnieuw en controleer bij een blijvende waarschuwing de verbinding en goedgekeurde Microsoft Graph-machtigingen.

Houd rekening met het volgende:

• Browseropslag. De cache wordt gedeeld binnen hetzelfde browserprofiel en dezelfde SharePoint-origin, niet gescheiden per aangemeld Microsoft 365-account. Andere profielen en apparaten hebben eigen opslag. Browsergegevens wissen verwijdert de cache.
• Eén kopie voor alle webonderdelen. Alle Employee Directory (Entra ID)-webonderdelen in dezelfde browser op hetzelfde SharePoint-domein delen één kopie, ongeacht de pagina.
• Wijzigingen in Entra ID verschijnen na vernieuwen. Wijzigingen die Microsoft Graph teruggeeft, worden na een geslaagde achtergrond- of handmatige vernieuwing verwerkt, met de ingestelde filters en uitsluitingen.
• Sommige instellingen laden opnieuw, andere niet. Wijzigingen in Medewerkers zonder licentie uitsluiten, Werknemers met lege afdeling uitsluiten, Werknemers met lege functie uitsluiten, Geblokkeerde gebruikers uitsluiten of Aangepaste kolommen laden de lijst opnieuw. Het tonen van Manager doet dat niet: de cache is zonder managers geladen.

Als de browseropslag vol is

Lokale opslag heeft een beperkte capaciteit en wordt gedeeld met andere gegevens van dezelfde origin. Mislukt het opslaan van de gecomprimeerde directory, dan blijft de geladen lijst in het geheugen bruikbaar. Een oudere cachekopie kan blijven bestaan; zonder bruikbare kopie moet de volgende keer alles opnieuw worden geladen.

Typische signalen: elk bezoek duurt even lang als de eerste keer en Laatst bijgewerkt: toont steeds dat de gegevens zojuist zijn bijgewerkt. Beperk de gegevens door Geblokkeerde gebruikers uitsluiten aan te laten, Manager te verbergen als deze niet nodig is en alleen benodigde Aangepaste kolommen in te stellen.

Wat in het geheugen werkt

Tekstzoeken, verfijningen, A–Z-navigatie, Mijn afdeling, sortering, groepering, totalen en export verwerken de geladen lijst in de browser. De snelheid hangt af van lijstgrootte en apparaat. Zoeken op vaardigheden, persoonlijke snelfilters, rollidmaatschappen, foto’s, aanwezigheid en detailsecties kunnen nog netwerkaanvragen uitvoeren.

Het volgende aantal items per pagina weergeven: verandert niet wat wordt gedownload. Het beperkt alleen het aantal personen dat tegelijk wordt weergegeven. Meer resultaten weergeven... onder de lijst toont het volgende deel van de al geladen gegevens.

Employee Directory: één serverpagina tegelijk

Employee Directory bewaart geen volledige lijst in de browser. Bij het openen van de pagina, zoeken, selecteren van een verfijning of inschakelen van Mijn afdeling verstuurt het een nieuwe query naar Gegevensbron en ontvangt alleen de eerste resultatenpagina:

• Gebruikersprofielen - het webonderdeel voert een SharePoint-personenzoekopdracht uit. De paginagrootte bepaalt het aantal terug te geven rijen. Elke volgende pagina begint na de al geladen rijen. SharePoint Search retourneert de verfijningswaarden bij elke query.
• Entra ID (Azure AD) - het webonderdeel vraagt Microsoft Graph om gebruikers met de ingestelde paginagrootte. Graph retourneert een koppeling voor het volgende deel.

Bij meer resultaten verschijnt Meer resultaten weergeven.... Deze knop vraagt de volgende pagina op en voegt deze aan de lijst toe. Tijdens de aanvraag verschijnt Zoeken... in plaats van de knop.

Eén pagina opvragen beperkt de eerste gegevensoverdracht. Elke serverzoekopdracht of verfijningsselectie vereist nog een aanvraag; de vertraging hangt af van de service en query. Resultaten weerspiegelen de actuele Graph-reactie of SharePoint-zoekindex.

Mijn team, Mensen met wie ik samenwerk en Favorieten zijn in beide webonderdelen een uitzondering: zij tonen eigen korte lijsten die in de browser worden gefilterd en niet gepagineerd.

Paginagrootte instellen

De schuifregelaar Het volgende aantal items per pagina weergeven: in Gegevensbron bepaalt de paginagrootte. Het bereik en de standaardwaarde verschillen:

Er is geen aparte optie voor alles weergeven. Zet in Employee Directory (Entra ID) de schuifregelaar op 0. In Employee Directory blijven resultaten altijd gepagineerd; Meer resultaten weergeven... laadt de rest.

Totalen

Als Totalen weergeven in Opmaak is ingeschakeld, standaard aan, toont de werkbalk Totaal aantal resultaten:. De betekenis verschilt per model:

• Employee Directory (Entra ID) telt de gefilterde lijst in het geheugen, na uitsluitingen, het vooraf ingestelde filter, snelfilter, verfijningen, A–Z en zoektekst. Het aantal is exact en omvat het hele resultaat, niet alleen de huidige pagina.
• Employee Directory toont het servertotaal voor de huidige query: van SharePoint Search of Microsoft Graph. Bij Entra ID (Azure AD) en Zoeken op vaardigheden worden op vaardigheden gevonden personen toegevoegd. Het totaal omvat alle overeenkomsten, niet alleen geladen pagina's.
• Bij Mijn team, Mensen met wie ik samenwerk en Favorieten tellen beide webonderdelen de personen in die lijst.

Instellingen die de prestaties beïnvloeden

Excel-export bij grote resultaatsets

Met Microsoft Excel-werkblad in Exporteren ingeschakeld verschijnt Exporteren naar Excel boven de resultaten. Beide webonderdelen maken employee-directory.xlsx met één tabel Employees in Table Style Medium 2. De tabel bevat de kolommen uit Details waarvoor Toon in de lijst is ingesteld, in de gekozen volgorde, inclusief aangepaste kolommen, behalve Afbeelding en Status.

De inhoud hangt af van het laadmodel:

• Employee Directory (Entra ID) exporteert de volledige gefilterde lijst in de huidige sorteervolgorde, na alle uitsluitingen, filters, verfijningen, A–Z en zoektekst. Niet alleen de huidige pagina. De gegevens staan al in het geheugen; extra aanvragen zijn niet nodig.
• Employee Directory vraagt alle resultaten opnieuw op voor de huidige zoektekst, Opgeslagen query, verfijningen en Mijn afdeling, in pagina's van 100. Daarna maakt het het bestand. Grote sets kosten tijd, want elke pagina van 100 is een aparte aanvraag.
• Bij Mijn team, Mensen met wie ik samenwerk of Favorieten exporteren beide webonderdelen die lijst.

Tijdens het ophalen van pagina’s is de exportkoppeling verborgen. Zowel Details als Contactpersoon tonen Exporteren naar Excel en een teller, bijvoorbeeld ‘Records 1... 300 van 1250’. Houd de pagina open tot de download begint.

Aanbevelingen per organisatiegrootte

Dit zijn algemene aanbevelingen. De werkelijke laadtijd hangt af van service, netwerk, browser en ingestelde kolommen. Test met een nieuw browserprofiel of wis de browsergegevens van de site om een laadactie zonder cache te meten.

Problemen en oplossingen

Gerelateerde artikelen