77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
|
# React Birthdays Web Part
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
The Web Part Birthdays shows the upcoming birthdays in the company, the web part reads birthdays from a list located on the tenant's home site with title "Birthdays."
|
||
|
|
|
||
|
|
|
||
|
|
There is an Azure function available that get AAD user birthdays, this function creates a list on the tenant root site, if it does not exist.
|
||
|
|
See the local.settings.json for details on the required application variable located in SyncUsersBirthdaysFunction folder.
|
||
|
|
|
||
|
|
But you can synchronize the Birthdays list with other applications HR Systems, or other sources
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Used SharePoint Framework Version
|
||
|
|
|
||
|
|
|
||
|
|
## Applies to
|
||
|
|
|
||
|
|
* [SharePoint Framework](https:/dev.office.com/sharepoint)
|
||
|
|
* [Office 365 tenant](https://dev.office.com/sharepoint/docs/spfx/set-up-your-development-environment)
|
||
|
|
|
||
|
|
> Update accordingly as needed.
|
||
|
|
|
||
|
|
## Prerequisites
|
||
|
|
|
||
|
|
Existing list in tenant root site, with the Title "Birthdays" and columns:
|
||
|
|
|
||
|
|
Column Internal Name|Type|Required| comments
|
||
|
|
--------------------|----|--------|----------
|
||
|
|
jobTitle| Text| no|
|
||
|
|
Birthday| DateTime | true|
|
||
|
|
userAADGUID| Text| no | required if used Azure Function to get Birthdays from AAD
|
||
|
|
Title| Text| true
|
||
|
|
|
||
|
|
## Solution
|
||
|
|
|
||
|
|
Solution|Author(s)
|
||
|
|
--------|---------
|
||
|
|
react Birthday Web Part|João Mendes
|
||
|
|
|
||
|
|
## Version history
|
||
|
|
|
||
|
|
Version|Date|Comments
|
||
|
|
-------|----|--------
|
||
|
|
1.0.0|November 6, 2018|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:
|
||
|
|
- `npm install`
|
||
|
|
- `gulp build`
|
||
|
|
- `gulp bundle --ship`
|
||
|
|
- `gulp package-solution --ship`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Features
|
||
|
|
This project contains sample Birthday web parts built on the SharePoint Framework using React
|
||
|
|
and an Azure Function to get user Birthdays from AAD.
|
||
|
|
This sample illustrates the following concepts on top of the SharePoint Framework:
|
||
|
|
- using React for building SharePoint Framework client-side web parts
|
||
|
|
- using React components for building Birthday web part
|
||
|
|
- using MSGraph API to get data from SharePoint Lists
|
||
|
|
- using MSGraph API to read users from AAD
|
||
|
|
- using @PnP/PnPjs to create a List, add, update, delete Items.
|
||
|
|
|
||
|
|
|
||
|
|
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/readme-template" />
|