sp-dev-fx-webparts/samples/react-yammer-praise/README.md

74 lines
2.5 KiB
Markdown
Raw Normal View History

2020-04-02 18:23:38 -04:00
# Yammer Praise using aadTokenProvider
2020-03-23 15:44:05 -04:00
## Summary
This sample shows how to post a praise to Yammer using aadTokenProvider (without Yammer JavaScript SDK).
![Post Praise to Yammer](./assets/screenshot.gif)
It also can be added to Microsoft Teams as Personal or Team Tabs.
![Post Praise to Yammer from Microsoft Teams](./assets/screenshot2.gif)
## Used SharePoint Framework Version
![SPFx v1.10.0](https://img.shields.io/badge/SPFx-1.10.0-green.svg)
## Applies to
* [SharePoint Framework Developer](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
* [Office 365 developer tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-developer-tenant)
2020-03-23 15:44:05 -04:00
## Solution
Solution|Author(s)
--------|---------
react-yammer-praise|Ramin Ahmadi
## Version history
Version|Date|Comments
-------|----|--------
1.0.0|Mar 23, 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.**
---
## Features
This sample illustrates the following concepts on top of the SharePoint Framework:
* Using AadTokenProvide to consume Yammer API.
* How to get User/Group information from Yammer.
* How to post a praise to Yammer.
* React Hooks
* Using async / await for the async calls
* Office UI fabric components
* Can be installed on Microsoft Teams as Personal app or a team tab
## Configuration
To get access to Yammer API, we need to add the required permission to “SharePoint Online Client Extensibility Web Application Principal” application:
* Navigate to Azure portal.
* Search for App Registration at top search box.
* Select “SharePoint Online Client Extensibility Web Application Principal“
* Select “API permissions” from left navigation.
* Click “Add a permission“.
* Select Yammer.
* Select “User_Impersonation” from delegated permissions.
* Click “Add permissions“.
* Click “Grant admin consent” button.
* Select “Yes, add other granted permissions to configured permissions“
* Click “Save and continue“.
* Click “Grant admin consent“.
* Select “Yes“.
Bundle and package the solution, deploy it to app catalog, then add the web part to any pages in SharePoint or add to your Teams.
2020-04-02 15:57:15 -04:00
Read my blog post for more information from [here](https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-yammer-api).
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-yammer-praise" />