Exportar Inventário de Arquivos de uma Biblioteca para CSV: Guia Prático para Proprietários do SharePoint

Como proprietário de um site do SharePoint, você pode precisar de uma lista completa de arquivos em uma biblioteca de documentos para auditoria, planejamento de migração ou relatórios de armazenamento. Copiar manualmente nomes de arquivos e metadados é lento e propenso a erros. O SharePoint oferece vários métodos integrados para exportar dados da biblioteca para um arquivo CSV sem ferramentas de terceiros. Este artigo aborda cada método, explica quais dados podem ser capturados e lista armadilhas comuns a evitar.

O Que Você Pode Exportar de uma Biblioteca de Documentos do SharePoint

Uma biblioteca de documentos do SharePoint armazena arquivos e colunas de metadados como Criado por, Data de Modificação, Tamanho do Arquivo e colunas personalizadas como Tipo de Documento ou Nome do Projeto. Ao exportar a biblioteca para CSV, você pode capturar todas as colunas visíveis na exibição atual. O processo de exportação cria um arquivo .csv que pode ser aberto no Excel ou em qualquer aplicativo de planilha. Você não pode exportar conteúdos de arquivo ou histórico de versões diretamente para CSV — apenas as linhas de metadados. Se precisar do histórico de versões, use o relatório interno de Histórico de Versões ou um script PowerShell.

Antes de começar, confirme que você tem pelo menos permissões de Editar ou Contribuir na biblioteca. Membros do site com acesso de Leitura podem visualizar arquivos, mas não podem exportar os dados da lista da biblioteca. Se a biblioteca contiver mais de 5.000 itens, a exportação padrão pode expirar. Use o método PowerShell para bibliotecas grandes.

Método 1: Exportar para Excel a Partir da Faixa de Opções da Biblioteca

Esta é a maneira mais rápida de exportar um inventário da biblioteca. Funciona para bibliotecas com menos de 5.000 itens e exporta todas as colunas visíveis na exibição atual.

1. Abra a biblioteca de documentos
   Navegue até o site do SharePoint e abra a biblioteca de documentos que deseja exportar.
2. Clique em Exportar para Excel
   Na barra de ferramentas da biblioteca, selecione Exportar e depois Exportar para Excel. Se a opção estiver ausente, seu navegador pode estar bloqueando pop-ups — permita pop-ups para o domínio do SharePoint.
3. Confirme a consulta de exportação
   Uma caixa de diálogo pergunta se você deseja exportar a exibição atual. Clique em Abrir ou Salvar. O arquivo é baixado como um arquivo .iqy, que o Excel abre como uma tabela vinculada.
4. Salve como CSV
   No Excel, vá em Arquivo > Salvar Como, escolha CSV UTF-8 (delimitado por vírgulas) e nomeie o arquivo. O CSV agora contém todas as linhas e colunas da exibição da biblioteca.

Método 2: Criar uma Exibição Personalizada e Exportar

Use este método quando precisar apenas de arquivos ou colunas específicas. Crie uma exibição que filtre ou classifique a biblioteca e depois exporte essa exibição para CSV.

1. Crie uma nova exibição
   Na biblioteca, clique em Todos os Itens (ou no nome da exibição atual) e selecione Criar nova exibição. Escolha um tipo de exibição, como Exibição Padrão.
2. Defina filtros e colunas
   Dê um nome à exibição. Em Colunas, selecione apenas as colunas necessárias. Em Filtro, adicione condições como Tipo de Arquivo igual a pdf ou Modificado é maior que 01/01/2024. Clique em OK.
3. Exporte a nova exibição
   Alterne para a exibição criada. Siga os mesmos passos do Método 1: Exportar > Exportar para Excel. Os dados exportados correspondem apenas aos arquivos e colunas visíveis nesta exibição.
4. Exclua a exibição se não for necessária
   Após a exportação, você pode excluir a exibição temporária em Configurações da Biblioteca > Exibições para manter a biblioteca organizada.

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

O PowerShell é o único método integrado que lida com bibliotecas com milhares de itens e pode exportar colunas de metadados não visíveis na exibição padrão. Você precisa do módulo PnP.PowerShell instalado no computador e permissões de administrador do SharePoint ou proprietário do site.

1. Instale o PnP.PowerShell
   Abra o PowerShell como administrador e execute: Install-Module PnP.PowerShell -Scope CurrentUser. Responda Sim para instalar do PSGallery se solicitado.
2. Conecte-se ao seu site do SharePoint
   Execute: Connect-PnPOnline -Url "https://sualocacao.sharepoint.com/sites/seosite" -Interactive. Faça login com suas credenciais do Microsoft 365.
3. Exporte itens da biblioteca para CSV
   Execute este script, substituindo o nome da biblioteca e o caminho de saída:

   $items = Get-PnPListItem -List "Documentos Compartilhados" -PageSize 1000
   $items | Export-Csv -Path "C:\exports\inventario_biblioteca.csv" -NoTypeInformation

   O parâmetro -PageSize 1000 evita timeouts em bibliotecas grandes.

4. Inclua colunas de metadados específicas
   Para exportar colunas personalizadas, adicione o parâmetro -Fields:

   Get-PnPListItem -List "Documentos Compartilhados" -Fields "FileLeafRef","FileSizeDisplay","Editor","NomeProjeto" | Export-Csv "biblioteca.csv" -NoTypeInformation

   Substitua NomeProjeto pelo nome interno real da sua coluna.

Erros Comuns ao Exportar uma Biblioteca para CSV

Botão Exportar está esmaecido ou ausente

O botão Exportar para Excel desaparece se a biblioteca exceder 5.000 itens ou se o navegador bloquear pop-ups. Use PowerShell para bibliotecas grandes. Permita pop-ups para o domínio do SharePoint nas configurações do navegador.

CSV exportado mostra apenas 5.000 linhas

O limite de exibição de lista do SharePoint restringe exportações a 5.000 itens. O método PowerShell contorna esse limite. Se precisar usar a exportação da faixa de opções, crie uma exibição com um filtro para exportar lotes menores.

Colunas de metadados estão faltando no CSV

A exportação inclui apenas colunas visíveis na exibição atual. Adicione todas as colunas necessárias à exibição antes de exportar. No PowerShell, use o parâmetro -Fields para especificar colunas pelo nome interno.

CSV contém colunas extras como ID ou Tipo de Conteúdo

A exibição padrão da biblioteca inclui muitas colunas do sistema. Crie uma exibição personalizada com apenas as colunas necessárias e depois exporte essa exibição. No PowerShell, use Select-Object para limitar as propriedades exportadas.

Método de Exportação	Exportar para Excel (Faixa de Opções)	PowerShell PnP.PowerShell
Itens máximos	5.000	Ilimitado (com paginação)
Colunas de metadados	Apenas colunas na exibição atual	Qualquer coluna por nome interno
Tempo de configuração	Menos de 1 minuto	10 minutos (instalar módulo, escrever script)
Permissões necessárias	Contribuir ou superior	Proprietário do site ou administrador do SharePoint

A exportação pela faixa de opções funciona melhor para inventários rápidos e pequenos. O PowerShell é a escolha correta para bibliotecas grandes, metadados personalizados ou exportações recorrentes. Após exportar o CSV, você pode abri-lo no Excel, importá-lo para o Power BI ou usá-lo em ferramentas de migração. Para exportações automatizadas mensais, agende o script PowerShell usando o Agendador de Tarefas em uma máquina Windows.