sp-dev-fx-webparts/samples/react-outlook-copy2teams
Hugo Bernier f4bc97289e Added 1.8.x containers 2022-02-16 00:42:49 -05:00
..
.devcontainer Added 1.8.x containers 2022-02-16 00:42:49 -05:00
assets Removing unnecessary office product from the sample metadata 2021-12-10 19:55:32 +02:00
config Open extensions added to store metadata to saved mail 2020-04-06 18:14:16 +02:00
officeAddin Initial commit (#1130) 2020-02-08 12:50:01 +02:00
src Open extensions added to store metadata to saved mail 2020-04-06 18:14:16 +02:00
teams Initial commit (#1130) 2020-02-08 12:50:01 +02:00
.editorconfig Initial commit (#1130) 2020-02-08 12:50:01 +02:00
.gitignore Initial commit (#1130) 2020-02-08 12:50:01 +02:00
.yo-rc.json Initial commit (#1130) 2020-02-08 12:50:01 +02:00
README.md Added SPFx 1.10 containers 2022-02-15 00:50:11 -05:00
gulpfile.js Initial commit (#1130) 2020-02-08 12:50:01 +02:00
package-lock.json Initial commit (#1130) 2020-02-08 12:50:01 +02:00
package.json Initial commit (#1130) 2020-02-08 12:50:01 +02:00
tsconfig.json Initial commit (#1130) 2020-02-08 12:50:01 +02:00
tslint.json Initial commit (#1130) 2020-02-08 12:50:01 +02:00

README.md

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

WebPartInAction

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

Compatibility

SPFx 1.10 Node.js v10 | v8 Compatible with SharePoint Online Does not work with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Local Workbench Compatible Hosted Workbench Compatible Compatible with Remote Containers

Applies to

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.