Форматирование JSON или CSV для переноса данныхHow to format your JSON or CSV for data content migration

Средство миграции SharePoint (SPMT) позволяет массово загружать информацию о задачах миграции, используя файл JSON или CSV.The SharePoint Migration tool (SPMT) lets you bulk upload your migration task information by using a JSON or CSV file. Этот способ удобен при создании большого количества задач.This method helps if you're creating a large number of tasks.

Перенос данных с помощью файла CSVUse a CSV file for data content migration

Для массового переноса данных с помощью SPMT можно использовать файл данных с разделителями-запятыми (CSV).SPMT lets you use a comma-separated value (CSV) file to bulk migrate your data. Для создания CSV-файла можно использовать любой текстовый редактор или такое приложение, как Excel.Use any text editor, or an application like Excel, to create the CSV file.

Формат CSVCSV file format

В CSV-файле должно быть шесть столбцов.You CSV column needs six columns. Первые три — это исходные значения, содержащие сведения о текущем расположении ваших данных.The first three are source values that provide detail about where your data is currently located. В оставшихся трех столбцах укажите сайт, библиотеку документов и вложенную папку (необязательное значение), куда переносятся данные.The remaining three columns indicate the site, document library, and optional subfolder where you are migrating your data to. В файле следует задать все шесть столбцов, даже если для определенного поля данные не нужны.All six columns must be accounted for in the file, even if you don't need a value for a given field.

Ниже приведен пример формата CSV-файла.Here's an example of the CSV file format. В первой строке указаны файлы, которые переносятся из локальной общей папки в SharePoint.The first row show files that are being migrated from a local file share to SharePoint. Во второй строке указаны файлы, которые переносятся из локального сайта SharePoint Server в SharePoint в Microsoft 365.The second row shows files that are being migrated from an on-premises SharePoint Server site to SharePoint in Microsoft 365. В третьей строке указаны файлы, которые переносятся из локальной общей папки в OneDrive.The third row show files that are being migrated from a local file share to OneDrive.

Табличное представление примера формата CSV-файла для средства миграции SharePoint.

В следующем примере показано, как указанные выше данные отображаются в TXT-файле.The following example shows how it would appear in a .txt file.

Source,SourceDocLib,SourceSubFolder,TargetWeb,TargetDocLib,TargetSubFolder
C:\MigrationTests\testfiles,,,https://contoso.sharepoint.com/sites/Sample/,DocLibraryName,DocLibraryName_subfolder
https://sharepoint2013.com/sites/contosoteamsite/,DocumentLibraryName,DocLibrarySubfolder_name,https://contoso.sharepoint.com/sites/Sample/,DocLibraryName,DocLibraryName_subfolder
\\sharedfolder\homedrives\meganb,,,https://contoso-my.sharepoint.com/personal/meganb_contoso_com/,DocLibraryName,DocLibraryName_subfolder

Важно!

Не включайте строку заголовков в CSV-файл.Do not include a header row in your CSV file. Во втором примере заголовки указаны, только чтобы показать порядок полей.The second example included headers to demonstrate the order of the fields. Помните, что в файле следует задать все шесть столбцов, даже если для определенного поля данные не нужны.Remember to account for all six columns in the file, even if you don't need a value for a given field.

Важно!

При использовании стандартной готовой для использования библиотеки документов (Общие документы), задайте внутреннее имя "Документы" в качестве значения заполнителя для Библиотеки исходных документов (столбец B) в CVS-файле.If you use the standard out-of-the-box Document library ("Shared Documents"), you must use the internal name "Documents" as the placeholder value for the Source Document Library (Column B) in your CSV file. Если вы введете в этом столбце значение "Общие документы", произойдет ошибка "недопустимое расположение библиотеки документов".If you enter "Shared Documents" in that column, you'll get an "invalid document library" error.

Если язык конечного сайта SharePoint отличается от английского, проверьте внутреннее имя библиотеки документов "Общие документы" в разделе https://contoso.sharepoint.com/sites/SampleSite/_layouts/15/viewlsts.aspx?view=14.If the language of the destination SharePoint site isn't English, check the internal name of the "Shared Documents" Document library at https://contoso.sharepoint.com/sites/SampleSite/_layouts/15/viewlsts.aspx?view=14.

Важно!

Прокси-подключения не поддерживаются. При использовании прокси-подключений возникают такие ошибки, как "Ошибка входа в SharePoint" и "Не удалось загрузить библиотеку документов".Proxy connections are not supported. Using Proxy connections will yield errors such as "SharePoint login fail" or "cannot load document library".

Создание CSV-файла для переноса данныхTo create a CSV file for data migration

