This web part provides you the ability to add a particular user's personal tasks on a web page. The web part may be configured to show tasks from Planner or To Do. This web part is powered by the Microsoft Graph.
This webpart is a technology demostrator of Microsoft Graph Toolkit React components, in particular "Tasks". This webpart uses the @microsoft/mgt-react and @microsoft/mgt-spfx packages, currently version 2.2.1.
NOTE:This webpart includes the use the Microsoft Graph Toolkit with React, @microsoft/mgt-react.
NOTE:This webpart includes the use the Microsoft Graph Toolkit with React SPFx, @microsoft/mgt-spfx with a dependency on mgt-spfx-2.2.1.sppkg that must be installed to the tenant app catalog. By default the Starter Kit will install this additional dependency.
- Place the page you want to add this web part to in edit mode.
- Search for and insert the Personal Tasks web part.
- Configure the web part to update its properties.
The Personal Tasks web part can be configured with the following properties:
| Label | Property | Type | Required | Description |
|---|---|---|---|---|
| My Tasks | title | string | no | The web part title, editable inline with the web part itself |
| Data source | dataSource | 'planner' | 'todo' | yes | Web part's data source: Planner or To Do. Default: planner |
| Allow editing | allowEditing | boolean | no | Flag if editing is allowed. Default is false. |
| Hide filter | hideHeader | boolean | no | Flag if the header on MS Graph Toolkit Personal Tasks component should be hidden. The header contains a filter and "Add" button. Default is true. |
| Initially displayed Plan or ToDo Folder id | initialId | string | no | A string id to set the initially displayed planner or folder to the provided ID. |
| Initially displayed bucket id | initialBucketId | string | no | A string id to set the initially displayed bucket (Planner Data-Source Only) to the provided ID. |
| Source Plan or ToDo Folder id | targetId | string | no | A string id to lock the tasks interface to the provided planner or folder ID. |
| Source bucket id | targetBucketId | string | no | A string ID to lock the tasks interface to the provided bucket ID (Planner Data-Source Only). |
- When "hide filter" is selected, the filter header will be hidden from view (default setting). With the filter hidden, you remove the ability for a visitor to filter task results by all tasks or tasks for the current user. By default, if a planner id is not specified, a visitor will see only their tasks. If a specific planner id is set in the webpart properties, all tasks within that planner are displayed. To allow for filtering in this scenario, you will want to sure that the filter is not hidden (unchecked).
- Only supported in SharePoint Online due to dependency on the Microsoft Graph APIs
- mgt-spfx-2.2.1.sppkg must be installed to the tenant app catalog. By default the Starter Kit will install this additional dependency.
| Solution | Author(s) |
|---|---|
| react-personal-tasks | Waldek Mastykarz |
| react-personal-tasks | Alex Terentiev |
| react-personal-tasks | Eric Overfield |
| Version | Date | Comments |
|---|---|---|
| 1.0 | December 25, 2019 | Initial release |
| 2.2 | August 2021 | Upgrade to MGT 2.2.1 |
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.
- Clone this repository
- Move to solution folder
- in the command line run:
npm installgulp bundlegulp package-solution- Upload solution to the SharePoint App Catalog
- Approve needed permissions in SharePoint Admin Center
gulp serve
Description of the web part with possible additional details than in short summary. This Web Part illustrates the following concepts on top of the SharePoint Framework:
- Using Microsoft Graph Toolkit from the web parts
- Hosting SharePoint Framework components as Microsoft Teams tabs
- Using app pages in SharePoint Online