sp-migration-dashboard

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

sp-migration-dashboard

★ 23 Open GitHub ↗

📊 SharePoint Migration Dashboard 🚀

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg) 
![Node.js LTS 10.x](https://img.shields.io/badge/Node.js-LTS%2010.x-green.svg) 
![SharePoint Online](https://img.shields.io/badge/SharePoint-Online-yellow.svg) 
![Teams N/A: Untested with Microsoft Teams](https://img.shields.io/badge/Teams-N%2FA-lightgrey.svg "Untested with Microsoft Teams") 
[![Build Status](https://dev.azure.com/zergs/Migration%20Dashboard/_apis/build/status/Build.sp-migration-dashboard?branchName=master)](https://dev.azure.com/zergs/Migration%20Dashboard/_build/latest?definitionId=5&branchName=master)
![search](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/search.png)

# 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.

![](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/siteInfo.png)

## Watch a Demo

[![video](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/video.png)](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  
![](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/drag-and-drop.png)
   * Create an empty site collection for hosting Migration Dashboard.
   * Add the "Migration Dashboard" app to this site collection.
   ![](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/add-app.png)
   * Add Migration Dashboard webpart to the home page.
   ![](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/webpart.png)

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:

![package](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/package.png)

## Migration Dashboard in Action

![tabs](https://raw.githubusercontent.com/Zerg00s/sp-migration-dashboard/master/IMG/tabs.gif)

sp-migration-dashboard

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README