Aangepaste gebruikersprofielkenmerken toevoegen aan het webonderdeel Employee Directory

In dit artikel leest u hoe u aangepaste SharePoint-gebruikersprofieleigenschappen toont in het webonderdeel Vitextra Employee Directory met de gegevensbron Gebruikersprofielen: hoe u de eigenschap voorbereidt in SharePoint, beschikbaar maakt via de zoekfunctie en als aangepaste kolom toevoegt aan het webonderdeel.

Inleiding

Naast ingebouwde velden zoals naam, functie, afdeling en telefoonnummers kan het webonderdeel Employee Directory aanvullende kenmerken tonen, zoals kostenplaats, personeelsnummer, gebouw of hobby. Deze kenmerken heten aangepaste kolommen en worden ingesteld in de editor Aangepaste kolommen van het webonderdeel.

Bij de gegevensbron Gebruikersprofielen leest het webonderdeel medewerkersgegevens via SharePoint Search. Een aangepaste gebruikersprofieleigenschap is daarom pas beschikbaar nadat deze is geïndexeerd en aan een beheerde eigenschap is gekoppeld. Het proces bestaat uit drie stappen:

1. Maak een gebruikersprofieleigenschap aan of gebruik een bestaande en zorg dat deze wordt geïndexeerd.
2. Koppel de verkende eigenschap aan een opvraagbare beheerde eigenschap in het zoekschema.
3. Voeg de beheerde eigenschap als aangepaste kolom toe aan het webonderdeel.

De gebruikersprofieleigenschap voorbereiden

U voert deze stappen uit in het SharePoint-beheercentrum. Hiervoor zijn SharePoint-beheerdersrechten vereist. Als de gewenste eigenschap al bestaat en aan een beheerde eigenschap is gekoppeld, gaat u naar De aangepaste kolom toevoegen aan het webonderdeel.

De gebruikersprofieleigenschap maken

1. Ga in het SharePoint-beheercentrum naar Meer functies en selecteer Openen onder Gebruikersprofielen.
2. Selecteer onder Personen de optie Gebruikersprofieleigenschappen beheren en vervolgens Nieuwe eigenschap.
3. Voer de Naam in - de interne naam, bijvoorbeeld CostCenter - evenals de Weergavenaam en het Type.
4. Selecteer onder Zoekinstellingen de optie Geïndexeerd. Zonder deze optie wordt de eigenschap niet verkend en kan het webonderdeel deze niet tonen.
5. Stel het beleid en de bewerkingsinstellingen in volgens de behoeften van uw organisatie en selecteer OK.

Vul de eigenschap in voor uw gebruikers, via hun profiel, uw importproces of een script. De zoekfunctie maakt de verkende eigenschap People:<Name> - bijvoorbeeld People:CostCenter - wanneer profielen worden verkend waarin deze eigenschap een waarde heeft.

Koppelen aan een beheerde eigenschap

1. Ga in het SharePoint-beheercentrum naar Meer functies en selecteer Openen onder Zoeken.
2. Selecteer Zoekschema beheren.
3. Kies een beheerde eigenschap voor de waarde. De eenvoudigste optie is een ongebruikte ingebouwde eigenschap uit RefinableString00–RefinableString99. Deze eigenschappen zijn al doorzoekbaar, opvraagbaar, verfijnbaar en sorteerbaar. U kunt ook een nieuwe beheerde eigenschap van het type Tekst maken en Opvraagbaar inschakelen.
4. Open de beheerde eigenschap. Selecteer onder Toewijzingen aan verkende eigenschappen de optie Een toewijzing toevoegen, zoek People:<Name> en voeg deze toe.
5. Sla de beheerde eigenschap op.

Noteer de exacte naam van de beheerde eigenschap, bijvoorbeeld RefinableString05. U voert deze later in het webonderdeel in.

De aangepaste kolom toevoegen aan het webonderdeel

1. Open de pagina met het webonderdeel Employee Directory, selecteer Bewerken en selecteer het potloodpictogram van het webonderdeel om het eigenschappenvenster te openen.
2. Controleer in de sectie Gegevensbron of Gegevensbron is ingesteld op Gebruikersprofielen.
3. Selecteer Configureren onder Aangepaste kolommen.

4. Het venster Kolommen wordt geopend. Voer in de lege rij onderaan de tabel bij Kolom de naam van de beheerde eigenschap in en bij Bijschrift het label dat gebruikers zien. Kies waar de kolom wordt getoond.
5. Selecteer Nieuw item toevoegen, het plusteken aan het einde van de rij. De kolom wordt aan de tabel toegevoegd. Herhaal dit voor elk gewenst kenmerk.
6. Wijzig met Volgorde de positie van de kolommen en selecteer Opslaan.
7. Publiceer de pagina opnieuw.

Elke aangepaste kolom heeft de volgende instellingen:

Selecteer Rij verwijderen, het prullenbakpictogram aan het einde van de rij, en vervolgens Opslaan om een aangepaste kolom te verwijderen. Annuleren sluit het venster zonder uw wijzigingen toe te passen.

Waar aangepaste kolommen verschijnen

Na het opslaan kunt u een aangepaste kolom op dezelfde plaatsen gebruiken als ingebouwde velden:

• Detailweergave - als kolom in de lijst wanneer Toon in de lijst is geselecteerd.
• Detailvenster - onder de ingebouwde kenmerken wanneer Toon op de kaart is geselecteerd en de persoon een waarde heeft. Zie KB10199. Employee Directory: het detailvenster aanpassen.
• Contactkaarten - als een van de kaartregels die u kiest in de sectie Inhoudsvelden.
• Groeperen op - de vervolgkeuzelijst Groeperen op in de sectie Opmaak bevat elke aangepaste kolom. U kunt personen bijvoorbeeld op kostenplaats of gebouw groeperen.
• Exporteren naar Excel - kolommen waarvoor Toon in de lijst is geselecteerd, worden opgenomen in het geëxporteerde werkblad.
• Verfijningspaneel - u kunt een verfijnbare beheerde eigenschap, zoals RefinableString05, ook als verfijning toevoegen. Zie KB10313. Het verfijningsvenster instellen in Employee Directory.

Als een aangepaste kolom leeg is

Controleer het volgende als de kolom of het detailvenster geen waarde toont:

• De gebruikersprofieleigenschap is gemarkeerd als Geïndexeerd en de persoon heeft daadwerkelijk een waarde voor die eigenschap.
• De verkende eigenschap People:<Name> is gekoppeld aan de beheerde eigenschap en die beheerde eigenschap is Opvraagbaar.
• De profielen zijn verkend nadat u het zoekschema hebt gewijzigd. Nieuwe toewijzingen worden niet onmiddellijk toegepast.
• De naam bij Kolom komt exact overeen met de naam van de beheerde eigenschap.

Het detailvenster toont een aangepast kenmerk alleen als het gegevens bevat. Een lege waarde wordt dus niet weergegeven.

De gegevensbron Microsoft Entra ID

Wanneer het webonderdeel gegevens via Microsoft Graph uit Microsoft Entra ID leest, verwijst een aangepaste kolom naar een eigenschap van het Entra ID-gebruikersobject in plaats van naar een beheerde eigenschap: een standaardgebruikerseigenschap, een directory-extensie (extension_{appId}_{name}) of een van de on-premises extensiekenmerken extensionAttribute1–extensionAttribute15. Het zoekschema speelt hierbij geen rol.