Metadados do Conjunto de Documentos Não Sincronizam com os Arquivos: Correção Segura

Ao atualizar metadados em um Conjunto de Documentos do SharePoint, as alterações não aparecem automaticamente nos arquivos individuais dentro do conjunto. Esse comportamento confunde usuários que esperam que os valores das colunas sejam propagados para cada documento. A causa raiz é que os metadados do Conjunto de Documentos são armazenados no nível do conjunto e não foram projetados para substituir metadados de nível de arquivo por padrão. Este artigo explica por que a sincronização falha e fornece um método prático e seguro para copiar metadados do Conjunto de Documentos para seus arquivos filhos.

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

Os Conjuntos de Documentos do SharePoint são um tipo de conteúdo especial que agrupa documentos relacionados. Os metadados adicionados a um Conjunto de Documentos — como Nome do Projeto, Status ou Cliente — são armazenados no próprio item do Conjunto de Documentos, não nos arquivos individuais dentro dele. Ao visualizar um arquivo na biblioteca, as colunas de metadados ficam vazias ou mostram valores padrão. Isso é proposital: o SharePoint não propaga metadados pai para itens filhos. A falha de sincronização não é um bug; é uma limitação do recurso Conjunto de Documentos. Para que os metadados apareçam em cada arquivo, é necessário copiar ativamente os valores usando um fluxo de trabalho ou script personalizado.

Etapas Seguras para Sincronizar Metadados do Conjunto de Documentos com os Arquivos

O método a seguir usa o Power Automate, que é executado em segundo plano sem exigir código ou alterações diretas de permissões no SharePoint. É seguro para todos os usuários com pelo menos permissões de Edição na biblioteca.

1. Abra o Power Automate e crie um novo fluxo
   Acesse make.powerautomate.com e faça login com sua conta corporativa. Selecione Criar no menu à esquerda e escolha Fluxo de nuvem automatizado.
2. Defina o gatilho: “Quando um arquivo é adicionado ou modificado em uma pasta”
   Pesquise pelo conector do SharePoint e selecione o gatilho Quando um arquivo é adicionado ou modificado em uma pasta. Forneça a URL do site e o nome da biblioteca. No campo Pasta, deixe em branco para monitorar todas as pastas ou selecione a pasta específica do Conjunto de Documentos.
3. Adicione uma ação para obter os metadados do Conjunto de Documentos
   Clique em + Novo passo, pesquise por SharePoint e selecione a ação Obter metadados do arquivo. No campo Identificador do Arquivo, escolha o Identificador da saída do gatilho. Isso recupera o caminho da pasta do arquivo. Em seguida, adicione outra ação: Enviar uma solicitação HTTP para o SharePoint. Use as seguintes configurações:
   • Endereço do Site: URL do seu site
   • Método: GET
   • Uri: _api/web/getfilebyserverrelativeurl('@{triggerOutputs()?['body/{FullPath}']}')/ListItemAllFields

   Isso retorna o item de lista do arquivo, incluindo os metadados da pasta pai.

4. Extraia os valores dos metadados do Conjunto de Documentos
   Use a ação Compor para analisar a resposta JSON. Por exemplo, para obter a coluna Nome do Projeto, use a expressão: outputs('Enviar_uma_solicitação_HTTP_para_o_SharePoint')?['d']?['ProjectName']. Repita para cada coluna que deseja sincronizar.
5. Atualize os metadados do arquivo
   Adicione a ação Atualizar propriedades do arquivo. Selecione o site e a biblioteca. No campo Id, escolha o ID do Item da saída do gatilho. Para cada coluna, mapeie o valor da ação Compor. Por exemplo, defina Nome do Projeto como a saída da etapa Compor.
6. Salve e teste o fluxo
   Nomeie o fluxo como “Sincronizar Metadados do Conjunto de Documentos com Arquivos”. Clique em Salvar e depois em Testar. Carregue um novo arquivo na pasta do Conjunto de Documentos e verifique se o arquivo herda os valores de metadados do Conjunto de Documentos.

Problemas Comuns Quando os Metadados Não Sincronizam

“O fluxo é executado, mas os metadados permanecem vazios”

Isso geralmente acontece quando a solicitação HTTP retorna um valor nulo para a coluna do Conjunto de Documentos. Verifique a ortografia do nome da coluna na expressão Compor. Use o nome interno exato da coluna, que pode ser encontrado nas configurações da biblioteca do SharePoint, no nome da coluna. Espaços nos nomes das colunas devem ser substituídos por _x0020_ na expressão.

“O fluxo é acionado em toda alteração de arquivo, não apenas em novos arquivos”

Por padrão, o gatilho é executado tanto em eventos de adição quanto de modificação. Para limitar a novos arquivos, adicione uma condição que verifique se o arquivo foi criado nos últimos 5 minutos. Use a ação Condição com a expressão @{triggerOutputs()?['body/{Created}']} comparada a @{addHours(utcNow(), -0.083)}.

“A pasta do Conjunto de Documentos não é uma pasta real”

Os Conjuntos de Documentos aparecem como pastas na biblioteca, mas são tipos de conteúdo. O método de solicitação HTTP acima funciona porque recupera o item de lista do arquivo, que inclui os metadados da pasta pai, desde que a pasta seja um Conjunto de Documentos. Se a pasta for uma pasta padrão, este método não funcionará — os metadados devem ser armazenados na própria pasta.

Métodos de Sincronização de Metadados do Conjunto de Documentos: Comparação

Item	Fluxo do Power Automate	Fluxo de Trabalho do SharePoint Designer
Complexidade de configuração	Baixa, sem necessidade de código	Média, requer SharePoint Designer 2013
Gatilho	Arquivo adicionado ou modificado	Item criado ou alterado
Manutenção	Automática, baseada em nuvem	Manual, deve ser republicada após alterações
Permissões necessárias	Edição na biblioteca	Controle Total ou acesso de Designer
Desempenho	Rápido para até 100 arquivos por minuto	Mais lento, executado localmente ou no SharePoint

Os metadados do Conjunto de Documentos não são sincronizados automaticamente com os arquivos, mas você pode corrigir isso com um fluxo do Power Automate. Use as etapas acima para copiar os valores das colunas do conjunto para cada arquivo. Para metadados consistentes em todos os Conjuntos de Documentos, crie colunas do site e adicione-as ao tipo de conteúdo Conjunto de Documentos. Isso garante que as mesmas colunas apareçam em cada Conjunto de Documentos e em seus arquivos filhos.