--- title: "Aangepaste Entra ID-kenmerken tonen in het webonderdeel Employee Directory" description: "Toon aangepaste Microsoft Entra ID-gebruikerskenmerken in Vitextra Employee Directory en Employee Directory (Entra ID) op SharePoint en in Teams: directory-extensies, extensionAttribute1–15 uit lokale Active Directory en andere gebruikerseigenschappen." url: https://vitextra.com/nl/support/kb/10060 language: nl published: 2026-11-05 modified: 2026-11-07 products: - "Employee Directory" author: "Līga Ozola" tags: ["aangepaste Entra ID kenmerken", "directory-extensies", "extension_appId_attributeName", "extensionAttribute1", "onPremisesExtensionAttributes", "Employee Directory (Entra ID)", "Microsoft Graph gebruikerseigenschappen", "Active Directory synchronisatie", "Get-MgUser", "aangepaste kolommen"] --- # Aangepaste Entra ID-kenmerken tonen in het webonderdeel Employee Directory Toon aangepaste Microsoft Entra ID-gebruikerskenmerken in Vitextra Employee Directory en Employee Directory (Entra ID) op SharePoint en in Teams: directory-extensies, extensionAttribute1–15 uit lokale Active Directory en andere gebruikerseigenschappen. Organisaties bewaren vaak gegevens in hun directory waarvoor de standaardgebruikersvelden niet volstaan, zoals een kostenplaats, pasnummer of gebouw. In lokale ::Active Directory:: (AD) staan deze gegevens in aangepaste of ::extensiekenmerken:: die kunnen worden gesynchroniseerd met ::Microsoft Entra ID::. Organisaties die uitsluitend in de cloud werken, kunnen soortgelijke gegevens rechtstreeks aan Entra ID toevoegen. De webonderdelen Vitextra [Employee Directory](https://vitextra.com/nl/products/employee-directory) kunnen deze kenmerken tonen op SharePoint-sites en in ::Microsoft Teams::. Dit artikel beschrijft welke Entra ID-kenmerken worden ondersteund, hoe u hun exacte namen vindt en hoe u deze als aangepaste kolommen toevoegt aan: - het ::webonderdeel:: **Employee Directory (Entra ID)** en - het webonderdeel **Employee Directory** met de gegevensbron **Entra ID (Azure AD)**. 💡 **Tip** Bij de gegevensbron **Gebruikersprofielen** haalt **Employee Directory** aangepaste kenmerken uit SharePoint-gebruikersprofielen en beheerde zoekeigenschappen. Zie [KB10049. Aangepaste gebruikersprofielkenmerken toevoegen aan het webonderdeel Employee Directory](https://vitextra.com/nl/support/kb/10049). ## Ondersteunde kenmerken Beide webonderdelen lezen Entra ID-gegevens via ::Microsoft Graph::. Een aangepaste kolom is de naam van een eigenschap van het Graph-[gebruikersresourcetype](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties). Het webonderdeel vraagt deze samen met de ingebouwde velden op. Drie soorten namen worden ondersteund: | Kenmerktype | Wat u invoert bij Kolom | Voorbeeld | |---|---|---| | **Directory-extensies** - aangepaste kenmerken die via Microsoft Entra Connect vanuit lokale AD worden gesynchroniseerd of door een toepassing worden geregistreerd | De volledige extensienaam in de vorm `extension_{appId}_{attributeName}`, met `{appId}` als toepassings-id zonder koppeltekens | `extension_8f2a1c0e4b7d4c3a9e6f5d4c3b2a1f0e_costCenter` | | **On-premises extensiekenmerken** - de 15 kenmerken `extensionAttribute1`–`extensionAttribute15`, oftewel aangepaste Exchange-kenmerken, gesynchroniseerd vanuit AD of ingesteld voor uitsluitend cloudgebruikers | Alleen de kenmerknaam; het webonderdeel leest de waarde uit `onPremisesExtensionAttributes` | `extensionAttribute1` | | **Andere gebruikerseigenschappen** waarvoor geen ingebouwd veld bestaat | De Graph-eigenschapsnaam | `employeeHireDate`, `faxNumber`, `preferredLanguage`, `usageLocation` | Aangepaste kenmerken hebben in Entra ID andere namen dan in lokale AD. Een AD-kenmerk zoals `costCenter` verschijnt na synchronisatie als directory-extensie bijvoorbeeld als `extension_{appId}_costCenter`. Gebruik altijd de exacte naam die Microsoft Graph retourneert; namen zijn hoofdlettergevoelig. ❗ **Belangrijk** Schema-extensies en open extensies worden niet ondersteund. Vermijd ook gebruikerseigenschappen die Microsoft Graph alleen voor één gebruiker retourneert en niet in een gebruikerslijst, zoals `aboutMe`, `skills`, `interests`, `hireDate` en `mySite`. Als een aangepaste kolom naar zo'n eigenschap of een niet-bestaande naam verwijst, kan de ::lijst:: de gebruikers niet laden en verschijnt een foutmelding. ![Fout door een niet-ondersteunde eigenschap](https://static.vitextra.com/articles/10049/azure-ad-error-nl.png) *Fout door een niet-ondersteunde eigenschap* ## Vereisten U kunt kenmerknamen vinden met [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) of Microsoft Graph PowerShell. Hieronder wordt PowerShell gebruikt. Open PowerShell en installeer de Microsoft Graph PowerShell SDK: ``` Install-Module Microsoft.Graph -Scope CurrentUser ``` 📝 **Opmerking** De oudere PowerShell-modules `AzureAD` en `MSOnline` zijn buiten gebruik gesteld. Gebruik de onderstaande Microsoft Graph PowerShell-cmdlets in plaats van `Connect-AzureAD` en `Get-AzureADUser`. ### Verbinding maken met uw omgeving Maak verbinding met Microsoft Graph met machtigingen om gebruikers en directorygegevens te lezen: ``` Connect-MgGraph -Scopes "User.Read.All", "Directory.Read.All" ``` U wordt gevraagd zich aan te melden met uw werkaccount en zo nodig toestemming te geven voor de gevraagde machtigingen. ![Verbinding maken met Microsoft Graph met een werkaccount](https://static.vitextra.com/articles/10060/connect-azuread-cmdlet-nl.png) *Verbinding maken met Microsoft Graph met een werkaccount* ### Aangepaste kenmerken opvragen Voer de volgende opdracht uit om de directory-extensies van uw ::tenant:: weer te geven: ``` Get-MgDirectoryObjectAvailableExtensionProperty | Select-Object Name, DataType, IsSyncedFromOnPremises ``` De kolom **Name** bevat de volledige namen (`extension_{appId}_{attributeName}`) voor het webonderdeel. Extensies waarbij **IsSyncedFromOnPremises** is ingesteld op `True`, komen uit lokale AD. Vervang `dbadmin@vitextra.onmicrosoft.com` door de aanmeldnaam van een gebruiker met de gewenste kenmerken en voer de volgende opdrachten uit om de waarden te controleren: ``` $userLogin = "dbadmin@vitextra.onmicrosoft.com" # extensionAttribute1–15 (Get-MgUser -UserId $userLogin -Property "onPremisesExtensionAttributes").OnPremisesExtensionAttributes | Format-List # a directory extension (use a name from the list above) (Get-MgUser -UserId $userLogin -Property "extension_8f2a1c0e4b7d4c3a9e6f5d4c3b2a1f0e_costCenter").AdditionalProperties ``` Graph Explorer retourneert dezelfde gegevens via `GET https://graph.microsoft.com/v1.0/users/{user}?$select=displayName,onPremisesExtensionAttributes` en `POST https://graph.microsoft.com/v1.0/directoryObjects/getAvailableExtensionProperties`. ![Aangepaste kenmerken van een gebruikersobject in Microsoft Entra ID](https://static.vitextra.com/articles/10060/get-azureaduser-nl.png) *Aangepaste kenmerken van een gebruikersobject in Microsoft Entra ID* ## Eigenschappen van het webonderdeel U stelt aangepaste kolommen in beide webonderdelen op dezelfde manier in: 1. Open de pagina met het webonderdeel, selecteer **Bewerken** en daarna het potloodpictogram van het webonderdeel om het eigenschappenvenster te openen. 2. Controleer bij **Employee Directory** in de sectie **Gegevensbron** of **Gegevensbron** op **Entra ID (Azure AD)** staat. Selecteer **Configureren** onder **Aangepaste kolommen**. ![Aangepaste kolommen in de instellingen](https://static.vitextra.com/articles/10060/web-part-settings-nl.png) *Aangepaste kolommen in de instellingen* 3. Het venster **Kolommen** wordt geopend. Voer in de lege rij onderaan de kenmerknaam in bij **Kolom** en het label voor gebruikers bij **Bijschrift**. Kies waar de kolom wordt getoond. 4. Selecteer **Nieuw item toevoegen**, het plusteken aan het einde van de rij. Herhaal dit voor elk gewenst kenmerk. 5. Pas de positie aan met **Volgorde** en selecteer **Opslaan**. 6. Publiceer de pagina om de aangepaste kenmerken beschikbaar te maken. ![Instellingen voor aangepaste kolommen](https://static.vitextra.com/articles/10060/custom-columns-nl.png) *Instellingen voor aangepaste kolommen* Elke aangepaste kolom heeft de volgende instellingen: | Instelling | Beschrijving | |---|---| | **Toon in de lijst** | Toont het kenmerk in de ::weergave:: **Details** en neemt het op in de Excel-export. Standaard geselecteerd voor een nieuwe rij. | | **Toon op de kaart** | Toont het kenmerk in het detailvenster dat verschijnt wanneer u een persoon selecteert. | | **Kan worden doorzocht** | Alleen **Employee Directory (Entra ID)**. Het zoekvak doorzoekt ook dit kenmerk. | | **Kolom** | De kenmerknaam, zoals beschreven bij [Ondersteunde kenmerken](#attribute-name). Verplicht. | | **Bijschrift** | Het label in de kolomkop en het detailvenster. Verplicht. | | **Volgorde** | De positie tussen de aangepaste kolommen. Deze volgen na de ingebouwde kolommen. | Selecteer **Rij verwijderen**, het prullenbakpictogram aan het einde van de rij, en daarna **Opslaan** om een aangepaste kolom te verwijderen. 📝 **Opmerking** **Employee Directory** bewaart één lijst met aangepaste kolommen voor beide gegevensbronnen en biedt geen optie **Kan worden doorzocht**. Als u **Gegevensbron** wijzigt in **Gebruikersprofielen**, vervangt u de Entra ID-kenmerknamen door beheerde zoekeigenschappen zoals beschreven in [KB10049](https://vitextra.com/nl/support/kb/10049). Na het opslaan verschijnen aangepaste kenmerken met **Toon op de kaart** in het detailvenster als de persoon een waarde heeft: ![Detailvenster van een medewerker](https://static.vitextra.com/articles/10060/employee-details-pane-nl.png) *Detailvenster van een medewerker* ### Waar aangepaste kolommen verschijnen U kunt aangepaste kolommen op dezelfde plaatsen gebruiken als ingebouwde velden: - **Detailweergave** en **Exporteren naar Excel** - wanneer **Toon in de lijst** is geselecteerd. Zie [KB10062. Zoekresultaten van Employee Directory exporteren naar Microsoft Excel](https://vitextra.com/nl/support/kb/10062). - **Detailvenster** - wanneer **Toon op de kaart** is geselecteerd. Zie [KB10199. Employee Directory: het detailvenster aanpassen](https://vitextra.com/nl/support/kb/10199). - **Contactkaarten** en **Groeperen op** - aangepaste kolommen staan in de lijsten **Inhoudsvelden** en bij **Groeperen op** in **Opmaak**. Zie [KB10314. Employee Directory: details, kaarten, kaartgrootte, kaartvelden en groepering](https://vitextra.com/nl/support/kb/10314). - **Filter**, alleen **Employee Directory (Entra ID)** - gebruik aangepaste kolommen in filtervoorwaarden om de getoonde personen te beperken. Zie [KB10311. Employee Directory (Entra ID) configureren: filters, uitsluitingen en A–Z-navigatie](https://vitextra.com/nl/support/kb/10311). 📝 **Opmerking** **Employee Directory (Entra ID)** bewaart een kopie van de lijst in de browser en vernieuwt deze automatisch na 24 uur. Als u aangepaste kolommen wijzigt, worden de gegevens voor u opnieuw geladen. Andere gebruikers zien nieuwe waarden na de volgende vernieuwing of direct als zij **Vernieuwen** naast **Laatst bijgewerkt** selecteren. ## Samenvatting Aangepaste Entra ID-kenmerken - directory-extensies uit lokale AD, `extensionAttribute1`–`extensionAttribute15` en andere gebruikerseigenschappen - breiden uit wat de Employee Directory-webonderdelen tonen in ::SharePoint:: en Microsoft Teams. Zoek de exacte naam via Microsoft Graph PowerShell of Graph Explorer, voeg deze toe bij **Aangepaste kolommen** en kies of het kenmerk in de lijst, het detailvenster, de zoekfunctie, groepen of de export verschijnt.