Aplicación de formato al archivo CSV o JSON para migración de contenido de datosHow to format your JSON or CSV for data content migration

La herramienta de migración de SharePoint (SPMT) le permite cargar en masa la información de tareas de migración mediante un archivo JSON o CSV.The SharePoint Migration tool (SPMT) lets you bulk upload your migration task information using either a JSON file or a CSV file. Esto es especialmente útil si está creando un gran número de tareas.This is especially helpful if you are creating a large number of tasks.

Usar un archivo de valores separados por comas (CSV) para la migración de contenido de datosUsing a comma separated value (CSV) file for data content migration

La herramienta de Migración de SharePoint (SPMT) le permite usar un archivo separados por comas (CSV) para migrar los datos en masa. Use cualquier editor de texto o una aplicación como Excel para crear el archivo 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 del archivo CSVCSV file format

El archivo CSV necesita seis columnas: las tres primeras son los valores de origen y cada una proporciona detalles sobre dónde se almacenan actualmente los datos. Las otras tres columnas indican el sitio, la biblioteca de documentos y una subcarpeta opcional que indica adónde se migrarán los datos. Las seis columnas deben incluirse en el archivo, incluso aunque no necesite un valor para un campo concreto.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.

A continuación, se muestra un ejemplo del formato del archivo CSV.Here's an example of the format for the CSV file. En la primera fila, se muestran los archivos que están migrando de un recurso compartido de archivos locales a SharePoint.The first row show files that are being migrated from a local file share to SharePoint. En la segunda fila, se muestran los archivos que están migrando de un sitio de SharePoint Server local a SharePoint en Microsoft 365.The second row shows files that are being migrated from an on-premises SharePoint Server site to SharePoint in Microsoft 365. En la tercera fila se muestran los archivos que se están migrando de un recurso compartido de archivos local a OneDrive.The third row show files that are being migrated from a local file share to OneDrive.

Formato de ejemplo de la Herramienta de migración de SharePoint cuando se usa un archivo CSV

En este ejemplo se muestra el aspecto que tendría en un archivo .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

No incluya ninguna fila de encabezado en el archivo CSV. En el segundo ejemplo, se incluyen encabezados para indicar el orden de los campos. Recuerde que debe incluir las seis columnas en el archivo, aunque no necesite un valor para un campo determinado.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

Si utiliza la biblioteca de documentos estándar lista para usar (“Documentos compartidos”), deberá usar el nombre interno “Documentos” como valor del marcador de posición en la (columna B) de la Biblioteca de documentos de origen en el archivo CSV.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. Si escribe “Documentos compartidos” en esa columna, recibirá el error “biblioteca de documentos no válida”.If you enter "Shared Documents" in that column, you will receive an "invalid document library" error. Si el idioma del sitio de SharePoint de destino es distinto del inglés, consulte el nombre interno de la biblioteca de documentos "documentos compartidos" buscando en https://contoso.sharepoint.com/sites/SampleSite/_layouts/15/viewlsts.aspx?view=14.If the language of the destination SharePoint site is other than English, check the internal name of the "Shared Documents" Document library by browsing to https://contoso.sharepoint.com/sites/SampleSite/_layouts/15/viewlsts.aspx?view=14.

Importante

No se admiten las conexiones de proxy. El uso de conexiones de Proxy producirá errores tales como "SharePoint login fail" (Error de inicio de sesión de SharePoint) o "cannot load document library" (no se puede cargar la 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 crear un archivo CSV para la migración de datosTo create a CSV file for data migration

En el ejemplo siguiente se usa Excel para crear el archivo CSV.The following example uses Excel to create the CSV file.

  1. Inicie Excel.Start Excel.

  2. Escriba los valores para los trabajos de migración. Escriba un origen y destino de migración por fila. Vea la tabla de referencia siguiente para ver una explicación más precisa de las columnas.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.

  • Columna A: Escriba la ruta de acceso a un recurso compartido de archivos o la dirección URL de un sitio de SharePoint Server local.Column A: Enter either a file share path or an on-premises SharePoint Server site URL. En el caso de SharePoint Server 2013 y 2016, también puede usar el nombre de inicio de sesión o el SID en esta columna.For SharePoint Server 2013 and 2016, you can also use either the log in name or the SID in this column. Necesario.Required.

  • Columna B: Escriba el nombre de la biblioteca de documentos de SharePoint Server que está migrando. Si deja este campo en blanco, se migrarán todas las bibliotecas de documentos. Si va a migrar un recurso compartido de archivos, deje esta columna en blanco. 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.

  • Columna C: Escriba el nombre de la subcarpeta de la biblioteca de documentos. Si esta columna se deja en blanco, la migración se inicia desde la raíz. Si hay un valor en esta columna, las migraciones se inician desde la subcarpeta y continúan bajando niveles. 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.

  • Columna D: Escriba la URL del sitio de SharePoint al que se van a migrar los archivos. Necesario.Column D: Enter the SharePoint site URL where the files are to be migrated. Required.

  • Columna E: Escriba el nombre de la biblioteca de documentos del sitio de SharePoint a la que se van a migrar los archivos. Necesario.Column E: Enter the name of the document library in the SharePoint site where the files are to be migrated. Required.

  • Columna F: Escriba el nombre de la subcarpeta de la biblioteca de documentos. Si esta columna se deja en blanco, los archivos se moverán al nivel raíz. 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. Cierre y guárdelo como archivo (*.csv) delimitado por comas.Close and save as a Comma delimited (*.csv) file.

Definiciones de columnaColumn definitions

En la tabla siguiente se explican los valores necesarios en cada columna para el archivo CSV.The following table explain the values needed in each column in your CSV file.

OrigenSource
Necesario. Especifique una ruta de recurso compartido de archivos o una URL del sitio de SharePoint Server local. Required. Enter either a file share path or an on-premises SharePoint Server site URL.
Biblioteca de documentos de origenSource DocLib
Opcional. Escriba el nombre de la biblioteca de documentos de SharePoint Server que está migrando. Si deja este campo en blanco, se migrarán todas las bibliotecas de documentos. Si va a migrar un recurso compartido de archivos, deje esta columna en blanco. 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.
Subcarpeta de origenSource SubFolder
Opcional. Escriba el nombre de la subcarpeta de la biblioteca de documentos. Si esta columna se deja en blanco, la migración se inicia desde la raíz. Si hay un valor en esta columna, las migraciones se inician desde la subcarpeta y continúan bajando niveles. 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.
Esta columna solo se usa para los sitios de SharePoint Server. Se ignora en la migración de recurso compartido de archivos.This column is used only for SharePoint Server sites. It is ignored for file share migration.
Web de destinoTarget Web
Necesario. Escriba la URL del sitio de SharePoint al que se van a migrar los archivos. Required. Enter the SharePoint site URL where the files are to be migrated.
Biblioteca de documentos de destinoTarget DocLib
Necesario. Escriba el nombre de la biblioteca de documentos del sitio de SharePoint a la que se van a migrar los archivos. Required. Enter the name of the document library with the SharePoint site where the files are to be migrated.
Subcarpeta de destinoTarget SubFolder
Opcional. Escriba el nombre de la subcarpeta de la biblioteca de documentos. Si esta columna se deja vacía, los archivos se moverán al nivel raíz. 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.

Uso de un archivo JSON para la migración de contenido de datosUsing a JSON file for data content migration

El siguiente ejemplo muestra el formato de JSON al migrar los datos.The following example shows the JSON format used in migrating your data.

Como sucede con los archivos CSV, los valores mínimos necesarios son Origen, Biblioteca de documentos de origen, Web de destino y 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"
    }
  ]
}