Gatilho de Lista do SharePoint Ignora Itens Importados em Massa: O que os Administradores Devem Verificar

Quando você importa itens em massa em uma lista do SharePoint, o gatilho do Power Automate configurado pode não ser executado para cada item. Administradores do site frequentemente notam que alguns ou todos os registros importados estão ausentes no fluxo acionado. Isso acontece porque os gatilhos de lista do SharePoint, especialmente o Quando um item é criado ou modificado, se comportam de forma diferente durante operações em massa. Este artigo explica a causa exata desse comportamento e mostra quais configurações verificar para que seus fluxos processem cada item importado.

Por que os Gatilhos de Lista do SharePoint Ignoram Itens Importados em Massa

A causa raiz está na forma como o SharePoint lida com operações em massa. Quando você usa o assistente interno Importar de CSV ou uma ferramenta de terceiros para adicionar muitos itens de uma vez, o SharePoint geralmente cria esses itens em uma única chamada em lote. O gatilho Quando um item é criado ou modificado do Power Automate escuta eventos individuais de criação. Uma criação em lote pode gerar apenas um evento para todo o conjunto, que o gatilho pode ignorar ou tratar como uma atualização de um único item. Além disso, o gatilho possui um mecanismo interno de debounce que espera alguns segundos após a última alteração antes de disparar. Durante uma importação rápida, o período de debounce pode expirar antes que todos os itens sejam criados, fazendo com que o gatilho perca itens posteriores. Isso não é um bug — é uma limitação de design do modelo de eventos do gatilho.

Como o Modelo de Eventos do Gatilho Funciona

O gatilho Quando um item é criado ou modificado usa o log de alterações do SharePoint. Quando você adiciona itens um de cada vez pela interface do SharePoint, cada adição escreve uma entrada separada no log de alterações. O gatilho captura cada entrada e executa o fluxo. Mas importações em massa geralmente escrevem uma única entrada no log de alterações para todo o lote. O gatilho vê apenas um evento de criação e dispara uma vez. Se o seu fluxo depende do processamento de cada item individualmente, os itens restantes nunca são processados.

O Papel do Versionamento e Aprovação

As configurações de versionamento do SharePoint também afetam o comportamento do gatilho. Se sua lista tiver Exigir aprovação de conteúdo ativado, os itens importados em massa são criados em estado de Rascunho. Um segundo evento — aprovação — é necessário para movê-los para Publicado. O gatilho pode capturar esse segundo evento se configurado corretamente. Sem aprovação, os itens importados podem permanecer como Rascunho e nunca acionar o fluxo. Para listas sem aprovação, o evento de criação em massa é o único evento, e o gatilho pode perdê-lo.

Passos para Verificar as Configurações do Gatilho e Corrigir Itens Ausentes

Siga estes passos para verificar a configuração do seu gatilho e ajustá-la para capturar itens importados em massa.

1. Abra seu fluxo do Power Automate no modo de edição
   Vá para Power Automate, selecione Meus fluxos e clique no fluxo que usa o gatilho de lista do SharePoint. Clique no botão Editar no topo da página.
2. Verifique o tipo de gatilho
   Clique na etapa do gatilho chamada Quando um item é criado ou modificado. Verifique se o gatilho está definido como SharePoint e se o endereço do site e o nome da lista estão corretos. Se o gatilho usar um conector diferente, como Quando um arquivo é criado, ele não funcionará para itens de lista.
3. Adicione uma condição de gatilho para filtrar pelo campo Modified
   Nas configurações do gatilho, clique nas reticências (…) e selecione Configurações. Em Condições de gatilho, adicione esta expressão: @equals(triggerOutputs()?['body/Modified'], triggerOutputs()?['body/Created']). Essa condição garante que o fluxo seja executado apenas quando a data de Modificado do item for igual à data de Criado — o que é verdadeiro para o primeiro evento de criação. Para importações em massa, o gatilho pode disparar uma vez com Modified e Created correspondentes. Essa condição ajuda a capturar esse único evento.
