Como Corrigir Falhas de Fluxo em Metadados Obrigatórios Após Criar Arquivo

Quando você cria um arquivo em uma biblioteca de documentos do SharePoint, um fluxo do Power Automate pode falhar se a biblioteca tiver colunas de metadados obrigatórios. O fluxo tenta ler ou atualizar o arquivo antes que os metadados sejam salvos, causando um tempo limite ou erro. Este artigo explica por que isso acontece e fornece correções passo a passo para resolver a falha.

A causa raiz é que o Power Automate é acionado na criação do arquivo antes que o SharePoint termine de salvar os metadados obrigatórios. O fluxo então tenta obter propriedades do arquivo ou atualizar colunas, mas os campos obrigatórios estão vazios, então a operação falha. Você aprenderá como atrasar o fluxo, usar o gatilho correto e lidar com atualizações de metadados de forma confiável.

Ao final deste artigo, você será capaz de configurar um fluxo que aguarda os metadados serem salvos e então atualiza o arquivo sem erros. Você também aprenderá como testar o fluxo e evitar armadilhas comuns.

Por que o Fluxo Falha Quando um Arquivo Tem Metadados Obrigatórios

Bibliotecas de documentos do SharePoint podem ter colunas marcadas como obrigatórias. Quando um usuário envia um arquivo, o SharePoint solicita que o usuário preencha essas colunas antes que o arquivo seja totalmente salvo. No entanto, gatilhos do Power Automate como “Quando um arquivo é criado (somente propriedades)” disparam no momento em que o SharePoint registra o evento de criação do arquivo, o que acontece antes que o usuário complete o formulário de metadados. O fluxo então tenta obter ou atualizar as propriedades do arquivo, mas as colunas obrigatórias estão vazias, fazendo com que o fluxo falhe com erros como “Campo obrigatório está vazio” ou “Metadados de arquivo inválidos”.

O gatilho “Quando um arquivo é criado (somente propriedades)” foi projetado para capturar apenas os metadados do arquivo, não o conteúdo do arquivo. Mas ele ainda dispara antes que o SharePoint termine de escrever os metadados no banco de dados. Se você usar o gatilho “Quando um arquivo é criado”, ele aguarda o conteúdo do arquivo, mas ainda não espera que os metadados obrigatórios sejam salvos. Essa diferença de tempo é a causa técnica central da falha.

O Papel da Ação “Atraso”

Adicionar uma ação “Atraso” após o gatilho dá ao SharePoint tempo suficiente para concluir o processo de salvamento dos metadados. O atraso deve ser longo o bastante para o usuário preencher os campos obrigatórios, mas não tão longo a ponto de desacelerar o fluxo desnecessariamente. Um atraso de 30 segundos funciona na maioria dos casos, mas você pode ajustá-lo com base na complexidade da sua biblioteca e no comportamento do usuário.

Passos para Corrigir Falhas de Fluxo em Metadados Obrigatórios

Método 1: Adicionar uma Ação de Atraso Após o Gatilho

1. Abra seu fluxo no Power Automate
   Vá para make.powerautomate.com, selecione “Meus fluxos” e clique no fluxo que falha. Clique em “Editar”.
2. Insira uma ação “Atraso”
   Clique no “+” entre o gatilho e a próxima ação. Selecione “Adicionar uma ação”. Pesquise por “Atraso” e escolha a ação “Atraso” do conector “Agenda”.
3. Defina a duração do atraso
   Na ação “Atraso”, defina “Contagem” como 30 e “Unidade” como “Segundo”. Isso pausa o fluxo por 30 segundos após a criação do arquivo.
4. Adicione uma ação “Obter propriedades do arquivo” após o atraso
   Pesquise por “Obter propriedades do arquivo” e selecione a ação do SharePoint. Forneça o endereço do site e o nome da lista. Use o identificador do arquivo do gatilho (conteúdo dinâmico “Identificador”).
5. Use as propriedades do arquivo para ações subsequentes
   Agora use a saída de “Obter propriedades do arquivo” para ler os metadados obrigatórios. Isso garante que você está trabalhando com os metadados completos.
6. Salve e teste o fluxo
   Clique em “Salvar” e depois em “Testar”. Envie um arquivo para a biblioteca, preencha os metadados obrigatórios e verifique se o fluxo é executado sem erros.

Método 2: Usar o Gatilho “Quando um arquivo é criado ou modificado”

