Fluxo do Power Automate Não Dispara no Upload de Arquivo: Correção
🔍 WiseChecker

Fluxo do Power Automate Não Dispara no Upload de Arquivo: Correção

Você criou um fluxo do Power Automate para ser executado automaticamente quando um arquivo é carregado em uma biblioteca de documentos do SharePoint, mas o fluxo nunca inicia. Isso acontece mesmo depois de você testar o fluxo manualmente e ele funcionar. A causa é quase sempre uma incompatibilidade entre a configuração do gatilho e as configurações reais da biblioteca do SharePoint, como uma condição de gatilho ausente ou uma biblioteca que usa um tipo de conteúdo personalizado. Este artigo explica os três motivos mais comuns pelos quais um gatilho do SharePoint falha no upload de arquivos e fornece as etapas exatas para corrigir cada um.

Principais Conclusões: Corrigindo um Gatilho do Power Automate no Upload de Arquivo

  • Condição de gatilho no editor de fluxo: Adicione uma condição que verifica se a propriedade do arquivo “IsFolder” é igual a falso para excluir eventos de criação de pasta.
  • Configurações de versão da biblioteca do SharePoint: Ative “Exigir aprovação de conteúdo” ou ajuste o gatilho para disparar na modificação do arquivo em vez da criação.
  • Consulta de filtro OData no gatilho: Remova ou corrija qualquer filtro OData que restrinja o gatilho a arquivos com uma extensão ou propriedade específica.

ADVERTISEMENT

Por que o Power Automate Não Dispara no Upload de Arquivo

O motivo mais comum é que o Power Automate trata a criação de pasta da mesma forma que a criação de arquivo. Quando você carrega um arquivo em uma biblioteca do SharePoint, o sistema primeiro cria uma entrada de pasta antes de escrever o conteúdo do arquivo. O gatilho padrão “Quando um arquivo é criado” é acionado em eventos de criação de pasta, então seu fluxo pode iniciar, mas falhar imediatamente ou não fazer nada porque o item é uma pasta, não um arquivo. Uma segunda causa comum são as configurações de versão. Se sua biblioteca exige aprovação de conteúdo, o arquivo é criado em um estado de rascunho e o gatilho pode não disparar até que o arquivo seja aprovado. Uma terceira causa é uma consulta de filtro OData que restringe o gatilho a tipos de arquivo ou propriedades específicas que não correspondem ao arquivo carregado.

Criação de Pasta vs Criação de Arquivo em Gatilhos do SharePoint

O SharePoint trata pastas e arquivos de forma semelhante no nível do gatilho. Quando você arrasta um arquivo para uma biblioteca, o SharePoint cria um item de pasta com o nome do arquivo e, em seguida, o substitui imediatamente pelo conteúdo real do arquivo. O gatilho “Quando um arquivo é criado” captura a criação inicial da pasta. Se o seu fluxo não filtrar pastas, ele será executado no item da pasta e depois parará porque o item da pasta não possui propriedades de arquivo, como tamanho ou tipo de conteúdo. Sempre adicione uma condição de gatilho para verificar se o item não é uma pasta.

Interferência de Aprovação de Conteúdo e Versão

Quando uma biblioteca do SharePoint tem aprovação de conteúdo ativada, os arquivos carregados começam em um estado de rascunho. O gatilho “Quando um arquivo é criado” é acionado quando o rascunho é criado, mas o conteúdo do arquivo pode não estar totalmente disponível ainda. Se o seu fluxo tentar ler o conteúdo ou metadados do arquivo imediatamente, pode falhar. Nesse caso, use o gatilho “Quando um arquivo é criado ou modificado” e adicione uma condição para verificar o status de aprovação. Como alternativa, desative a aprovação de conteúdo para a biblioteca se a aprovação não for necessária.

Etapas para Corrigir o Gatilho do Fluxo do Power Automate

Siga estas etapas em ordem. Teste o fluxo após cada etapa para identificar a causa exata.

Etapa 1: Adicionar uma Condição de Gatilho para Excluir Pastas

  1. Abra o fluxo no editor do Power Automate
    Acesse make.powerautomate.com e faça login. Selecione Meus fluxos no menu à esquerda e clique no fluxo que não está disparando.
  2. Edite o gatilho
    Clique nos três pontos no cartão do gatilho chamado “Quando um arquivo é criado” ou “Quando um arquivo é criado ou modificado.” Selecione Configurações no menu.
  3. Adicione a condição de gatilho
    No painel Configurações, encontre Condições de Gatilho. Clique em Adicionar. Na caixa de expressão, cole o seguinte: @not(equals(triggerOutputs()?['body/{IsFolder}'], true)). Isso instrui o fluxo a ser executado apenas quando o novo item não for uma pasta. Clique em Concluído e salve o fluxo.

