sp-dev-fx-webparts/samples/react-onedrive-finder/README.md

91 lines
4.0 KiB
Markdown
Raw Normal View History

2021-04-16 05:21:04 -04:00
# OneDrive finder
## Summary
2021-04-21 23:17:37 -04:00
This sample access drives from OneDrive and navigate between his content using **Graph OneDrive and Site API and [Microsoft Graph Toolkit](https://github.com/microsoftgraph/microsoft-graph-toolkit) react controls "@microsoft/mgt-react**" with the addition of new control **[FileList](https://github.com/microsoftgraph/microsoft-graph-toolkit/blob/f8b8aa81d00bf426b94ee5016d511bc78b36e152/stories/components/fileList.stories.js#L136) "still preview version"** . This new control provides the ability to retrieve the Drive Library with associated Files and folders making easier to develop and navigate between tenant content and access to file.
2021-04-16 05:21:04 -04:00
**[FileList](https://github.com/microsoftgraph/microsoft-graph-toolkit/blob/f8b8aa81d00bf426b94ee5016d511bc78b36e152/stories/components/fileList.stories.js#L136)** control allow to load files base on graph querys or parameters ids.
### Retrieve Sites with drives associate
2021-04-21 23:17:37 -04:00
2021-04-19 03:06:04 -04:00
![Demo](./Assets/OneDrivefinderSample1.PNG)
2021-04-21 23:17:37 -04:00
2021-04-16 05:21:04 -04:00
### Navigate between folders and Breadcrumb
2021-04-21 23:17:37 -04:00
2021-04-19 03:06:04 -04:00
![Demo](./Assets/OneDrivefinderSample2.PNG)
2021-04-16 05:21:04 -04:00
### Navigate, search Files and filter extensions
![Demo](./Assets/OneDrivefinderSample3.gif)
2021-04-16 05:21:04 -04:00
2021-04-21 23:17:37 -04:00
## Compatibility
![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)
![Node.js LTS 10.x](https://img.shields.io/badge/Node.js-LTS%2010.x-green.svg)
![SharePoint Online](https://img.shields.io/badge/SharePoint-Online-yellow.svg)
![Teams N/A: Untested with Microsoft Teams](https://img.shields.io/badge/Teams-N%2FA-lightgrey.svg "Untested with Microsoft Teams")
![Workbench Hosted: Does not work with local workbench](https://img.shields.io/badge/Workbench-Hosted-yellow.svg "Does not work with local workbench")
2021-04-16 05:21:04 -04:00
## Applies to
- [SharePoint Framework](https://aka.ms/spfx)
- [Microsoft 365 tenant](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-developer-tenant)
## Solution
Solution|Author(s)
--------|---------
react-onedrive-finder | [André Lage](http://aaclage.blogspot.com) ([@aaclage](https://twitter.com/aaclage))
## Version history
Version|Date|Comments
-------|----|--------
1.2|April 30, 2021|Include content Search on Drive Library and Minimal style change
2021-04-26 21:28:04 -04:00
1.1|April 24, 2021|Fixes, optimization, Styling and extension filter included
2021-04-16 05:21:04 -04:00
1.0|April 16, 2021|Initial release
## 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.**
---
## Minimal Path to Awesome
- Clone this repository
- Ensure that you are at the solution folder
- in the command-line run:
- **npm install**
- **gulp serve**
- **gulp bundle --ship**
- **gulp package-solution --ship**
- Add to AppCatalog and deploy
## Grant the service principal permission to the Microsoft Graph API
Once installed, the solution will request the required permissions via the **Office 365 admin portal > SharePoint > Advanced > API access**.
2021-04-21 23:17:37 -04:00
If you prefer to approve the permissions in advance, for example when testing the solution in the Workbench page without installing it, you can do so using the [CLI for Microsoft 365](https://pnp.github.io/cli-microsoft365/):
2021-04-16 05:21:04 -04:00
```bash
o365 spo login https://contoso-admin.sharepoint.com
o365 spo serviceprincipal grant add --resource 'Microsoft Graph' --scope 'Files.Read'
o365 spo serviceprincipal grant add --resource 'Microsoft Graph' --scope 'Files.Read.All'
o365 spo serviceprincipal grant add --resource 'Microsoft Graph' --scope 'Sites.Read.All'
```
## Features
Description of the extension that expands upon high-level summary above.
This extension illustrates the following concepts:
- Easy to navigate between shared Drives using **Graph API and Breadcrumb**
- **[FileList](https://github.com/microsoftgraph/microsoft-graph-toolkit/blob/f8b8aa81d00bf426b94ee5016d511bc78b36e152/stories/components/fileList.stories.js#L136)** control allow to load documents base on graph querys or parameters ids.
2021-04-21 23:17:37 -04:00
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-onedrive-finder" />
2021-04-16 05:21:04 -04:00