Como formatar o JSON ou CSV para migração de conteúdo de dadosHow to format your JSON or CSV for data content migration

Usar um arquivo de valores separados por vírgula (CSV) para a migração de conteúdo de dadosUsing a comma separated value (CSV) file for data content migration

A ferramenta de migração do SharePoint (SPMT) permite usar um arquivo de valores separados por vírgula (CSV) para migrar seus dados em massa. Use qualquer editor de texto ou um aplicativo como o Excel para criar o arquivo CSV.The SharePoint Migration tool (SPMT) lets you use a comma separated (CSV) file to bulk migrate your data. Use any text editor, or an application like Excel, to create the CSV file.

formato de arquivo CSVCSV file format

Há seis colunas necessárias no seu arquivo CSV: as primeiras três são os valores fonte, cada um fornecendo detalhes sobre onde seus dados estão localizados atualmente. As três colunas restantes indicam o site, biblioteca de documentos e subpasta opcional do local para onde você está migrando seus dados. Todas as seis colunas devem ser consideradas no arquivo, mesmo que você não precise de um valor para um determinado campo.There are six columns needed in your CSV file -- the first three are your source values, each providing detail about where your data is currently located. The remaining three columns indicate the site, document library and optional subfolder to where you are migrating your data. All six columns must be accounted for in the file, even if you are not needing a value for a given field.

Veja a seguir um exemplo do formato do arquivo CSV.Here's an example of the format for the CSV file. A primeira linha mostra os arquivos que estão sendo migrados a partir de um compartilhamento de arquivo local para o Microsoft Office SharePoint Online.The first row show files that are being migrated from a local file share to SharePoint. A segunda linha mostra os arquivos que estão sendo migrados de um site local do SharePoint Server para o SharePoint no Microsoft 365.The second row shows files that are being migrated from an on-premises SharePoint Server site to SharePoint in Microsoft 365. A terceira linha mostra os arquivos que estão sendo migrados de um compartilhamento de arquivos local para o OneDrive.The third row show files that are being migrated from a local file share to OneDrive.

Ferramenta de Migração do SharePoint, exemplo de formato ao usar um arquivo CSV

Este exemplo mostra como seria exibido em um arquivo .txt.This 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

Importante

Não inclua uma linha de cabeçalho em seu arquivo CSV. O segundo exemplo incluiu cabeçalhos para demonstrar a ordem dos campos. Lembre-se de levar em conta todas as seis colunas do arquivo, mesmo que você não precise de um valor para um determinado campo.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 are not needing a value for a given field.

Importante

Se você utilizar a biblioteca padrão de Documentos prontos para uso ("Documentos compartilhados"), deverá usar o nome interno "Documentos" como o valor do espaço reservado para a Biblioteca de Documentos de Origem (Coluna B) no seu arquivo CSV. Se você digitar "Documentos compartilhados" nessa coluna, receberá a mensagem de erro: "biblioteca de documentos inválidos".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 will receive an "invalid document library" error.

Importante

Não há suporte para conexões de proxy. Usar conexões de Proxy resultará em erros como "Falha de logon do SharePoint" ou "Não é possível carregar a biblioteca de documentos".Proxy connections are not supported. Using Proxy connections will yield errors such as "SharePoint login fail" or "cannot load document library".

Para criar um arquivo CSV de migração de dadosTo create a CSV file for data migration

