Microsoft Sharepoint Web Parts

Staff Directory Sharepoint Web Part

The Staff Directory/Employee Directory Web Part reads the user entries from the MOSS User Profile Store (MOSS 2007 and Sharepoint 2010 /Sharepoint 2013/Sharepoint 2016 Standard or Enterprise) or a Sharepoint List (WSS 3.0 or Sharepoint 2010/Sharepoint 2013 Foundation or Sharepoint 2016) and displays the selected user fields in a list. Please note that there are 4 different versions of this Web Part depending on your Sharepoint environment: WSS 3.0/Sharepoint 2010, Sharepoint 2013 Foundation, Sharepoint 2016 or Office 365 (data based on a Sharepoint List) MOSS 2007 (data based on the MOSS User Profile Store) Sharepoint 2010 Standard or Enterprise Edition (data based on the User Profile Store) Sharepoint 2013/2016 Standard or Enterprise Edition (data based on the User Profile Store) The following parameters can be configured: Sharepoint Site User Properties to be displayed Filtering, Grouping, Searching, Paging and Sorting of rows AZ Index optional Header text Presence Information Product Price Staff Directory Web Part for WSS 3.0/Sharepoint 2010 Foundation 30 day Evaluation Version (Release 1.2.31) Free Staff Directory Web Part for Sharepoint 2013 Foundation 30 day Evaluation Version (Release 1.2.31) Free Staff Directory Web Part for Sharepoint 2016 (List based version) 30 day Evaluation Version (Release 1.2.31) Free Staff Directory Web Part for MOSS 2007 30 day Evaluation Version (Release 1.2.12) Free Staff Directory Web Part "Sandbox" On-premise only 30 day Evaluation Version (Release 1.0.15) Free Staff Directory Web Part for Office 365 Sharepoint Online/Office 365 30 day Evaluation Version (Release 3.0.2) Free Staff Directory Web Part for SP 2010 Server (Standard and Enterprise Editions) 30 day Evaluation Version (Release 2.0.29) Free Staff Directory Web Part for SP 2013 Server (Standard and Enterprise Editions) 30 day Evaluation Version (Release 2.0.29) Free Staff Directory Web Part for SP 2016 Server (Standard and Enterprise Editions) 30 day Evaluation Version (Release 2.0.29) Free Staff Directory Web Part License Key per Server License USD 200.00 Web Part Installation Instructions (WSS 3.0)  Web Part Installation Instructions (Sharepoint 2010/2013 Foundation)  Web Part Installation Instructions (MOSS 2007)  Web Part Installation Instructions (Sharepoint 2010 Standard/Enterprise)  Web Part Installation Instructions (Sharepoint 2013 Standard/Enterprise)  Notify me by e-mail if a new release is made available: You can also send us a PO via e-mail to [email protected]  or by fax to ++41 62 823 75 74

Installation Instructions:

1. download the Staff Directory Web Part Installation Instructions (PDF file, see above) 
   
2. either install the web part manually or deploy the feature to your server/farm as described in the instructions.
   
3. Security Note:
   if you get the following error message: "Only an administrator may enumerate through all user profiles", you will need to grant the application pool account(s) for the web application(s) ï¿½Manage User Profiles� permissions within the User Profile Sevice (SSP in case of MOSS2007). 
   This ensures that the application pool is able to retrieve the list of user profiles.
   To assign this permission, access your active "User Profile Service" (SP 2010 Server ) or the "Shared Services Provider" (MOSS2007) via Central Admin.
   From the �User Profiles and My Sites� group, click �Personalization services permissions�. 
   Add the �Manage User Profiles� permission to  your application pool account(s).
   
   
