Exportar un inventario de archivos de biblioteca a CSV: lista de verificación práctica para propietarios de SharePoint

Como propietario de un sitio de SharePoint, es posible que necesite una lista completa de los archivos de una biblioteca de documentos para auditorías, planificación de migraciones o informes de almacenamiento. Copiar manualmente los nombres de archivo y los metadatos es lento y propenso a errores. SharePoint ofrece varios métodos integrados para exportar los datos de una biblioteca a un archivo CSV sin herramientas de terceros. Este artículo explica cada método, describe qué datos se pueden capturar y enumera los errores comunes que se deben evitar.

Qué se puede exportar desde una biblioteca de documentos de SharePoint

Una biblioteca de documentos de SharePoint almacena archivos y columnas de metadatos como Creado por, Fecha de modificación, Tamaño de archivo y columnas personalizadas como Tipo de documento o Nombre del proyecto. Al exportar la biblioteca a CSV, puede capturar todas las columnas visibles en la vista actual. El proceso de exportación crea un archivo .csv que se abre en Excel o en cualquier aplicación de hoja de cálculo. No se pueden exportar los contenidos de los archivos ni el historial de versiones directamente a CSV, solo las filas de metadatos. Si necesita el historial de versiones, use el informe Historial de versiones integrado o un script de PowerShell.

Antes de comenzar, confirme que tiene al menos permisos de Edición o Colaboración en la biblioteca. Los miembros del sitio con acceso de Lectura pueden ver los archivos, pero no pueden exportar los datos de la lista de la biblioteca. Si la biblioteca contiene más de 5000 elementos, la exportación estándar puede agotar el tiempo de espera. Use el método de PowerShell para bibliotecas grandes.

Método 1: Exportar a Excel desde la cinta de opciones de la biblioteca

Esta es la forma más rápida de exportar un inventario de biblioteca. Funciona para bibliotecas con menos de 5000 elementos y exporta todas las columnas visibles en la vista actual.

1. Abrir la biblioteca de documentos
   Vaya al sitio de SharePoint y abra la biblioteca de documentos que desea exportar.
2. Haga clic en Exportar a Excel
   En la barra de herramientas de la biblioteca, seleccione Exportar y luego Exportar a Excel. Si la opción no aparece, es posible que el navegador esté bloqueando las ventanas emergentes; permita las ventanas emergentes para el dominio de SharePoint.
3. Confirmar la consulta de exportación
   Un cuadro de diálogo pregunta si desea exportar la vista actual. Haga clic en Abrir o Guardar. El archivo se descarga como un archivo .iqy, que Excel abre como una tabla vinculada.
4. Guardar como CSV
   En Excel, vaya a Archivo > Guardar como, elija CSV UTF-8 (delimitado por comas) y asigne un nombre al archivo. El CSV ahora contiene todas las filas y columnas de la vista de la biblioteca.

Método 2: Crear una vista personalizada y exportarla

Use este método cuando necesite solo archivos o columnas específicos. Cree una vista que filtre u ordene la biblioteca y luego exporte esa vista a CSV.

1. Crear una nueva vista
   En la biblioteca, haga clic en Todos los elementos (o el nombre de la vista actual) y seleccione Crear nueva vista. Elija un tipo de vista como Vista estándar.
2. Establecer filtros y columnas
   Asigne un nombre a la vista. En Columnas, seleccione solo las columnas que necesita. En Filtrar, agregue condiciones como Tipo de archivo es igual a pdf o Modificado es mayor que 1/1/2024. Haga clic en Aceptar.
3. Exportar la nueva vista
   Cambie a la vista que creó. Siga los mismos pasos que en el Método 1: Exportar > Exportar a Excel. Los datos exportados coinciden solo con los archivos y columnas visibles en esta vista.
4. Eliminar la vista si no es necesaria
   Después de la exportación, puede eliminar la vista temporal desde Configuración de la biblioteca > Vistas para mantener la biblioteca ordenada.

Método 3: Exportar con PowerShell (PnP.PowerShell)

PowerShell es el único método integrado que maneja bibliotecas con miles de elementos y puede exportar columnas de metadatos que no son visibles en la vista predeterminada. Necesita el módulo PnP.PowerShell instalado en su equipo y permisos de administrador de SharePoint o propietario del sitio.

1. Instalar PnP.PowerShell
   Abra PowerShell como administrador y ejecute: Install-Module PnP.PowerShell -Scope CurrentUser. Responda Sí para instalar desde PSGallery si se le solicita.
2. Conectarse al sitio de SharePoint
   Ejecute: Connect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/yoursite" -Interactive. Inicie sesión con sus credenciales de Microsoft 365.
3. Exportar los elementos de la biblioteca a CSV
   Ejecute este script, reemplazando el nombre de la biblioteca y la ruta de salida:

   $items = Get-PnPListItem -List "Shared Documents" -PageSize 1000
   $items | Export-Csv -Path "C:\exports\library_inventory.csv" -NoTypeInformation

   El parámetro -PageSize 1000 evita los tiempos de espera agotados en bibliotecas grandes.

4. Incluir columnas de metadatos específicas
   Para exportar columnas personalizadas, agregue el parámetro -Fields:

   Get-PnPListItem -List "Shared Documents" -Fields "FileLeafRef","FileSizeDisplay","Editor","ProjectName" | Export-Csv "library.csv" -NoTypeInformation

   Reemplace ProjectName con el nombre interno real de su columna.

Errores comunes al exportar una biblioteca a CSV

El botón Exportar está atenuado o no aparece

El botón Exportar a Excel desaparece si la biblioteca supera los 5000 elementos o si el navegador bloquea las ventanas emergentes. Use PowerShell para bibliotecas grandes. Permita las ventanas emergentes para su dominio de SharePoint en la configuración del navegador.

El CSV exportado muestra solo 5000 filas

El umbral de vista de lista de SharePoint limita las exportaciones a 5000 elementos. El método de PowerShell omite este límite. Si debe usar la exportación desde la cinta de opciones, cree una vista con un filtro para exportar lotes más pequeños.

Faltan columnas de metadatos en el CSV

La exportación solo incluye las columnas visibles en la vista actual. Agregue todas las columnas necesarias a la vista antes de exportar. Para PowerShell, use el parámetro -Fields para especificar columnas por nombre interno.

El CSV contiene columnas adicionales como ID o Tipo de contenido

La vista predeterminada de la biblioteca incluye muchas columnas del sistema. Cree una vista personalizada solo con las columnas que necesita y luego exporte esa vista. En PowerShell, use Select-Object para limitar las propiedades exportadas.

Método de exportación	Exportar a Excel desde la cinta de opciones	PowerShell PnP.PowerShell
Máximo de elementos	5000	Ilimitado (con paginación)
Columnas de metadatos	Solo las columnas de la vista actual	Cualquier columna por nombre interno
Tiempo de configuración	Menos de 1 minuto	10 minutos (instalar el módulo, escribir el script)
Permisos necesarios	Colaboración o superior	Propietario del sitio o administrador de SharePoint

La exportación desde la cinta de opciones funciona mejor para inventarios pequeños y rápidos. PowerShell es la opción correcta para bibliotecas grandes, metadatos personalizados o exportaciones recurrentes. Después de exportar el CSV, puede abrirlo en Excel, importarlo en Power BI o usarlo para herramientas de migración. Para exportaciones automatizadas mensuales, programe el script de PowerShell con el Programador de tareas en un equipo Windows.