You Are Here:   Guide To Porteo Intranet Separator Skip Navigation LinksConfiguration-O365

People Finder for Modern Sites is a SPFx (SharePoint Framework) web part, which allows to search and see employee profile information.

This information is pulled from AAD (Azure Active Directory) thru MS Graph API.

For more information about MS Graph API and how to query against it please check the following pages for further reference.

  • First, edit the page where People Finder web part is.

  • Then select People Finder web part and edit it as well.

  • From here you can see four main sections: Query, Search Parameter, Styling Options and Template Options​.

  • ​$select parameter value: Here you specify which fields you want to work with (either to display them on the screen or filter against it)

  • We suggest to use at a minumum the following fields: id, userPrincipalName, displayName, mail, jobTitle, mobilePhone, companyName, businessPhones, officeLocation, department, postalCode​

  • Copy and paste the above values as is, keep in mind they're case sensitive.

  • Also consider these are the internal field names, not the actual display names.

  • For more information about the $select parameter please check: ​

  • From here you can see which SimpleSharePoint products are installed, their current version, acces to their specific settings pages, and get more help accessing our online guide.

Configure eDirectory (Optional)
  1. Create a new page under Pages or Site Pages library named eDirectory.aspx (or similar)
  2. Add the following web part to the page: SimpleSharePoint > People Finder Directory


PeopleFinder is a SharePoint Web Part

  1. Edit your portal's homepage (or wherever you would like the People Finder to appear)
  2. Add the following web part: SimpleSharePoint > People Finder
  3. Save the page
  4. To configure People Finder settings (for both People Finder and eDirectory)
  5. Edit the home page again and click on the drop-down arrow for the People Finder webpart
  6. Choose the Configuration option

Once on PeopleFinder Settings page, you'll see the following fields available to configure:

  • AD/LDAP Connection Settings
  • AD/LDAP User Name
  • AD/LDAP Password
  • Encryption Key
  • Modal Window Size
  • eDirectory URL
  • Custom CSS URL

Following, we explain each field in detail:

AD/LDAP Connection Settings

 Please complete the following fields:

  • LDAP Connection String
    PeopleFinder supports multiple connection strings splitted by pipe "|" character, for example:
    It also supports mixed Organizational Units and Root Domains
    Do not use Caching option if piping LDAP strings
  • LDAP User Name
    A domain account with necessasy privilegies to read all users.
  • LDAP Password
    Above user's password.
    This password is encrypted for security reasons with a tool provided on the installation package.
  • Encryption Key
    The string key used to encrypt above password with the provided tool.


AD/LDAP Fields (Details View)

The bottom section of PeopleFinder Settings, under "Select fields to be displayed on search results page" allows you to individually select which fields to display on user's detail view.

LdapFields1.PNG        PeopleFinderUserDetails.PNG


Search Results Page (Grid View)

The bottom section of PeopleFinder Settings, under "Select fields to be displayed on search results page" allows you to individually select which fields to display.



Encryption Key

PeopleFinder package includes a tool for encrypting passwords.

This encrypted password increases security hiding the real password of the account used to query LDAP sources from occational/casual users having access to web part configuration.

Specify your Encryption Key and the user's password into Value field, then click Encrypt.

Finally, copy/paste the encrypted result into web part configuration LDAP Password section.


Modal Window Size

When displaying user's details in a modal window, the default values for window width and height are 800px by 600px respectively, but you can modify these settings for better readability and/or adjust to your company's most used screen resolution.



PeopleFinder includes a second web part called People Finder Directory, or simply, eDirectory which allows to filter users based on their Last Name first letter, plus displaying results in a nice tile view with user's pictures, if available.

 To enable this feature, go to web part properties, e-Directory URL, and set the URL of a web part page containing the People Finder Directory web part on it.

Once you set this property, on People Finder search form, a new link called eDirectory will be available.


Custom CSS URL

People Finder allows to specify your own custom CSS file, to override/customize colors, fonts, etc.

Upload your file to some library (for example Style Library or Site Assets), and then paste here a relative URL to that file (for example "/SIteAssets/mycustomstyles.css").


Still have questions? We’re happy to help!