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

113 lines
6.1 KiB
Markdown
Raw Normal View History

2021-11-07 00:52:25 -04:00
# Organization Directory
## Summary
2021-10-30 22:49:46 -04:00
Search People from Organization Directory and show live persona card on hover.
##
![directory](/samples/react-directory/assets/react-directory7.png)
![directory](/samples/react-directory/assets/react-directory8.png)
![directory](/samples/react-directory/assets/react-directory9.png)
![directory](/samples/react-directory/assets/react-directory.jpg)
![directory](/samples/react-directory/assets/react-directory-teams1.jpg)
![directory](/samples/react-directory/assets/react-directory2.jpg)
![directory](/samples/react-directory/assets/react-directory-teams2.png)
![directory](/samples/react-directory/assets/react-directory21.png)
![directory](/samples/react-directory/assets/react-directory3.jpg)
![directory](/samples/react-directory/assets/react-directory6.png)
![directory](/samples/react-directory/assets/react-directory5.jpg)
2020-09-18 11:13:17 -04:00
![directory](./assets/react-directory-withPaging.png)
2021-03-11 00:19:16 -05:00
## Compatibility
2021-10-30 22:49:46 -04:00
![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)
2021-11-01 21:07:49 -04:00
![Node.js v10](https://img.shields.io/badge/Node.js-v10-green.svg)
2021-10-30 22:49:46 -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 "The solution requires access to your organization directory")
![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg)
## Applies to
* [SharePoint Online](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Microsoft Teams](https://products.office.com/en-US/microsoft-teams/group-chat-software)
* [Office 365 tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)
2021-04-26 02:08:59 -04:00
## Web Part Properties
Property |Type|Required| comments
--------------------|----|--------|----------
2021-04-26 02:08:59 -04:00
Title | Text| No|Web Part Title
2020-10-18 21:20:05 -04:00
searchFirstName | boolean|No| Lastname or Firstname search query
Properties to search | text | No | By default **FirstName,LastName,WorkEmail,Department** are used for search. You can add custom properties separated by comma.
Properties to sent as clear text | text | No | By default if the search key has empty spaces, its replaced with **+** before sending it to the search query. The search properties mentioned here will be sent without the empty space replacemnt.
Results per page | number | Yes | Number of people result to be displayed per page. Max of **20** is allowed, default of **10** is set.
## Solution
2021-03-11 00:19:16 -05:00
2020-07-19 16:49:18 -04:00
The web part use PnPjs library, Office-ui-fabric-react components
Solution|Author(s)
--------|---------
2020-10-18 21:20:05 -04:00
Directory Web Part|João Mendes
2020-07-19 16:37:29 -04:00
Directory Web Part| Peter Paul Kirschner ([@petkir_at](https://twitter.com/petkir_at))
2020-09-18 11:13:17 -04:00
Directory Web Part| Sudharsan K ([@sudharsank](https://twitter.com/sudharsank))
2021-03-04 14:46:09 -05:00
Directory Web Part| Abderahman Moujahid
## Version history
Version|Date|Comments
-------|----|--------
1.0.0|July 29, 2019|Initial release
2020-07-19 16:49:18 -04:00
1.0.1|July 19, 2020|Bugfix and mock-service for workbench (```LivePersonaCard``` not supported in workbench)
2021-03-04 14:46:09 -05:00
2.0.0|Sep 18 2020|React hooks, paging, dynamic search props, result alignment using office ui fabric stack.
3.0.0|Oct 17 2020|Minor fixes and add the additional web part property.
3.0.1|March 4 2021|Bugfix 'Sort People by'
## Minimal Path to Awesome
- Clone this repository
- in the command line run:
- `npm install`
- `gulp build`
- `gulp bundle --ship`
- `gulp package-solution --ship`
2021-10-30 22:49:46 -04:00
- Add to AppCatalog and deploy
## 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're having issues building the solution, please run [spfx doctor](https://pnp.github.io/cli-microsoft365/cmd/spfx/spfx-doctor/) from within the solution folder to diagnose incompatibility issues with your environment.
You can try looking at [issues related to this sample](https://github.com/pnp/sp-dev-fx-webparts/issues?q=label%3A%22sample%3A%20react-directory") to see if anybody else is having the same issues.
2021-10-31 18:38:09 -04:00
You can also try looking at [discussions related to this sample](https://github.com/pnp/sp-dev-fx-webparts/discussions?discussions_q=react-directory) and see what the community is saying.
2021-10-31 18:38:09 -04:00
2021-11-20 23:55:10 -05:00
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%2Csample%3A%20react-directory&template=bug-report.yml&sample=react-directory&authors=@joaojmendes%20@petkir%20@sudharsank%20@Abderahman88&title=react-directory%20-%20).
2021-10-30 22:49:46 -04:00
2021-11-20 23:55:10 -05:00
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%3Aquestion%2Csample%3A%20react-directory&template=question.yml&sample=react-directory&authors=@joaojmendes%20@petkir%20@sudharsank%20@Abderahman88&title=react-directory%20-%20).
2021-10-30 22:49:46 -04:00
2021-11-20 23:55:10 -05:00
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%3Aenhancement%2Csample%3A%20react-directory&template=question.yml&sample=react-directory&authors=@joaojmendes%20@petkir%20@sudharsank%20@Abderahman88&title=react-directory%20-%20).
2021-11-07 02:11:17 -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.**
2021-12-20 10:25:30 -05:00
<img src="https://pnptelemetry.azurewebsites.net/sp-dev-fx-webparts/samples/react-directory" />