See things differently? This article reflect Sharegate Desktop version 7.0 or greater. Manually update to the latest version or download the legacy Migration manual on our version page.
If you need more information on Managed Metadata, you can see this page.
- Select the action you want to perform from the Migration menu. If you are returning to a Recent Connection to run an Import and Copy, skip to step 11.
- Connect to the desired Source Environment by clicking Connect Source.
- Select the structure you want to copy.
- Click Next.
- Connect to the desired Destination Environment by clicking Connect Destination.
- Select Export Metadata from the source list to export your data.
- You can create or select a template for the export, or keep the default template, which will copy all the values from the source while preserving version history, authors and timestamps. The mappings and the available templates are the same as the ones used for the copy.
- Click Export. You can save the file format as .xlsx or .csv. See a note on this below.
- Click Open the file to access it and apply your changes as needed.
- Save and close the file.
- Back on the app, click Import and Edit. If you closed the app or are not ready to make the changes, just access the session again from Recent Connections.
- If you used Import and Edit in step 10, skip this step. Select Import & Copy to import your data onto the destination.
- You can create or select a template for the import, or keep the default template, which will copy all the values from the source while preserving version history, authors and timestamps. Please see below for a note on mappings.
- Once the action is completed, the migration report will show any successes, warning, or errors. See Migration Report for more details.
Please note the following when using Export Metadata.
- You can choose the location where you want to save the Excel file.
- You can select a Excel or a CSV file format. If you have unexpected behaviours when opening the CSV with Excel, please see CSV Support.
Please note the following when using Import and Copy.
- Make sure that the selected source and destination lists and libraries are the same as the ones you used when exporting the Excel file.
- If you modified the column names in the Excel file or added some new columns, you will have to map those properties.
- If you modified the values in the Content Type column in the Excel file, you might have to map those content types.
It is possible to import multiple versions of a file from the file system to SharePoint.
As Windows doesn't allow two files with the same name in the same folder, you'll have to follow the Sharegate naming convention to import these files correctly as different versions of the same file in SharePoint. The naming convention is as follows:
For example, the version 1.0 of the file "SomeFileName.txt" should be saved as "SomeFileName0.1.txt". The version numbering can be done to your preference.
In the excel file, the SourcePath column should contain the complete path to the file, without the version number. The version column contains the version number to look for on the file system. During the import, Sharegate will look for the file using the convention above with the version number (it will look for "SomeFileName0.1.txt" when looking for version 1.0 of the file "SomeFileName.txt"). If the file cannot be found this way, Sharegate will try to find the file directly without the version number ("SomeFileName.txt").
The Excel file created by the export contains all the editable columns that the destination list or library contains. It also contains an identifier column, which is the DestinationPath in the case of documents or the ID in the case of list items (the DestinationPath also appears for list items), as well as a SourcePath column which indicates the location of the source document. If the option to preserve the version history was selected, the file will contain a Version column. Finally, if the option to preserve authors and timestamps was selected, the file will contain the columns Author, Created, Editor and Modified.
The SourcePath, ID and Version columns should not be modified, as these are used to identify the items when importing. They must match what exists in the source list or library so that information such as permissions, attachments or file content can be pulled from the source. You cannot add new items or files that do not exist in your source list or library.
The DestinationPath column will be filled during the export with the path that the document would have in the target library if you had simply copied the file and folder structure as-is. However, you can modify it to change the folder structure or rename files during the migration. The file paths entered in this column must always be relative to the library. For example, if there is a library at http://mySite/myLibrary and you want MyFile.docx to be uploaded in a folder called MyFolder, you would need to enter "MyFolder/MyFile.docx" and not "http://mySite/myLibrary/MyFolder/MyFile.docx".
Note: You cannot rename a file with Excel if you are using bulk edit.
All the other values can be modified. If you have some columns that can contain multiple values, you can separate those values with semi-colons (';'). If you modify the values in the ContentType column, please note that you must either have a matching content type in your destination library or set a mapping when you will import the Excel file back.
The column names "SourcePath", "DestinationPath", "ID", "Version", "ContentType", "Author", "Created", "Editor", "Modified", "ApprovalStatus", "ApprovalComments" and "CheckinComments" should not be modified as these represent system columns that are used for special purposes. All the other column names can be modified and you can also add new columns, but they will have to be mapped later when importing in order to be used while copying to the destination.
When you are modifying a cell value you can use formulas to quickly populate a column with useful metadata. In order to make this task easier for you, Sharegate will extract some values from the path and the file name. These values are located after all the other columns and don’t have any header.
They represent (in order):
Parent folder name
All folders in the file path (one folder per column)
Here is an example on how to use this metadata: