Employee Directory

This Employee Directory WebPart displays all your Employees as a Directory list with predefined filters from the user profile store

Using the UserProfileStore to build an Employee Directory list with filter options.

Configuration


WebPart Properties
Property NameDescription
FieldTemplate Define Fields to display and if necessary, rename the Title column with a pipe “|” a “!” will exclude the field from displaying, but makes the value available to filter.
Example: id;Title|Object;
Specials: fieldname=filter, sets the field to be a clickable filter to send to other Webparts.
=photo, users the Url field to display the User Photo
=userdetails, sets the current column to have a details dialog function to show more details.
using search enable disable (search reduce API calls, but not all fields are available by default)
A-Z Fieldname enter a title (altered) column name to link the A-Z Filter to
Filter fields define searchboxes to filter columns.
Example: FieldName1;@FieldName2 this will create a normal text input box for list column FieldName1 and a dropdown box for list column name FieldName2.
Show only Search results Will only show a searchbox and filter the loaded data (shows only the results)
Show search box enable / disable search box
Alternate row color set an alternate row color
Picture source Outlook, userphotos (default)
enable Export to Excel enable disable
Options -
User Details
FieldTemplate Use HTML and CSS to create a userDetail FieldTemplate. Use curly brackets surrounding user profile properties, to show it's values.
Example: {FirstName}
Table CSS
Header CSS Style the table header row with CSS
Header Column CSS Style the table header column with CSS
Filter fields CSS Style the filter fields section with CSS
A-Z Container CSS Style the A-Z Container with CSS
A-Z Items CSS Style the A-Z Items with CSS
A-Z Items (Active) CSS Style the active A-Z Items with CSS
A-Z Items (available letters) CSSStyle the available A-Z Items with CSS Filter fields CSS
Style the filter fields section with CSS Buttons CSS
Style the buttons (Export, Clear Filters) with CSS Custom CSS
Style the Table with CSS
Sorting
Default order by column Nbr. Select the order by column as a number from the FieldTemplate (starts with 0) or enter the column title (altered) name
Sort direction Ascending / Descending
Formatting
Birthday date Format Format the Date as needed with moments.js
Hiredate date Format Format the Date as needed with moments.js
Image Width (px) set the photo image with
Default page length to set the default item count each page.
Filtering
Refinement filtering Set the search query refinement filter.
Exclusion filter Highly flexible Filter to exclude list items from view.
Caching
Cache retention Time (Minutes) Set the Cache duration in Minutes. Set it to “0” to disable the Cache.
License
License Key Please enter your Paypal "Profile ID" or "Automatic payment ID" to unlock your WebPart. (Format: I-1A11SSBB2241)

Get a license

We offer different kinds of license

  • a PayPal subscription
  • a conservative invoice for a defined time period

  • Office 365

    Paypal

    Select your seats count (All active accounts having access to your tenant)
    If your seats count is over 2499, please request an Offer!

    SharePoint URL*
    Request an Offer

    Post a comment

    peter behler
    05/31/2019 19:38
    How do you display an email address and not the icon. I tried an old hack of WorkEmail/plain but doesn't seem to work.
    Raphael
    05/31/2019 19:54
    Hello Peter,

    within the WebPart property Field Tempalte, the WorkEmail field is by default set as: WorkEmail=mailiconto|Work e-mail
    To only display the e-mail as text, use the following property field string: WorkEmail=text|Work e-mail
    And to have a mailto link included, use the following setting: WorkEmail=mailto|Work e-mail
    Marty Trionfo
    03/06/2020 19:06
    Hi. Are there instructions available for the Exclusions syntax? I am familiar with the on-prem version (SP2010) so would like to use something like "Lastname NOT IN ('Temp', 'Test', 'Intern', etc.)" without having to list complete usernames or email addresses.
    Thank you.

    Raphael
    03/09/2020 10:59
    Marty,

    we have attached a small documentation about the exclusion filter: Document
    Marty Trionfo
    03/09/2020 19:06
    Raphael - That doc is a great help and thank you for the quick response!
    MT
    Laurie
    03/30/2020 16:06
    If I don't want any information to show, until the user selects an option, either a letter or a department, can this be done?
    Raphael
    04/01/2020 13:28
    Laurie,

    this feature is currently not implemented.
    We have set a note for the next release.
    Laurie
    04/03/2020 14:04
    Raphael, is there a timeline for the next release?
    Raphael
    04/08/2020 11:17
    Laurie,

    there is currently no timeline for the next release date.
    If we find some free time, we are looking into your requested feature and get back to you by email.
    Martin Spittau Dupont
    05/05/2020 12:42
    Hi,
    We are having some issues when loading the users, it seems that it only load a "subset" of users and not all of them (as of now it seems to be that it only loads around 500 users).
    We have no exclusion filters enabled in the webpart.
    Jason Brewington
    05/12/2020 14:07
    Having the same issue Martin Spittau Dupont is having. Only 500 employees showing and no Exclusion filter is set.
    Raphael Bloch
    05/12/2020 14:09
    Martin, Jason,

    we have released a new version on 11th of may, which is addressing this issue.
    Please update to the most recent version.
    Jason Brewingtong
    05/12/2020 15:13
    Updated to the latest version 1.3.0.1 but still only getting 500 employees.
    Raphael
    05/12/2020 18:43
    Jason,

    please clear the web part cache. This will do the trick to get the new results loaded by SharePoint.
    Otherwise you can wait until the cache expires (default: 240 minutes)
    Janice
    06/26/2020 16:20
    Hey.. I am testing the app.. and I added some more fields to the field template, but I get an error for them.... they are Title, Manager & Division.. The error says "Undefined" for every staff member. How do I fix this? thx
    Raphael Bloch
    06/26/2020 16:26
    Janice,

    the default settings is using fast search to return from search database.
    There are just a junk of fields available by this mechanism by default. But you can add them in your search schema.
    It will take a couple of days until the database is updated. It's not possible to trigger this crawl externally..

    If you are having not much accounts / profiles (less than 200), you can disable the fast search option and crawl thru all the profiles and get it's property values.
    This will generate a lot of request's against sharepoint and can start throttling your account. This is the point, we will active the cache inside the web part properties (Cache retention time).

    But for production is is recommanded to use the fast search function and implement all necessary fields into your search schema.
    Caroline
    08/07/2020 20:09
    Can you tell me what field name to use to display the Job Title in the list view. I've tried "Job Title", "Title", "JobTitle", "SPS-JobTitle" and the results display undefined.
    Jason Brewington
    08/09/2020 18:57
    I there a way to have the Directory automatically start in alphabetical order? We can click on the name field and it sorts it in order but users want it to start this way.
    Raphael Bloch
    08/10/2020 06:51
    Caroline,

    please use: JobTitle as the property to receive SPS-JobTitle value.
    If you like to extend the amount of available fields, please modify the search schema with additional refinablestring or refinabledate values mapped to properties.
    Admin panel -> SharePoint ->More features -> Search - > Manage Search Schema.
    User a unused Managed Property called RefinableString / RefinableDate and map a crawled property to. After a couple of days, this values are also available in your table view.
    Raphael Bloch
    08/10/2020 06:52
    Jason,

    yes there is a way to do that.
    Please have a look at the "Default order by column Nbr. or Fieldname" property and select the column to order by default.
    Laurie
    10/28/2020 17:52
    In March, I had asked this question, "If I don't want any information to show, until the user selects an option, either a letter or a department, can this be done?". Is this possible in the newer releases?
    Raphael
    10/29/2020 09:59
    Laurie,

    please update to the most recent version.
    the new property: "Show only Search result" will display items found by the general searchbox over all fields.