Etapa 2: Verificar a Versão e Aprovação da Biblioteca do SharePoint

  1. Acesse as configurações da biblioteca do SharePoint
    Abra o site do SharePoint no seu navegador. Navegue até a biblioteca de documentos onde você carrega arquivos. Clique no ícone de engrenagem no canto superior direito e selecione Configurações da biblioteca.
  2. Verifique as configurações de versão
    Em Configurações gerais, clique em Configurações de versão. Observe a seção Aprovação de conteúdo. Se “Exigir aprovação de conteúdo para itens enviados” estiver definido como Sim, a biblioteca usa segurança de rascunho. Isso pode atrasar o gatilho. Para teste, defina como Não. Clique em OK.
  3. Altere o gatilho para disparar na modificação
    Se você não puder desativar a aprovação de conteúdo, altere o gatilho do fluxo de “Quando um arquivo é criado” para “Quando um arquivo é criado ou modificado.” Em seguida, adicione uma condição no fluxo que verifique o status de aprovação. Use o conteúdo dinâmico “Status de Aprovação” e verifique se é igual a “Aprovado.” Execute o restante do fluxo apenas quando o arquivo estiver aprovado.

Etapa 3: Remover ou Corrigir a Consulta de Filtro OData

  1. Abra as configurações do gatilho
    No editor do Power Automate, clique no cartão do gatilho. Nos parâmetros do gatilho, procure um campo chamado “Consulta de Filtro” ou “Consulta de Filtro OData.” Isso geralmente está oculto em “Mostrar opções avançadas.”
  2. Revise a expressão do filtro
    Se a consulta de filtro contiver algo como FileLeafRef eq 'pdf' ou File_x0020_Type eq 'docx', pode estar impedindo o gatilho de disparar em arquivos com extensões diferentes. Remova o filtro completamente para testar. Se precisar de um filtro, use a sintaxe OData correta. Por exemplo, para disparar apenas em arquivos PDF, use File_x0020_Type eq 'pdf'.
  3. Salve e teste
    Após remover ou corrigir o filtro, salve o fluxo. Carregue um arquivo de teste na biblioteca e verifique se o fluxo inicia dentro de um minuto.

ADVERTISEMENT

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

O Fluxo é Executado Mas Não Faz Nada Após Disparar

Se o fluxo dispara, mas as ações subsequentes falham, verifique o tipo de conteúdo do arquivo. Alguns fluxos esperam um tipo de conteúdo específico, como “Documento.” Se o arquivo carregado usar um tipo de conteúdo personalizado, os campos de conteúdo dinâmico podem estar ausentes. Abra o histórico de execução do fluxo, clique na ação com falha e procure mensagens de erro sobre propriedades ausentes. Atualize o fluxo para usar conteúdo dinâmico genérico, como “Identificador do Arquivo” em vez de campos específicos do tipo de conteúdo.

O Fluxo Dispara em Toda Alteração de Arquivo, Não Apenas no Upload

Se você usou o gatilho “Quando um arquivo é criado ou modificado,” o fluxo é executado em cada edição, renomeação ou alteração de metadados. Para restringir apenas a novos arquivos, adicione uma condição de gatilho que verifique a data de criação do arquivo. Use a expressão @equals(triggerOutputs()?['body/{Created}'], triggerOutputs()?['body/{Modified}']). Isso garante que o fluxo seja executado apenas quando os carimbos de data/hora de criação e modificação forem idênticos, o que acontece apenas no primeiro upload.

O Fluxo Não Dispara para Arquivos Adicionados via Sincronização ou Migração

O Power Automate dispara com base em eventos do SharePoint. Arquivos adicionados por meio da sincronização do OneDrive ou ferramentas de migração de terceiros podem não gerar o mesmo evento do SharePoint que um upload manual pelo navegador. Nesse caso, use o gatilho “Quando um arquivo é criado ou modificado em uma pasta” e defina a pasta como a raiz da biblioteca. Como alternativa, use um fluxo agendado que verifique novos arquivos a cada 15 minutos usando a API REST do SharePoint.

Tipos de Gatilho para Upload de Arquivo no SharePoint: Principais Diferenças

Item Quando um arquivo é criado Quando um arquivo é criado ou modificado
Descrição Dispara apenas quando um novo arquivo é adicionado à biblioteca Dispara em novos arquivos e em quaisquer edições subsequentes ou alterações de metadados
Eventos de pasta Dispara na criação de pasta — deve usar condição de gatilho para excluir pastas Dispara na criação de pasta — deve usar condição de gatilho para excluir pastas
Aprovação de conteúdo Dispara na criação do rascunho, pode falhar se o conteúdo do arquivo não estiver pronto Dispara no rascunho e na aprovação, oferece mais controle com verificação de status de aprovação
Melhor caso de uso Fluxos de trabalho simples que processam arquivos imediatamente após o upload Fluxos de trabalho que exigem aprovação de arquivo ou processam alterações ao longo do tempo

Agora você conhece as três principais causas de um fluxo do Power Automate não disparar no upload de arquivo: eventos de pasta, aprovação de conteúdo e filtros OData incorretos. Comece adicionando a condição de gatilho para excluir pastas, depois verifique as configurações de versão da sua biblioteca. Se você usa aprovação de conteúdo, mude para o gatilho “criado ou modificado” e adicione uma verificação de status de aprovação. Como dica avançada, sempre teste com um arquivo de texto simples primeiro para isolar o problema de restrições de tipo de arquivo.

ADVERTISEMENT