The Migration report allows you to see all the details of your migration. With the Migration report, you are able to customize the columns displayed, export the report, and view individual item details.
- Access your Migration report
- Understand your Migration report
- Understand warnings and errors
- Export your report
Access your Migration report
The Migration report populates in time with your migration. Once your Migration report begins populating, it can be accessed at any time through Tasks.
- Select Tasks from the sidebar.
- Click Add filter.
- Select Task type.
- Select the type of migration you are looking for (ex. Copy structure, Copy teams, Copy planner, etc.).
- Click Apply filter.
- Select the task.
When you select a Copy structure, Copy content, or Import task, you will be taken to the Migration report screen.
When you select a Copy teams or Copy planner task, you will be taken to the copy report screen. Click to view the Details screen (i.e. the Migration report).
Note: To find a Copy teams - Incremental migration report, follow steps (1) to (5) above to search for the initial team migration. Click the > arrow to expand the initial task, then select the Incremental copy task to open the details.
Understand your Migration report
Your migration report serves to give you a detailed view of which items migrated successfully, and which items had warnings or errors associated with them when attempting to migrate.
Understand warnings and errors
When running a large migration, it is normal to see many warnings and errors as your results load.
When you get an indication to Show item-level filter option to display the details, you need to click on Filter and check the Show Item-Level in the Options section to see details regarding errors or warnings on list items and documents. For more information, see Show item-level filter option to display the details.
A warning indicates that your item type was successfully migrated to the destination, but a modification needed to occur to get it there, or something needed to be left out. A common example is a list that migrates successfully without a source field because that field is not supported in the destination environment.
When warnings occur, it is generally because something is not supported between versions, and the best solution is to manually create a substitute in your destination environment.
An error indicates that the ShareGate migration tool was not able to migrate the item type to the destination. Errors can be complex, and always have associated error codes and articles to help you work through why the error occurred and indicate if there is a solution or workaround. You need to click the provided Help links (on the last column) to access the articles.
Export your report
You can export your results as an XLSX or CSV file. From Tasks, click the Export button and save the file to your preferred location. For a detailed walkthrough, see Export sessions.
Open your Migration report using your preferred spreadsheet software. Use the software's filtering capabilities to refine the data and investigate the Migration report in greater detail.
In Excel, for example, you can filter data in a range or table. Start by filtering the Status column to reveal only errors and/or warnings. Further filter the data to look for a specific site, list, or library. Use this information to make changes or improvements for future migrations.