4. Ative a aprovação de conteúdo na lista do SharePoint
   Vá para a lista do SharePoint, clique no ícone de engrenagem e selecione Configurações da lista. Em Configurações de versão, defina Exigir aprovação de conteúdo como Sim. Defina Quem pode ver itens como Itens de rascunho se necessário. Após importar itens em massa, cada item ficará como Rascunho. Você ou um fluxo pode então aprová-los, acionando um segundo evento que o fluxo pode capturar.
5. Teste o fluxo com uma criação manual única
   Adicione um item manualmente pela interface da lista do SharePoint. Confirme que o fluxo é executado para esse item. Se funcionar, o gatilho está funcionando. O problema é específico para importações em massa. Se o fluxo não for executado para um único item, verifique a conexão do gatilho e as permissões.
6. Realize uma importação em massa usando Edição Rápida
   Abra a lista do SharePoint, clique em Edição Rápida (a visualização de grade) e cole seus dados do Excel. Esse método cria itens um de cada vez, gerando entradas individuais no log de alterações. O gatilho deve capturar cada item. Após colar, clique em Concluído para salvar.

Se o Gatilho Ainda Perder Itens Após a Correção Principal

Mesmo após aplicar os passos acima, você pode encontrar situações em que itens importados em massa ainda são perdidos. Aqui estão os cenários mais comuns e suas soluções.

“Meu fluxo é executado apenas uma vez para toda a importação”

Isso confirma o problema do evento em lote. O gatilho dispara uma vez, e o fluxo processa apenas o primeiro item do lote. Para corrigir, reestruture seu fluxo para usar um loop Aplicar a cada que leia de uma fonte de dados separada, como um arquivo CSV armazenado no SharePoint ou uma lista temporária. Alternativamente, use o gatilho Quando um arquivo é criado ou modificado para um arquivo CSV, depois analise o arquivo e crie itens da lista dentro do fluxo. Isso contorna completamente o gatilho da lista.

“Os itens aparecem na lista, mas o fluxo nunca é executado”

Verifique o histórico de execução do Power Automate. Vá para Meus fluxos, selecione o fluxo e clique em Histórico de execução. Procure por execuções com falha. Se não houver nenhuma execução, o gatilho não disparou. Isso confirma que o evento em lote foi perdido. Aplique a condição de gatilho do Passo 3 e reimporte os itens. Se o problema persistir, mude para Edição Rápida na importação.

“O fluxo é executado, mas alguns itens são pulados”

Isso pode acontecer quando o gatilho dispara para os primeiros itens, mas o período de debounce expira antes que todos os itens sejam criados. A solução é aumentar o Intervalo de sondagem do gatilho nas configurações do gatilho. Defina para 5 ou 10 minutos. Isso dá tempo ao SharePoint para concluir o lote e escrever uma única entrada no log de alterações. Lembre-se de que um intervalo maior significa processamento mais lento para novos itens.

Gatilho do Power Automate vs. Receptor de Eventos do SharePoint: Principais Diferenças

Item	Gatilho do Power Automate	Receptor de Eventos do SharePoint
Como escuta	Sonda o log de alterações periodicamente	Executa de forma síncrona no servidor quando um item muda
Manipulação de importação em massa	Pode perder eventos em lote devido ao debounce	Executa para cada item no lote
Esforço de configuração	Configuração sem código no Power Automate	Requer código personalizado (C# ou PowerShell)
Flexibilidade de condição de gatilho	Limitada a expressões nas saídas do gatilho	Controle total via código do receptor de eventos

Os receptores de eventos do SharePoint são mais confiáveis para importações em massa, mas exigem habilidades de desenvolvimento e implantação no servidor. Para a maioria dos administradores de site, ajustar as configurações do gatilho do Power Automate e usar Edição Rápida para importações é a correção prática.

Agora você sabe por que o gatilho de lista do SharePoint ignora itens importados em massa e quais configurações ajustar. Comece ativando a aprovação de conteúdo e adicionando a condição Modified igual a Created ao seu gatilho. Para importações futuras, use Edição Rápida em vez do assistente CSV para gerar eventos de criação individuais. Se precisar de confiabilidade absoluta para grandes importações, considere criar um fluxo que leia de um arquivo CSV e crie itens um de cada vez dentro da lógica do fluxo.