Metadados do Conjunto de Documentos Não Sincronizam com os Arquivos: Causa e Solução

Ao atualizar metadados em um Conjunto de Documentos do SharePoint, você espera que esses valores apareçam em cada arquivo dentro do conjunto. Muitos usuários descobrem que os metadados não sincronizam com os arquivos, deixando colunas em branco ou desatualizadas. Esse problema ocorre porque o SharePoint armazena metadados no nível do conjunto, não no nível do arquivo individual, e o mecanismo interno de push-down não é acionado automaticamente em todos os cenários. Este artigo explica a causa raiz da falha de sincronização e fornece uma correção passo a passo para enviar metadados do Conjunto de Documentos para todos os arquivos dentro do conjunto.

Por que os Metadados do Conjunto de Documentos Não Sincronizam com os Arquivos

Um Conjunto de Documentos no SharePoint é um tipo de conteúdo especial que agrupa vários arquivos. Os campos de metadados no Conjunto de Documentos são colunas compartilhadas — elas aparecem na página de propriedades do conjunto e em cada arquivo dentro do conjunto. No entanto, os valores inseridos no conjunto não são gravados automaticamente nos arquivos individuais. O SharePoint trata o Conjunto de Documentos como um contêiner, não como um pai que envia dados para baixo por padrão.

O mecanismo de sincronização requer um gatilho específico. O SharePoint inclui um recurso de push-down que copia metadados do Conjunto de Documentos para seus arquivos, mas esse recurso deve ser ativado por coluna e depois executado. Sem esse gatilho, os arquivos mantêm seus próprios valores de metadados, que geralmente estão vazios ou desatualizados.

A causa raiz é a ausência de um receptor de eventos automático que propague alterações de metadados. Quando você atualiza uma coluna no Conjunto de Documentos, o SharePoint não atualiza automaticamente os arquivos dentro dele. A ação de push-down deve ser iniciada manualmente, por meio de um workflow ou de uma solução personalizada. Esse design evita problemas de desempenho em conjuntos grandes, mas deixa muitos usuários confusos quando os metadados não sincronizam.

Passos para Sincronizar Metadados do Conjunto de Documentos com os Arquivos

Use o método a seguir para ativar e executar a sincronização push-down. Este processo usa o SharePoint Designer 2013, que ainda é compatível com ambientes on-premises e SharePoint Online (modo clássico). Se você usa o SharePoint Online moderno, considere um fluxo do Power Automate como alternativa.

1. Ativar push-down no tipo de conteúdo Conjunto de Documentos
   Vá em Configurações do Site > Tipos de Conteúdo do Site. Encontre o tipo de conteúdo Conjunto de Documentos. Clique nele e depois em Configurações do Conjunto de Documentos. Em “Tipos de Conteúdo Permitidos”, verifique se os tipos de conteúdo que você deseja sincronizar estão listados. Role até “Colunas Compartilhadas” e selecione as colunas que devem sincronizar com os arquivos. Marque a caixa “Enviar alterações para itens no Conjunto de Documentos” para cada coluna. Clique em OK.
2. Criar um workflow do SharePoint Designer 2013 no Conjunto de Documentos
   Abra o SharePoint Designer 2013. Conecte-se ao seu site. Em Objetos, selecione a Lista ou Biblioteca que contém os Conjuntos de Documentos. Clique em Workflows > Novo > Workflow do SharePoint 2013. Nomeie como “Sincronizar Metadados do Conjunto de Documentos”.
3. Configurar o workflow para enviar metadados na alteração
   No designer de workflow, adicione uma etapa que seja executada “quando um item é criado” e “quando um item é modificado”. Adicione uma ação: “Chamar serviço web HTTP”. Use o seguinte endpoint REST:
   _api/web/lists/getbytitle('SuaBiblioteca')/items(CurrentItem:ID)/DocumentSetFields/Propagate
   Defina os cabeçalhos da solicitação para aceitar JSON e inclua o valor do digest. Essa ação aciona o push-down para o Conjunto de Documentos atual.
4. Publicar e associar o workflow
   Salve o workflow e publique-o. Associe o workflow ao tipo de conteúdo Conjunto de Documentos na biblioteca. Configure o workflow para iniciar automaticamente quando um item for criado ou modificado.
5. Testar a sincronização
   Adicione um novo Conjunto de Documentos ou atualize metadados em um existente. Verifique os arquivos dentro do conjunto — seus metadados agora devem corresponder aos valores do conjunto. Se a sincronização falhar, verifique se a URL do endpoint REST está correta e se o nome da biblioteca corresponde exatamente.

Problemas Comuns Quando os Metadados do Conjunto de Documentos Não Sincronizam

Atualizações de metadados funcionam apenas em conjuntos recém-criados

Se você ativar o push-down somente depois que os conjuntos já existirem, os conjuntos existentes podem não sincronizar. Execute o workflow manualmente em cada Conjunto de Documentos existente ou use um script do PowerShell para acionar a ação de propagação em todos os conjuntos. No PowerShell, use o método CSOM DocumentSet.Propagate em cada conjunto.

Valores de coluna aparecem em branco nos arquivos após o push

Isso acontece quando a coluna não está marcada como coluna compartilhada nas configurações do Conjunto de Documentos. Verifique se a coluna está na lista “Colunas Compartilhadas” e se a caixa de seleção push-down está marcada. Confirme também que a coluna existe no tipo de conteúdo do arquivo.

Workflow falha com “Acesso Negado”

A conta do workflow precisa de permissões de Edição na biblioteca. Se você usar um workflow do SharePoint 2013 com etapa de aplicativo, o workflow é executado com privilégios de conta do sistema, o que ignora as verificações de permissão. Como alternativa, use um fluxo do Power Automate com a ação “Enviar uma solicitação HTTP para o SharePoint” e forneça credenciais de proprietário do site.

Push Manual vs Workflow vs Power Automate: Principais Diferenças

Item	Push Manual (Configurações do Site)	Workflow do SharePoint Designer	Fluxo do Power Automate
Gatilho	Nenhum — deve ser executado por conjunto	Automático na criação ou alteração do item	Automático na criação ou alteração do item
Facilidade de configuração	Simples — apenas caixas de seleção	Moderada — requer Designer e chamada REST	Moderada — requer ação HTTP e digest
Confiabilidade para conjuntos grandes	Boa — ação interna do SharePoint	Boa — executa de forma síncrona	Regular — pode expirar em conjuntos com muitos arquivos
Compatível com SharePoint Online	Sim (apenas modo clássico)	Sim (apenas modo clássico)	Sim (moderno e clássico)

Após ativar a configuração de coluna push-down e configurar um workflow automático, seus metadados do Conjunto de Documentos serão sincronizados consistentemente com os arquivos. Teste a configuração com um conjunto pequeno primeiro. Se você usa o SharePoint Online moderno, migre para o Power Automate para melhor compatibilidade. Para controle avançado, examine o endpoint REST _api/web/lists/getbytitle('Biblioteca')/items(ID)/DocumentSetFields/Propagate — ele aciona o mesmo push-down que a caixa de seleção manual usa.