sp-dev-fx-webparts/samples/react-team-creator/README.md

# React Teams Creator Web Part

## Summary

The web part illustrates usage of MS Graph beta APIs to work with Teams:
* O365 group creation
* Team creation
* Channel creation
* Installation of an app
* Adding tab
* Getting apps from App Catalog

![React Side Panel Client-Side Web Part](./assets/teams-creator.png)

## Used SharePoint Framework Version 
![drop](https://img.shields.io/badge/drop-1.7.0-green.svg)

## Applies to

* [SharePoint Framework](https:/dev.office.com/sharepoint)
* [MS Graph](https://developer.microsoft.com/en-us/graph)
* [MS Teams](https://docs.microsoft.com/en-us/microsoftteams/microsoft-teams)

## Solution

Solution|Author(s)
--------|---------
teams-creator-client-side-solution | Alex Terentiev ([Sharepointalist Inc.](http://www.sharepointalist.com), [AJIXuMuK](https://github.com/AJIXuMuK))

## Version history

Version|Date|Comments
-------|----|--------
1.0|October 17, 2018|Initial release
1.1|November 19, 2018|Upgrade to SPFx v1.7.0, updated to use v1.0 MS Graph endpoints

## 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
Sample features:
- O365 Group creation
- MS Team creation
- Channel creation
- Teams App installation
- Adding Teams tab
- Usage of PnP React Controls

## Caveats
- There is no way to filter Teams Apps requested from App Catalog by App Type. Because of that dropdown displays not only apps that are available as Tabs but all of them.
- Although the app can be added as a Tab there is no API to configure the app completely. At least, there is no way to figure out what settings are there for this or that specific app. So, after tab creation in the Teams app a user will see "Set up tab" button in the fresh tab.

## Building the code

```bash
git clone the repo
npm i
npm i -g gulp
gulp
```

This package produces the following:

* lib/* - intermediate-stage commonjs build artifacts
* dist/* - the bundled script, along with other resources
* deploy/* - all resources which should be uploaded to a CDN.

<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-team-creator" />
Example of MS Graph Teams beta API usage (#652) 2018-11-09 02:47:22 -05:00			`# React Teams Creator Web Part`

			`## Summary`

			`The web part illustrates usage of MS Graph beta APIs to work with Teams:`
			`* O365 group creation`
			`* Team creation`
			`* Channel creation`
			`* Installation of an app`
			`* Adding tab`
			`* Getting apps from App Catalog`

			`![React Side Panel Client-Side Web Part](./assets/teams-creator.png)`

			`## Used SharePoint Framework Version`
Upgrade to SPFx v1.7.0, update to use v1.0 MS Graph endpoints (#693) 2018-11-21 02:08:44 -05:00			`![drop](https://img.shields.io/badge/drop-1.7.0-green.svg)`
Example of MS Graph Teams beta API usage (#652) 2018-11-09 02:47:22 -05:00
			`## Applies to`

			`* [SharePoint Framework](https:/dev.office.com/sharepoint)`
			`* [MS Graph](https://developer.microsoft.com/en-us/graph)`
			`* [MS Teams](https://docs.microsoft.com/en-us/microsoftteams/microsoft-teams)`

			`## Solution`

			`Solution\|Author(s)`
			`--------\|---------`
			`teams-creator-client-side-solution \| Alex Terentiev ([Sharepointalist Inc.](http://www.sharepointalist.com), [AJIXuMuK](https://github.com/AJIXuMuK))`

			`## Version history`

			`Version\|Date\|Comments`
			`-------\|----\|--------`
			`1.0\|October 17, 2018\|Initial release`
Upgrade to SPFx v1.7.0, update to use v1.0 MS Graph endpoints (#693) 2018-11-21 02:08:44 -05:00			`1.1\|November 19, 2018\|Upgrade to SPFx v1.7.0, updated to use v1.0 MS Graph endpoints`
Example of MS Graph Teams beta API usage (#652) 2018-11-09 02:47:22 -05:00
			`## 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`
			`Sample features:`
			`- O365 Group creation`
			`- MS Team creation`
			`- Channel creation`
			`- Teams App installation`
			`- Adding Teams tab`
			`- Usage of PnP React Controls`

			`## Caveats`
			`- There is no way to filter Teams Apps requested from App Catalog by App Type. Because of that dropdown displays not only apps that are available as Tabs but all of them.`
			`- Although the app can be added as a Tab there is no API to configure the app completely. At least, there is no way to figure out what settings are there for this or that specific app. So, after tab creation in the Teams app a user will see "Set up tab" button in the fresh tab.`

			`## Building the code`

			```bash
			`git clone the repo`
			`npm i`
			`npm i -g gulp`
			`gulp`
			```

			`This package produces the following:`

			`* lib/* - intermediate-stage commonjs build artifacts`
			`* dist/* - the bundled script, along with other resources`
Adding missing telemetry images for readme files 2019-04-15 05:49:10 -04:00			`* deploy/* - all resources which should be uploaded to a CDN.`

			`<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-team-creator" />`