95 lines
4.4 KiB
Markdown
95 lines
4.4 KiB
Markdown
# Telephone Directory using React, Microsoft Graph and SPFx
|
|
|
|
## Summary
|
|
|
|
This is sample web part using SPFx and MSGraph to fetch the users information based on First Name, Last Name and Email Address.
|
|
The web part will fetch data from directory using Graph API and display in details list.
|
|
|
|
|
|
|
|
## Used SharePoint Framework Version
|
|
|
|
## Compatibility
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 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)
|
|
* [Microsoft Graph API](https://docs.microsoft.com/en-us/graph/overview)
|
|
* [Fluent UI](https://developer.microsoft.com/en-us/fluentui#/)
|
|
* [PnP Controls](https://pnp.github.io/sp-dev-fx-controls-react/)
|
|
|
|
## Prerequisites
|
|
|
|
> Define Graph API scope to Package-solution.json
|
|
|
|
|
|
|
|
## Solution
|
|
|
|
Solution|Author(s)
|
|
--------|---------
|
|
react-graph-telephonedirectory | [Dipen Shah](https://github.com/Dips365) ([@Dips_365](https://twitter.com/Dips_365))
|
|
react-graph-telephonedirectory | [Aimery Thomas](https://github.com/a1mery) ([@aimery_thomas](https://twitter.com/aimery_thomas))
|
|
react-graph-telephonedirectory | [mrkhandev](https://github.com/mrkhandev)
|
|
|
|
|
|
## Version history
|
|
|
|
Version|Date|Comments
|
|
-------|----|--------
|
|
1.0|July 14,2020 | Initial Release
|
|
1.1|November 7,2020 | Upgraded to SPFx 1.11
|
|
1.2|August 7, 2021|Adding the Title from the Property Pane into the Web Part
|
|
|
|
|
|
## Minimal Path to Awesome
|
|
|
|
* Clone this repository
|
|
* in the command line run:
|
|
|
|
* `npm install`
|
|
* `gulp build`
|
|
* `gulp bundle`
|
|
* `gulp package-solution`
|
|
* [Upload .sppkg to appcatalog](https://www.slideshare.net/Dipen038/upload-sp-solution)
|
|
* `Go to SharePoint Admin to grant access on graph API ` https://<Tenant>-admin.sharepoint.com/_layouts/15/online/AdminHome.aspx?source=sitecollections#/webApiPermissionManagement
|
|
* `gulp serve`
|
|
|
|
## Features
|
|
|
|
Demonstrates integration of SPFx and Graph API to search the organizational users information.
|
|
|
|
Description of the web part with possible additional details than in short summary.
|
|
This Web Part illustrates the following concepts on top of the SharePoint Framework:
|
|
|
|
* Detail List control from Fluent UI
|
|
* Web part Title control from PnP React
|
|
* Microsoft Graph API
|
|
* External API Integration with SharePoint Framework
|
|
|
|
|
|
## 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.**
|
|
|
|
## Help
|
|
|
|
We do not support samples, but we this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.
|
|
|
|
If you encounter any issues while using this sample, [create a new issue](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=bug-report.yml&sample=react-graph-telephonedirectory&authors=@Dips365%20@a1mery%20@mrkhandev&title=react-graph-telephonedirectory%20-%20).
|
|
|
|
For questions regarding this sample, [create a new question](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=question.yml&sample=react-graph-telephonedirectory&authors=@Dips365%20@a1mery%20@mrkhandev&title=react-graph-telephonedirectory%20-%20).
|
|
|
|
Finally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=suggestion.yml&sample=react-graph-telephonedirectory&authors=@Dips365%20@a1mery%20@mrkhandev&title=react-graph-telephonedirectory%20-%20).
|
|
|
|
|
|
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-graph-telephonedirectory" />
|