sp-dev-fx-webparts/samples/react-staffdirectory/README.md

---
page_type: sample
products:
- office-sp
languages:
- javascript
- typescript
extensions:
  contentType: samples
  technologies:
  - SharePoint Framework
  - Msgraph
  - Fluent UI React Controls
  platforms:
  - React
  createdDate: 4/9/2020 12:00:00 AM
---

# Staff Directory (Search Directory)

## Summary

This web part shows the current user's colleagues, and allows the user to search AD directory, The user can configure the properties to show when expand the user card.

![staff](./assets/staffdirectory.gif)
![staff](./assets/staffTeams01.png)
![staff](./assets/staffTeams02.png)

## Compatibility

![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)
![Node.js v10](https://img.shields.io/badge/Node.js-v10-green.svg)
![Compatible with SharePoint Online](https://img.shields.io/badge/SharePoint%20Online-Compatible-green.svg)
![Does not work with SharePoint 2019](https://img.shields.io/badge/SharePoint%20Server%202019-Incompatible-red.svg "SharePoint Server 2019 requires SPFx 1.4.1 or lower")
![Does not work with SharePoint 2016 (Feature Pack 2)](https://img.shields.io/badge/SharePoint%20Server%202016%20(Feature%20Pack%202)-Incompatible-red.svg "SharePoint Server 2016 Feature Pack 2 requires SPFx 1.1")
![Teams Incompatible](https://img.shields.io/badge/Teams-Incompatible-lightgrey.svg)
![Local Workbench Incompatible](https://img.shields.io/badge/Local%20Workbench-Incompatible-red.svg "This solution requires API permissions")
![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg)

## Applies to

* [SharePoint Framework](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Office 365 tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)

## Solution

Solution|Author(s)
--------|---------
react-staffdirectory|Ari Gunawan ([@arigunawan3023](https://twitter.com/arigunawan3023))
react-staffdirectory|João Mendes ([joaojmendes](https://github.com/joaojmendes))
react-staffdirectory|[Tristian O'brien](https://github.com/tristian2)


## Version history

Version|Date|Comments
-------|----|--------
1.0.0|February 16, 2021|Initial release
1.0.1|March 28, 2021|Added missing Graph API Permission (User.Read.All) for getting users information
1.0.2|April 14, 2021|Added About Me and Skills 

## Minimal Path to Awesome

Please follow all the steps:

- Clone this repository
- in the command line run:
  - `npm install`
  - `gulp build`
  - `gulp bundle --ship`
  - `gulp package-solution --ship`
- Add and deploy package to your tenant's App Catalog
- Go to **API Access** - from **SharePoint Admin Center** new experience, and **Approve** the permission to use Microsoft Graph scopes **Presence.Read.All** and **User.Read.All**


## Disclaimer

**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**


<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-staffdirectory" />
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00			`---`
			`page_type: sample`
			`products:`
			`- office-sp`
			`languages:`
			`- javascript`
			`- typescript`
			`extensions:`
			`contentType: samples`
			`technologies:`
			`- SharePoint Framework`
			`- Msgraph`
			`- Fluent UI React Controls`
			`platforms:`
			`- React`
			`createdDate: 4/9/2020 12:00:00 AM`
			`---`

			`# Staff Directory (Search Directory)`

			`## Summary`

Update README.md 2021-02-18 10:29:13 -05:00			`This web part shows the current user's colleagues, and allows the user to search AD directory, The user can configure the properties to show when expand the user card.`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00
Fixed link to staff directory preview 2021-02-18 10:28:08 -05:00			`![staff](./assets/staffdirectory.gif)`
update docs 2021-03-09 18:08:05 -05:00			`![staff](./assets/staffTeams01.png)`
			`![staff](./assets/staffTeams02.png)`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00
Renamed solution and updated readme 2021-02-18 10:11:44 -05:00			`## Compatibility`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00
Updated compatibility tags 2021-10-30 22:34:42 -04:00			`![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)`
Removed reference to LTS 2021-11-01 21:07:49 -04:00			`![Node.js v10](https://img.shields.io/badge/Node.js-v10-green.svg)`
Updated compatibility tags 2021-10-30 22:34:42 -04:00			`![Compatible with SharePoint Online](https://img.shields.io/badge/SharePoint%20Online-Compatible-green.svg)`
			`![Does not work with SharePoint 2019](https://img.shields.io/badge/SharePoint%20Server%202019-Incompatible-red.svg "SharePoint Server 2019 requires SPFx 1.4.1 or lower")`
			`![Does not work with SharePoint 2016 (Feature Pack 2)](https://img.shields.io/badge/SharePoint%20Server%202016%20(Feature%20Pack%202)-Incompatible-red.svg "SharePoint Server 2016 Feature Pack 2 requires SPFx 1.1")`
			`![Teams Incompatible](https://img.shields.io/badge/Teams-Incompatible-lightgrey.svg)`
			`![Local Workbench Incompatible](https://img.shields.io/badge/Local%20Workbench-Incompatible-red.svg "This solution requires API permissions")`
			`![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg)`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00
			`## Applies to`

			`* [SharePoint Framework](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)`
			`* [Office 365 tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)`

			`## Solution`

			`Solution\|Author(s)`
			`--------\|---------`
Add missing Graph API permission 2021-03-28 06:54:43 -04:00			`react-staffdirectory\|Ari Gunawan ([@arigunawan3023](https://twitter.com/arigunawan3023))`
Renamed solution and updated readme 2021-02-18 10:11:44 -05:00			`react-staffdirectory\|João Mendes ([joaojmendes](https://github.com/joaojmendes))`
Fixed readme and package version 2021-04-21 22:43:28 -04:00			`react-staffdirectory\|[Tristian O'brien](https://github.com/tristian2)`

commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00

			`## Version history`

			`Version\|Date\|Comments`
			`-------\|----\|--------`
			`1.0.0\|February 16, 2021\|Initial release`
Add missing Graph API permission 2021-03-28 06:54:43 -04:00			`1.0.1\|March 28, 2021\|Added missing Graph API Permission (User.Read.All) for getting users information`
Fixed readme and package version 2021-04-21 22:43:28 -04:00			`1.0.2\|April 14, 2021\|Added About Me and Skills`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00
			`## Minimal Path to Awesome`

			`Please follow all the steps:`

			`- Clone this repository`
			`- in the command line run:`
			- `npm install`
			- `gulp build`
			- `gulp bundle --ship`
			- `gulp package-solution --ship`
			`- Add and deploy package to your tenant's App Catalog`
Add missing Graph API permission 2021-03-28 06:54:43 -04:00			`- Go to API Access - from SharePoint Admin Center new experience, and Approve the permission to use Microsoft Graph scopes Presence.Read.All and User.Read.All`
commit new webpart staffDirectory 2021-02-16 18:39:54 -05:00

Moved disclaimers to bottom 2021-11-07 01:54:14 -05:00			`## Disclaimer`

			`*THIS CODE IS PROVIDED AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**`


Updated sample and sample.json 2021-04-04 22:29:40 -04:00			`<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-staffdirectory" />`