sp-dev-fx-webparts/samples/react-outlook-copy2teams

Outlook to SharePoint

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-sp-spfx in action

A detailed functionality and technical description can be found in the author's blog series

Compatibility

⚠️ Important
Every SPFx version is only compatible with specific version(s) of Node.js. In order to be able to build this sample, please ensure that the version of Node on your workstation matches one of the versions listed in this section. This sample will not work on a different version of Node.
Refer to https://aka.ms/spfx-matrix for more information on SPFx compatibility.

Applies to

• Tutorial for creating Outlook Web Access extension using SharePoint Framework

Solution

Solution	Author(s)
outlook-2-sp-spfx	Markus Moeller (@moeller2_0)

Version history

Version	Date	Comments
1.0	January 29, 2020	Initial release
1.1	April 06, 2020	Open extensions to store metadata added

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
  • 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 then double-click an e-mail to open it in a window
  • Choose ... and Get Add-ins
  • Choose My Add-ins from left menu
  • Under Custom add-ins, choose + Add a custom add-in, then Add from file...
  • 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

This sample can also be opened with VS Code Remote Development. Visit https://aka.ms/spfx-devcontainer for further instructions.

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
• Optionally store metadata of save operation to copied mail with open extension (configure line 15 Outlook2SharePoint.tsx)

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.