O exemplo a seguir usa o Excel para criar o arquivo CSV.The following example uses Excel to create the CSV file.

  1. Inicie o Excel.Start Excel.

  2. Insira os valores dos seus trabalhos de migração. Insira uma fonte de migração e destino por linha. Confira a tabela de referência abaixo para obter mais explicações sobre colunas.Enter the values for your migration jobs. Enter one migration source and destination per row. See the reference table below for further explanation of columns.

  • Coluna A: Insira um caminho de compartilhamento de arquivo ou uma URL de site local do SharePoint Server.Column A: Enter either a file share path or an on-premises SharePoint Server site URL. Para o SharePoint Server 2013 e o 2016, você também pode usar o nome de logon ou o SID nesta coluna.For SharePoint Server 2013 and 2016, you can also use either the log in name or the SID in this column. Obrigatório.Required.

  • Coluna B: Digite o nome da biblioteca de documentos do Servidor Microsoft Office SharePoint Online que você está migrando. Se você deixar esse campo vazio, todas as bibliotecas de documentos serão migradas. Se você estiver migrando um compartilhamento de arquivos, deixe esta coluna em branco. Opcional.Column B: Enter name of the SharePoint Server document library you are migrating. If you leave this field empty, all document libraries will be migrated. If you are migrating a file share, leave this column empty. Optional.

  • Coluna C: Digite o nome da subpasta na biblioteca de documentos. Se essa coluna for deixada em branco, a migração será iniciada a partir da raiz. Se houver um valor nesta coluna, as migrações serão iniciadas a partir da subpasta e para baixo. Opcional.Column C: Enter the name of the subfolder in the document library. If this column is left empty, the migration starts from the root. If there is a value in this column, the migrations starts from the subfolder and down. Optional.

  • Coluna D: Digite o URL do site do Microsoft Office SharePoint Online para onde os arquivos serão migrados. Obrigatório.Column D: Enter the SharePoint site URL where the files are to be migrated. Required.

  • Coluna E: Digite o nome da biblioteca de documentos no site do Microsoft Office SharePoint Online para onde os arquivos serão migrados. Obrigatório.Column E: Enter the name of the document library in the SharePoint site where the files are to be migrated. Required.

  • Coluna F: Digite o nome da subpasta na biblioteca de documentos. Se essa coluna for deixada vazia, os arquivos serão movidos para o nível raiz. Opcional.Column F: Enter the name of the subfolder in the document library. If this column is left empty then the files will be moved to the root level. Optional.

  1. Feche e salve como um arquivo delimitado por vírgulas (*.csv).Close and save as a Comma delimited (*.csv) file.

Definições de colunasColumn definitions

A tabela a seguir explica os valores necessários em cada coluna no seu arquivo CSV.The following table explain the values needed in each column in your CSV file.

OrigemSource
Obrigatório. Insira um caminho de compartilhamento de arquivo ou uma URL do site do SharePoint Server local. Required. Enter either a file share path or an on-premises SharePoint Server site URL.
DocLib de origemSource DocLib
Opcional. Insira o nome da biblioteca de documentos do SharePoint Server que você está migrando. Se você deixar esse campo vazio, todas as bibliotecas de documentos serão migradas. Se você estiver migrando um compartilhamento de arquivo, deixe esta coluna vazia. Optional. Enter name of the SharePoint Server document library you are migrating. If you leave this field empty, all document libraries will be migrated. If you are migrating a file share, leave this column empty.
Subpasta da origemSource SubFolder
Opcional. Digite o nome da subpasta na biblioteca de documentos. Se essa coluna for deixada em branco, a migração será iniciada a partir da raiz. Se houver um valor nesta coluna, as migrações serão iniciadas a partir da subpasta e descendo. 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 is a value in this column, the migrations starts from the subfolder and down.
Essa coluna é usada apenas para sites do SharePoint Server. Ela será ignorada para migração de compartilhamento de arquivo. This column is used only for SharePoint Server sites. It is ignored for file share migration.
Web de DestinoTarget Web
Obrigatório. Digite o URL do site no Microsoft Office SharePoint Online para onde os arquivos serão migrados. Required. Enter the SharePoint site URL where the files are to be migrated.
DocLib de DestinoTarget DocLib
Obrigatório. Digite o nome da biblioteca de documentos do site no Microsoft Office SharePoint Online para onde os arquivos devem ser migrados. Required. Enter the name of the document library with the SharePoint site where the files are to be migrated.
Subpasta de destinoTarget SubFolder
Opcional. Digite o nome da subpasta na biblioteca de documentos. Se essa coluna for deixada vazia, os arquivos serão movidos para o nível raiz. Optional. Enter the name of the subfolder in the document library. If this column is left empty then the files will be moved to the root level.

Usar um arquivo JSON para migração de conteúdo de dadosUsing a JSON file for data content migration

O exemplo a seguir mostra o formato JSON usado na migração dos dados.The following example shows the JSON format used in migrating your data.

Assim como ocorre com os arquivos CSV, os valores mínimos necessários são Origem, Biblioteca de Documentos de Origem, Web de Destino e Biblioteca de Documentos de Destino.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"
    }
  ]
}