В примере ниже для создания CSV-файла используется приложение Microsoft Excel.The following example uses Microsoft Excel to create the CSV file.

  1. Запустите Excel.Start Excel.

  2. Введите значения для заданий миграции.Enter the values for your migration jobs. В каждой строке введите источник и назначение миграции.Enter one migration source and destination per row. Подробное описание столбцов см. в следующей справочной таблице.See the following reference table for further explanation of columns.

  • Столбец A. Введите путь к общей папке или локальный URL-адрес сайта SharePoint Server.Column A: Enter a file share path or an on-premises SharePoint Server site URL. Для SharePoint Server 2013 и 2016 вы также можете использовать имя входа или SID в этом столбце.For SharePoint Server 2013 and 2016, you can also use the log in name or the SID in this column. Обязательное поле.Required.

  • Столбец B. Введите имя библиотеки документов SharePoint Server, которую нужно перенести.Column B: Enter name of the SharePoint Server document library that you're migrating. Если оставить это поле пустым, будут перенесены все библиотеки документов.If you leave this field empty, all document libraries will be migrated. Если вы переносите файловый ресурс, оставьте этот столбец пустым.If you're migrating a file share, leave this column empty. Необязательное поле.Optional.

  • Столбец C. Введите имя вложенной папки в библиотеке документов.Column C: Enter the name of the subfolder in the document library. Если этот столбец пустой, миграция начинается с корневой папки.If this column is empty, the migration starts from the root. Если в этом столбце есть значение, миграция выполняется из этой вложенной папки.If there's a value in this column, the migration starts from that subfolder. Необязательное поле.Optional.

  • Столбец D. Введите URL-адрес сайта SharePoint, на который вы хотите перенести файлы. Обязательное поле.Column D: Enter the SharePoint site URL where the files are to be migrated. Required.

  • Столбец E. Введите имя библиотеки документов на сайте SharePoint, в которую вы хотите перенести файлы. Обязательное поле.Column E: Enter the name of the document library in the SharePoint site where the files are to be migrated. Required.

  • Столбец F. Введите имя вложенной папки в библиотеке документов.Column F: Enter the name of the subfolder in the document library. Если этот столбец пустой, файлы переносятся в корневую папку. If this column is left empty, the files will be moved to the root level. Необязательное поле.Optional.

  1. Закройте и сохраните документ как CSV-файл.Close and save as a CSV file.

Определения столбцовColumn definitions

В следующей таблице описаны значения столбцов CSV-файла.The following table describes the values in each column of the CSV file.

ИсточникSource Обязательное поле.Required. Введите путь к общей папке или локальный URL-адрес сайта SharePoint Server.Enter a file share path or an on-premises SharePoint Server site URL.
Исходная библиотека документовSource DocLib Необязательное поле.Optional. Введите имя библиотеки документов SharePoint Server, которую нужно перенести.Enter name of the SharePoint Server document library that you're migrating. Если оставить это поле пустым, будут перенесены все библиотеки документов.If you leave this field empty, all document libraries will be migrated. Если вы переносите файловый ресурс, оставьте этот столбец пустым.If you're migrating a file share, leave this column empty.
Исходная вложенная папкаSource SubFolder Необязательное поле.Optional. Введите имя вложенной папки в библиотеке документов.Enter the name of the subfolder in the document library. Если этот столбец пустой, миграция начинается с корневой папки.If this column is left empty, the migration starts from the root. Если в этом столбце есть значение, миграция выполняется из вложенной папки.If there's a value in this column, the migrations starts from the subfolder. Этот столбец используется только для сайтов SharePoint Server.This column is used only for SharePoint Server sites. Он игнорируется в случае переноса файлового ресурса.It's ignored for file share migration.
Целевой сайтTarget Web Обязательное поле.Required. Введите URL-адрес сайта SharePoint, на который нужно перенести файлы.Enter the SharePoint site URL where the files are to be migrated to.
Целевая библиотека документовTarget DocLib Обязательное поле.Required. Введите имя библиотеки документов на сайте SharePoint, в которую требуется перенести файлы.Enter the name of the document library with the SharePoint site where the files are to be migrated to.
Целевая вложенная папкаTarget SubFolder Необязательное поле.Optional. Введите имя вложенной папки в библиотеке документов.Enter the name of the subfolder in the document library. Если этот столбец пустой, файлы переносятся в корневую папку. If this column is left empty, the files will be moved to the root level.

Перенос данных с помощью файла JSONUse a JSON file for data content migration

В приведенном ниже примере показан формат JSON, используемый при переносе данных.The following example shows the JSON format used to migrate your data.

Как и в CSV-файлах, обязательными являются поля Источник, Исходная библиотека документов, Целевой сайт и Целевая библиотека документов.As with the CSV files, the minimum required values are Source, Source DocLib, Target Web, and Target DocLib.

{
  "Tasks": [
    {
      "SourcePath": "D:\\MigTest",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "TargetList": "Documents",
      "TargetListRelativePath": "subfolder"
    },
    {
      "SourcePath": "http://EXHB-1873",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "Items": {
        "Lists": [
          {
            "SourceList": "versionList",
            "TargetList": "NewVersionList"
          }
        ],
        "SubSites": []
      }
    },
    {
      "SourcePath": "http://EXHB-1873",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "Items": {
        "Lists": [
          {
            "SourceList": "listVersion2",
            "TargetList": "ListVersion2"
          },
          {
            "SourceList": "listVersion3",
            "TargetList": "ListVersion3"
          }
        ],
        "SubSites": [
          {
            "SourceSubSitePath": "subSite",
            "TargetSubSitePath": "targetSubSite",
            "Lists": [
              {
                "SourceList": "testSubListB",
                "TargetList": "TargetSubList"
              }
            ]
          }
        ]
      }
    },
    {
      "SourcePath": "http://EXHB-1873/subsite2",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com/targetSubSite2"
    }
  ]
}