73 lines
3.3 KiB
Markdown
73 lines
3.3 KiB
Markdown
|
## outlook-2-teams-spfx
|
||
|
|
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
This SPFx Outlook Add-In lets you browse your OneDrive, joined Teams or Groups and select a folder to save your complete mail in there.
|
||
|
|
This sample shows you working with the current Office context and receive information on currently selected mail from there.
|
||
|
|
Furthermore it shows you how to retrieve a complete mail as a mimestream via Microsoft Graph and finally two file operations with Microsoft Graph as well:
|
||
|
|
* Writing normal files smaller 4MB
|
||
|
|
* Writing big files with an UploadSession when bigger than 4MB
|
||
|
|
|
||
|
|
## outlook-2-teams-spfx in action
|
||
|
|
|
||
|
|
|
||
|
|
A detailed functionality and technical description can be found in the [author's blog series](https://mmsharepoint.wordpress.com/2020/01/11/an-outlook-add-in-with-sharepoint-framework-spfx-introduction/)
|
||
|
|
|
||
|
|
## Used SharePoint Framework Version
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Applies to
|
||
|
|
|
||
|
|
* [Tutorial for creating Outlook Web Access extension using SharePoint Framework](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/get-started/office-addins-tutorial)
|
||
|
|
|
||
|
|
## Solution
|
||
|
|
|
||
|
|
Solution|Author(s)
|
||
|
|
--------|---------
|
||
|
|
outlook-2-teams-spfx| Markus Moeller ([@moeller2_0](http://www.twitter.com/moeller2_0))
|
||
|
|
|
||
|
|
## Version history
|
||
|
|
|
||
|
|
Version|Date|Comments
|
||
|
|
-------|----|--------
|
||
|
|
1.0|February 05, 2020|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
|
||
|
|
* in the command line run:
|
||
|
|
* restore dependencies: `npm install`
|
||
|
|
From here you can also follow the deployment steps from the official [Microsoft Tutorial](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/get-started/office-addins-tutorial#packaging-and-deploying-your-solution-to-sharepoint)
|
||
|
|
* build solution `gulp build --ship`
|
||
|
|
* bundle solution: `gulp bundle --ship`
|
||
|
|
* package solution: `gulp package-solution --ship`
|
||
|
|
* locate solution at `.\sharepoint\solution\outlook-2-sp-spfx.sppkg`
|
||
|
|
* upload it to your tenant app catalog
|
||
|
|
* Go to your Outlook Web Access and selct a mail
|
||
|
|
* Choose ... and "Get Add Ins"
|
||
|
|
* Choose My Add-ins from left menu
|
||
|
|
* Choose *Add from file... under the Custom add-ins
|
||
|
|
* Upload the manifest xml file from \officeAddin folder
|
||
|
|
* Click Install on the warning message to get your add-in available on the tenant
|
||
|
|
* Close the add-in window by clicking X on the top-right corner
|
||
|
|
* Activate again the context menu from [...] and choose "Copy to SharePoint" to activate the add-in in your inbox
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
This Outlook Add-In shows the following capabilities on top of the SharePoint Framework:
|
||
|
|
|
||
|
|
* Select Office context and attributes of currently selected mail
|
||
|
|
* Use Microsoft Graph to retrieve joined Groups and Teams
|
||
|
|
* Use Microsoft Graph to retrieve folders and subfolders for OneDrive or Teams/Group drives
|
||
|
|
* Use Microsoft Graph to retrieve complete mail mimestream by given ID
|
||
|
|
* Use Microsoft Graph to save normal or big files (in size bigger 4MB) with different concepts
|
||
|
|
|
||
|
|
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-outlook-copy2teams" />
|