Como Corrigir o Bloqueio de Upload de Arquivos por Metadados Obrigatórios

Ao fazer upload de um arquivo para uma biblioteca de documentos do SharePoint que possui colunas de metadados obrigatórias, o processo pode parar ou falhar sem aviso. Isso acontece porque o SharePoint impõe regras de metadados antes de salvar o arquivo. Se os campos obrigatórios estiverem ausentes ou preenchidos incorretamente, o upload é bloqueado. Este artigo explica por que a imposição de metadados bloqueia uploads e fornece métodos passo a passo para corrigir o problema.

Por que o SharePoint Bloqueia Uploads de Arquivos Quando Metadados São Obrigatórios

As bibliotecas de documentos do SharePoint impõem validação em nível de coluna no momento do upload. Quando uma biblioteca contém colunas marcadas como “Obrigatório”, o SharePoint espera que essas colunas tenham um valor antes que o arquivo seja confirmado no banco de dados. Se o método de upload — arrastar e soltar, upload pelo navegador ou cliente de sincronização — não fornecer uma maneira de preencher os metadados obrigatórios, o upload é rejeitado ou fica em estado pendente.

A causa raiz técnica é o esquema de lista da biblioteca. Cada coluna possui um atributo <Required> definido como TRUE. O receptor de evento de criação de item do SharePoint verifica esse atributo antes de salvar o arquivo. Se o atributo for TRUE e o campo estiver vazio, o sistema gera um erro de validação. Os usuários veem mensagens como “Você deve especificar um valor para este campo obrigatório” ou o upload simplesmente para sem erro claro.

Outra causa comum é a herança de tipo de conteúdo. Se uma biblioteca tiver vários tipos de conteúdo, cada um pode definir suas próprias colunas obrigatórias. Quando um arquivo é enviado com um tipo de conteúdo específico, o SharePoint verifica apenas as colunas obrigatórias para aquele tipo de conteúdo. Se a coluna for obrigatória no tipo de conteúdo, mas não na biblioteca, o upload ainda pode ser bloqueado.

Passos para Corrigir o Bloqueio de Upload por Metadados Obrigatórios

Existem três métodos confiáveis para resolver esse problema. Escolha o método que melhor se adequa ao seu ambiente e ao número de arquivos afetados.

Método 1: Definir Valores Padrão para Colunas Obrigatórias na Biblioteca

1. Navegue até as configurações da biblioteca
   Vá para a biblioteca de documentos onde os uploads estão bloqueados. Clique no ícone de engrenagem e selecione Configurações da biblioteca.
2. Abra as configurações da coluna
   Em Colunas, clique no nome da coluna obrigatória que está bloqueando os uploads.
3. Altere a configuração Obrigatório para Não
   Na página de configurações da coluna, defina Exigir que esta coluna contenha informações como Não. Clique em OK.
4. Teste o upload
   Arraste um arquivo para a biblioteca. O upload deve ser bem-sucedido sem solicitação de metadados.
5. Adicione um valor padrão (opcional)
   Se ainda quiser que a coluna apareça, mas não bloqueie uploads, defina um Valor padrão nas configurações da coluna. Mantenha Obrigatório como Não.

Método 2: Usar PowerShell para Atualizar Arquivos Travados com Metadados

Se os arquivos já estiverem travados na biblioteca devido à falta de metadados obrigatórios, use o SharePoint Online Management Shell ou o PnP PowerShell para atualizá-los.

1. Conecte-se ao SharePoint Online
   Abra o PowerShell como administrador. Execute Connect-PnPOnline -Url "https://sualocacao.sharepoint.com/sites/seusite" -Interactive
2. Obtenha a lista de arquivos travados
   Execute $items = Get-PnPListItem -List "Documentos" -PageSize 500 | Where-Object { $_.FieldValues["NomeColunaObrigatoria"] -eq $null }
3. Atualize cada item com um valor
   Execute Set-PnPListItem -List "Documentos" -Identity $item.Id -Values @{"NomeColunaObrigatoria" = "Valor Padrão"}
4. Verifique se os arquivos foram atualizados
   Atualize a biblioteca no navegador. Os arquivos agora devem aparecer com os metadados preenchidos.

Método 3: Remover a Exigência de Tipo de Conteúdo para Colunas Específicas

1. Vá para as configurações de Tipo de Conteúdo
   Nas configurações da biblioteca, em Tipos de Conteúdo, clique no tipo de conteúdo que está bloqueando uploads.
2. Abra a coluna
   Clique no nome da coluna obrigatória em Colunas.
3. Altere a configuração Obrigatório
   Defina Exigir que esta coluna contenha informações como Não. Clique em OK.
4. Repita para cada tipo de conteúdo
   Se a biblioteca usar vários tipos de conteúdo, repita as etapas para cada um que tenha a coluna obrigatória.

Se os Metadados Ainda Bloquearem o Upload Após a Correção Principal

Upload de Arquivo Para sem Mensagem de Erro

Isso geralmente ocorre quando uma coluna obrigatória usa um campo de pesquisa ou metadados gerenciados. O uploader do navegador não pode exibir o seletor de pesquisa durante o arrastar e soltar. Use o botão Upload > Adicionar um arquivo, que abre o painel de metadados. Como alternativa, desabilite a configuração obrigatória em colunas de pesquisa.

Upload Funciona para Alguns Usuários, mas Não para Outros

Verifique as permissões dos usuários. Usuários com permissão Contribuir ou Editar podem fazer upload, mas podem não ter permissão para preencher determinados campos de metadados se esses campos forem restritos por configurações de permissão em nível de item. Conceda acesso de Leitura ou Edição à coluna específica nas configurações de permissão da biblioteca.

Arquivos Enviados pelo Cliente de Sincronização Microsoft Falham

O cliente de sincronização do OneDrive não suporta campos de metadados obrigatórios. Arquivos sincronizados de uma pasta local falharão ao fazer upload se a biblioteca tiver colunas obrigatórias. Desabilite a configuração obrigatória em todas as colunas que os usuários de sincronização precisam preencher. Como alternativa, instrua os usuários a fazer upload pelo navegador e preencher os metadados manualmente.

Comparação de Configurações da Biblioteca: Métodos de Imposição de Metadados

Item	Coluna Obrigatória (Sem Padrão)	Coluna Obrigatória (Com Padrão)	Coluna Não Obrigatória
Upload via arrastar e soltar	Bloqueado	Permitido	Permitido
Upload via botão Adicionar do navegador	Solicita metadados	Permitido com preenchimento automático	Permitido
Upload via cliente de sincronização	Falha com erro de sincronização	Permitido se o padrão estiver definido	Permitido
Atualização em lote via PowerShell	Funciona se o valor for fornecido	Funciona	Funciona

Após aplicar um dos três métodos, os usuários poderão fazer upload de arquivos para a biblioteca do SharePoint sem bloqueio de metadados. Para gerenciamento contínuo, revise todas as colunas obrigatórias nas configurações da biblioteca e defina valores padrão quando possível. Uma dica avançada: use fórmulas de validação de coluna do SharePoint para permitir valores vazios apenas durante o upload e, em seguida, imponha metadados por meio de fluxos do Power Automate após o arquivo ser confirmado.