SharePoint Online document libraries

You can copy the contents of document libraries from Microsoft SharePoint Online to personal Yandex Disks of Yandex 360 for Business users or shared disks of your company.

Terms and limitations

From how many libraries can I copy libraries at a time?

A single migration file can contain no more than 20,000 rows. For each employee, enter the drive username you're migrating data from and the shared or personal Yandex Disk username you're migrating data to. Usernames shouldn't repeat within the file.

If you need to copy several libraries to one Yandex Disk, perform multiple migrations. They need to be run sequentially: the copying of each subsequent library should only start after the previous library has been fully copied.

Where are the files copied to?

During migration, a separate folder is created on the user's Yandex Disk. The structure of subfolders and files is preserved.

Folder naming and pathing

Each document library has a unique URL. It contains:

• Tenant name (tenantname in the example below).

• Family of sites (sites in the example below).

• Site name (examplesite in the example below).

• Subsite name, if any (subsite in the example below).

• Name of the document library (Shared%20Documents in the example below).

These items form a hierarchy of subfolders on Yandex Disk. For example, if the path to the document library looks like https://tenantname.sharepoint.com/sites/examplesite/subsite/Shared%20Documents, then the subfolder structure on Yandex Disk will be as follows: http://disk.yandex.ru/client/disk/tenantname/sites/examplesite/subsite/Shared%20Documents.

If you use the document library in the root site (root), it will be copied to a folder that looks like this: http://disk.yandex.ru/client/disk/tenantname/root/root/Shared%20Documents.

File copying restrictions

For successful migration, the file name length in the library must not exceed 255 characters. Files that don't meet this condition won't be copied. Before migrating, check the contents of the SharePoint library for such files and rename them.

Start migration

1. Prepare a secret, link a domain, and prepare employee accounts if you haven't already done so.

   Note

   The secret applies to all running migrations. If you have already started migration and then upload a new secret, it will be applied to this migration. The secret permissions are also taken into account: if the new secret only has access to files and you have started email migration, it will stop.

2. Make sure that each Yandex 360 for Business user has enough space on Yandex Disk to store the files that will be migrated. You can check the available space on a user's Yandex Disk in the employee card.

3. In the company account, select General settings → Migration.

4. Select the migration option:

   • Files on personal disks, if you need to migrate files to personal Yandex Disks of Yandex 360 for Business users.

   • Files on shared disks, if you need to migrate files to the shared disks of the company.

5. Select where you want to migrate files from: click Microsoft 365.

6. Upload the secret key file and click Next.

7. Prepare a CSV file according to the instructions.

8. Click Start migration.

   Data collection takes from a few minutes to two hours, and then the files start appearing on Yandex Disk. If some of the files are already on Yandex Disk (for example, they were moved earlier), the dates when they were last changed in SharePoint Online and Yandex Disk are compared, and the older versions are replaced with the newer ones.

   After the copying is complete, the files are no longer synchronized. If new files appeared in the SharePoint library after the copying is completed and you want to migrate them to Yandex Disk, start a new migration.

Once migration is complete, make sure that the number of copied files is the same as the number of files in the source. If you plan to run the process multiple times, save the migration report before each new run. If errors occur during migration, you'll be able to track at which run they appeared.

Where can I view the migration report?

To download the report, go to the active migration page and click Details in the top-right corner. The report displays the logs of the last launched migration process. They contain detailed information about the number of files copied to the personal Yandex Disk and any errors that occurred during this process.

What happens if I stop migration?

All running migrations will be stopped. Any files already copied at the time of the stop will be saved.

What happens if you start a new migration

If you start a new migration before completing the previous one, the new migration will run in parallel with the already launched process for all personal Yandex Disks.

Troubleshooting

You can view a detailed description of migration errors in the migration report. For ways to fix these errors, see Migration error report.