4. Configure the following Web Part properties in the Web Part Editor "Miscellaneous" pane section as needed:
   
   

   Site Name: Enter the name of the site (Shared Services Provider) that contains the User Profile Store: - leave this field empty if the User Profile is in the default SSP - Enter "current" if the User Profile is in the current site - Enter the Site name to choose a specific User Profile Service (or SSP in case of MOSS2007) Field Template: Enter the User properties to be displayed (separated by semicolons). The following out of the box properties are available (or you can use custom profile properties added to your MOSS2007 Shared Service Provider or your SP2010 User Profile Service Application): AccountName FirstName LastName PreferredName WorkPhone Office Department Title Manager AboutMe Presence PictureURL UserName QuickLinks WebSite WorkEmail Assistant CellPhone Fax HomePhone PersonalSpace SPS-Dotted-line SPS-Peers SPS-Responsibility SPS-Skills SPS-PastProjects SPS-Interests SPS-School SPS-SipAddress SPS-Birthday SPS-MySiteUpgrade SPS-HireDate SP2010/2013-only: SPS-AboutUs SPS-JobTitle SPS-Location SPS-MemberOf SPS-SipAddress SPS-TimeZone SPS-Team-Site SPS-StatusNotes (complete list of all available User Profile properties for SP2010 and SP2013) see here) Friendly Header Names: If you would like to display a �friendly header name� instead of the default property name please append it to the User profile property, separated by the �|� pipe symbol. Example: LastName|Last Name;FirstName;Department;WorkEmail|Email;WebSite|Website Formatting individual columns: You can apply a CSS style to a column by appending the CSS style attribute(s), prefixed by a colon. Separate multiple CSS styles by commas. LastName:font-weight:bold;FirstName;Department;WorkEmail LastName:font-weight:bold,font-face:Segoe UI;FirstName;Department;WorkEmail Hiding individual columns: You can hide a column by prefixing it with a "!" character. The following example hides the "Department" column: LastName;FirstName;!Department;WorkEmail Suppress Column wrapping: You can suppress the wrapping of text inside a column by prefixing it with a "^" character.  LastName;FirstName;Department;^AboutMe Showing the E-Mail address as plain text: You can opt to display the plain e-mail address (instead of the envelope icon) by appending "/plain" to the WorkEmail column: LastName;WorkEmail/plain;Department Online Presence Information: You can optionally add a presence indicator by adding the Presence column to the Field Template (MOSS 2007/SP2010 Server version) or by appending /presence to the desired column (WSS/Foundation version): OCS clickable phone numbers: To enable the display of phone numbers using the <a href="tel:123 45 67"> feature for OCS you need to prefix the columns with an "#" character. Presence;PictureURL;FirstName;LastName;#WorkPhone;WorkEmail;City Group By: enter an optional User property to group the rows. Sort By: enter the User property to define the default sort order. You can add multiple properties separated by commas. Examples: Department Department,LastName The columns headings can be clicked by the users to manually define the sort order. Property Filter: enter an optional Filter condition to apply a filter. Combine multiple conditions with AND and OR. You can look up the available filter operators in the PDF documentation. Examples: Department='IT' Department<> 'Sales' Department IN ('Sales', 'Development', 'IT') LastName NOT IS NULL AND Department='Sales' [SPS-Skills] LIKE '%Sharepoint%' [SPS-HireDate] < {today} [SPS-Birthday] > {today-7} [SPS-HireDate] <= {today+10} You can pass Querystring parameters in the page URL to the Filter by embedding the Querystring name(s) in curly braces: Example: Department='{Dept}' (produces Department='IT' if the URL contains ..yourpage.aspx?Dept=IT) Group Membership Filter: optionally enter either a Sharepoint Group or an Active Directory group to only display users that are a member of the specified group. Please make sure that the group is linked to the security permissions on the site. You can add multiple Sharepoint groups separated by semicolons. If you specify an AD group, please prefix it with an "@" character, as eg. @SomeADGroup AZ Index Column: enter an optional User property to display the AZ filter in the list header. If an "!" character is appended to the property name, the "A" index will be forced when visiting the page. Example: LastName! You can apply a custom CSS style to the AZ index by adding the following 2 appSettings variables to the web.config "appSettings" section: <appSettings>   <add key="AESD_AZstyle" value="background:#ffaa66; color:white" />   <add key="AESD_AZstyleActive" value="background:#ff0000; font-size:11pt; color:white" /> <appSettings> The example below uses a CSS border around each AZ Index letter: <add key="AESD_AZstyle" value="border:1px solid gray;padding:2px;font-weight:bold" /> Search Box: enter one or more User properties (separated by semicolons) to allow for interactive searching. Example: LastName;FirstName;Department If you want to display a search filter as a dropdown combo, please enter it with a leading "@" character: LastName;FirstName;Department;@Office You can pass Querystring parameters in the page URL to the Search box(es) by adding the corresponding User properties and the desired value(s) as name=value pairs. Example: ..yourpage.aspx?Department=IT&LastName=Miller Friendly Search Box Labels: If you would like to display a �friendly label" instead of the default property name please append it to the User property, separated by the �|� pipe symbol. Example: WorkPhone|Office Phone;Office|Office Nbr Align Search Filters vertically: allows you to align the seach input boxes vertically to save horizontal space: Rows per page: the Staff Directory web part supports paging and lets you specify the desired number of rows per page. Enter the value "0" to turn off paging. Image Height: specify the image height in pixels if you include the "PictureURL" property. Enter "0" if you want to use the default picture size. Use Image Thumbnails: use the user image thumbnails as generated by Sharepoint. Uncheck this option if your user profile images have not been uploaded via Sharepoint. Default User Image: (optional) specify a default user picture (if there is no user picture available) by entering a relative URL to the image Example: /yoursite/yourPictureLibrary/yourDefaultUser.jpg Header Text: enter an optional header text. Please note that you can embed HTML tags if needed. You can additionally specify the text to be displayed if the "Show all entries" option is unchecked and the users has not performed a search yet by appending a "|" character followed by the text. Example: This is the regular header text|This text is only shown if the user has not yet performed a search My Site Link: enter the desired display name of the �Personal Space� link. Enter the value "LastName" if you would like use the "LastName" column to link to the user's My Site. In this case the "PersonalSpace" column will automatically be suppressed. You can append the string /new if you want the link to open in a new window: Example: LastName/new You can also specify an icon instead of text by either pointing to an image in a Sharepoint Image Library or using the built-in icon by entering �mysite.gif�: Alternating Row Color: enter the optional color of the alternating row background (leave blank to use default). Enter either the HTML color names (as eg. "red" etc.) or use hexadecimal RRGGBB coding (as eg. "#CCFFCC"). Enter the values without the double quotes. You can also change the default background color of the non-alternating rows by appending a second color value separated by a semicolon. Example: #ffffcc;#ffff99 The default Header style can be changed by adding the "AESD_Headerstyle" appSettings variable to the web.config "appSettings" section: <appSettings>   <add key="AESD_Headerstyle" value="background:green;font-size:10pt;color:white" /> <appSettings> Show all entries: either show all directory entries or none when first visiting the page. You can append a specific text to the "Header Text" field (see above) which is only displayed if this option is unchecked and no search has yet been performed by the user: Show Column Headers: turn the column headers on or off. Show Print Button: Show/hide the "Print Directory" button for printing the Staff Directory Export to CSV: Show/hide the "Export" button for Excel CSV File Export CSV Separator: Enter the desired CSV field separator character (Default=Comma). Use a semicolon in countries which use the commas as a decimal separator. Localization: enter the following 7 values (separated by semicolons) in your local language if you need to override the English strings corresponding to the - Search button text, - A..Z menu "View all" option, - the text displayed when the "WebSite" User Property is included in the Template field - the "Group By" name - Export button - Print Directory button Default: Search;View all;Visit;;Export;Print Directory Example (German): Suche;Alle;externer Link;Gruppe;Exportieren;Drucken Cache Retention Time: enter the data cache retention time in minutes (enter "0" to turn off the cache feature) to speed up consecutive page visits. The use of this feature is recommened for large User Profile stores. License Key: enter your Product License Key (as supplied after purchase of the "Staff Directory Web Part" license key). Leave this field empty if you are using the free 30 day evaluation version.