https://github.com/zerg00s/sp-migration-dashboard
📊 SharePoint Migration Dashboard 🚀
https://github.com/zerg00s/sp-migration-dashboard
dashboard migration migration-dashboard sharepoint sharepoint-framework sharepoint-migration-assessment sharepoint-online smat spfx spfx-webpart
Last synced: 24 days ago
JSON representation
📊 SharePoint Migration Dashboard 🚀
- Host: GitHub
- URL: https://github.com/zerg00s/sp-migration-dashboard
- Owner: Zerg00s
- Created: 2020-07-09T03:10:37.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-17T20:12:12.000Z (5 months ago)
- Last Synced: 2025-03-29T05:51:16.112Z (about 1 month ago)
- Topics: dashboard, migration, migration-dashboard, sharepoint, sharepoint-framework, sharepoint-migration-assessment, sharepoint-online, smat, spfx, spfx-webpart
- Language: TypeScript
- Homepage:
- Size: 1.93 MB
- Stars: 21
- Watchers: 2
- Forks: 5
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://dev.azure.com/zergs/Migration%20Dashboard/_build/latest?definitionId=5&branchName=master)
# SharePoint Migration Dashboard
Planning to migrate your SharePoint server farm to SharePoint Online? Then you absolutely must install this dashboard.
## Reasons for Setting up the Migration Dashboard
- SharePoint migrations to Microsoft 365 can be a nightmare to plan and organize
- You want to keep track of your migration progress
- Dashboard is a self-service portal designed to provide SharePoint site owners with all migration-related questions
- Save time on reading [SharePoint Migration Assessment Tool (SMAT)](https://www.microsoft.com/en-us/download/details.aspx?id=53598&WT.mc_id=rss_alldownloads_all) reports. Migration Dashboard presents SMAT data in a human readable form that will be available both for the migration team and site owners.
## Watch a Demo
[](https://youtu.be/6FwCIA-aaPM)
## Deploy Migration Dashboard
### Prerequisites
- Microsoft 365 subscription
- SharePoint Online Administrator role (for creating the App Catalog)
- SharePoint Site Administrator (for deploying the package)
- [SharePoint App Catalog](https://docs.microsoft.com/en-us/sharepoint/use-app-catalog)
### Deployment Steps
1. Download and unzip the [latest release](https://github.com/Zerg00s/sp-migration-dashboard/releases)
1. Run `Install-Module SharePointPnPPowerShellOnline -Scope "CurrentUser" -AllowClobber -Force` to install the legacy PnP.PowerShell module.
1. In SharePoint Online:
* [Create App Catalog Site Collection](https://docs.microsoft.com/en-us/sharepoint/use-app-catalog#step-1-create-the-app-catalog-site-collection) if not already created
* Navigate to the SharePoint App catalog > **Apps for SharePoint** library
* Drag and drop `sp-migration-dashboard.sppkg` to the library
* Create an empty site collection for hosting Migration Dashboard.
* Add the "Migration Dashboard" app to this site collection.
* Add Migration Dashboard webpart to the home page.
1. Deploy Dashboard Lists and Libraries by running `Deploy-Dashboard.ps1`
### Upload Data to the Dashboard
1. Download [SharePoint Migration Assessment Tool (SMAT)](https://www.microsoft.com/en-us/download/details.aspx?id=53598&WT.mc_id=rss_alldownloads_all)
1. Run SMAT in one of the SharePoint servers in your farm.
1. Run `Upload_SMAT_Reports.ps1` to upload SMAT reports to the Dashboard site.
1. Enjoy the data provided by the Migration Dashboard!
## 💡 Known issue: Details View does not show fields ⚠️
If the "View Details" does not show any fields except for Title. Apply the following fix:
- Go to Site Contents
- Next to Sites Report click on the three dots (...) > Settings
- Under Content Type, click "Item" Content type
- Add from existing site or list columns
- Select all columns by pressing SHIFT and Left Mouse click
- Click Add
## Migration Dashboard Architecture
The Dashboard is a lightweight solution that includes the following components
- Communication SharePoint site.
- SharePoint Framework (SPFx) webpart.
- No heavy dependencies or external APIs.
- Your migration-related data will stay in your SharePoint Online tenant.
- Dashboard does not send any data to the outside world.
- Source code is available in this open source repository.
## Build the Package
You can always take the [latest release from here](https://github.com/Zerg00s/sp-migration-dashboard/releases/download/1.0/sp-migration-dashboard.Release.zip). But you can also build the package manually.
### Development Prerequisites
- Install [Node.js LTS 10.x](https://nodejs.org/dist/latest-v10.x/)
- Install gulp by running `npm install gulp -g`
### Build the Migration Dashboard Package
```cmd
npm install
gulp bundle --ship
gulp package-solution --ship
```
Navigate to the folder `\sp-migration-dashboard\sharepoint\solution\` and confirm that the .sppg file is there:
## Migration Dashboard in Action