1. Altere o gatilho para “Quando um arquivo é criado ou modificado”
   No modo de edição do fluxo, remova o gatilho existente e adicione “Quando um arquivo é criado ou modificado” do SharePoint. Esse gatilho dispara após o arquivo ser totalmente salvo, incluindo os metadados.
2. Adicione uma condição para verificar se o arquivo é novo
   Adicione uma ação “Condição”. Use o conteúdo dinâmico “Saídas do gatilho” > “Hora da modificação” e compare com “Hora da criação”. Se forem iguais, o arquivo é recém-criado, não uma modificação.
3. Proceda com suas ações apenas para arquivos novos
   Coloque suas ações de atualização de metadados dentro do ramo “Se sim” da condição. Isso impede que o fluxo seja executado em cada modificação.
4. Salve e teste
   Salve o fluxo e teste criando um novo arquivo com metadados obrigatórios. O fluxo agora deve disparar apenas após os metadados serem salvos.

Método 3: Usar um Gatilho “Quando um arquivo é criado” com uma Solução Alternativa de “Aguardar aprovação”

1. Adicione uma ação “Aguardar aprovação”
   Após o gatilho, adicione uma ação “Iniciar e aguardar aprovação”. Isso pausa o fluxo até que os metadados do arquivo sejam aprovados manualmente por um usuário.
2. Configure a aprovação
   Defina a aprovação para ser enviada à pessoa que criou o arquivo ou a um gerente da biblioteca. O e-mail de aprovação pode incluir um link para o arquivo.
3. Após a aprovação, obtenha as propriedades do arquivo
   Adicione uma ação “Obter propriedades do arquivo” após a aprovação. Isso recupera os metadados mais recentes, que agora estão completos.
4. Complete o fluxo
   Adicione suas ações de atualização de metadados ou outras. Salve e teste.

Se o Fluxo Ainda Tiver Problemas Após a Correção Principal

O fluxo ainda falha com “Campo obrigatório está vazio” após adicionar atraso

O atraso pode ser muito curto. Aumente o atraso para 60 segundos. Se o problema persistir, verifique se a coluna obrigatória é uma coluna de metadados gerenciados ou uma coluna de pessoa ou grupo. Essas colunas às vezes exigem tempo extra de processamento. Verifique também se o usuário está realmente preenchendo os metadados obrigatórios. Se ele pular, o arquivo ainda será criado, mas com campos obrigatórios vazios, e o fluxo falhará. Nesse caso, adicione uma condição para verificar se os campos obrigatórios estão preenchidos antes de prosseguir.

O fluxo é executado várias vezes para o mesmo arquivo

Isso acontece ao usar o gatilho “Quando um arquivo é criado ou modificado” sem a verificação de condição. O fluxo é executado uma vez na criação e novamente em qualquer atualização de metadados. Adicione a condição descrita no Método 2 para limitar o fluxo apenas a arquivos novos. Como alternativa, use uma configuração “Condições do gatilho” nas propriedades do gatilho para filtrar pela hora de criação.

O fluxo falha com erro “Acesso negado”

A conta de serviço do fluxo pode não ter permissão para ler ou atualizar os metadados do arquivo. Vá para o centro de administração do SharePoint > Controles de acesso e garanta que a conexão do fluxo (geralmente a conta do proprietário) tenha pelo menos permissões de “Editar” na biblioteca de documentos. Se a biblioteca tiver permissões exclusivas, conceda a conta diretamente.

Item	Quando um arquivo é criado (somente propriedades)	Quando um arquivo é criado ou modificado
Dispara em	Evento de criação do arquivo antes do salvamento dos metadados	Criação do arquivo e qualquer modificação de metadados ou conteúdo
Aguarda metadados obrigatórios	Não	Sim, porque dispara após o salvamento
Precisa de solução alternativa com atraso	Sim, adicionar ação Atraso	Não, mas precisa de condição para filtrar arquivos novos
Melhor caso de uso	Quando você precisa apenas do identificador do arquivo antecipadamente	Quando você precisa trabalhar com metadados completos

Agora você tem três métodos confiáveis para corrigir falhas de fluxo causadas por metadados obrigatórios após a criação do arquivo. Comece adicionando um atraso de 30 segundos ao seu fluxo existente. Se o problema continuar, mude para o gatilho “Quando um arquivo é criado ou modificado” com uma condição. Para cenários avançados, use a solução alternativa de aprovação para confirmar manualmente a conclusão dos metadados. Como dica final, sempre teste seu fluxo com um arquivo que tenha todos os campos obrigatórios preenchidos para garantir que a correção funcione antes de implementá-la para os usuários.