Quando você gerencia uma lista crítica do SharePoint, precisa saber quem alterou o quê e quando. Rastrear edições manualmente é propenso a erros e consome tempo. O SharePoint não registra alterações de lista em outra lista por padrão, mas você pode criar uma trilha de auditoria confiável usando o Power Automate. Este artigo explica as melhores configurações para registrar alterações de lista do SharePoint em outra lista, abordando triggers, ações e opções de configuração essenciais.
Principais conclusões: Registro de alterações de lista com Power Automate
- Trigger do Power Automate “Quando um item é criado ou modificado”: Inicia o fluxo quando um item existente é editado ou um novo item é adicionado à lista de origem.
- Ação “Obter alterações de um item ou arquivo (somente propriedades)”: Recupera apenas as colunas alteradas, reduzindo o tamanho do log e melhorando o desempenho em comparação com buscar todas as colunas.
- Ação “Criar item” na lista de auditoria: Grava os detalhes da alteração em uma lista de destino separada para rastreamento de longo prazo.
Como funciona o recurso de registro de alterações do SharePoint
O SharePoint não oferece uma configuração nativa para copiar automaticamente as alterações de lista para outra lista. O histórico de versões nativo armazena todas as alterações dentro da mesma lista, mas não as envia para um segundo local. Para registrar alterações em uma lista separada, você deve usar o Power Automate, um serviço de fluxo de trabalho do Microsoft 365 que conecta o SharePoint a centenas de outros sistemas.
O mecanismo central é um fluxo do Power Automate que é acionado sempre que um item na lista de origem é criado ou modificado. O fluxo então captura os dados alterados e grava uma nova entrada em uma lista de auditoria dedicada. Essa lista de auditoria pode manter um registro permanente de quem alterou o quê e quando, mesmo após o item de origem ser excluído.
Pré-requisitos para configurar o fluxo de registro
Antes de criar o fluxo, você precisa do seguinte:
- Um site do SharePoint onde você tenha pelo menos permissões de Edição na lista de origem e na lista de auditoria.
- Uma lista de origem que contenha os dados que você deseja rastrear. Pode ser uma lista personalizada, uma biblioteca de documentos ou qualquer lista padrão do SharePoint.
- Uma lista de auditoria que receberá os registros de alteração. Essa lista deve ter colunas para o nome do campo alterado, valor antigo, valor novo, tipo de alteração, timestamp e o usuário que fez a alteração.
- Acesso ao Power Automate a partir do inicializador de aplicativos do Microsoft 365 ou diretamente em make.powerautomate.com.
Passos para configurar o fluxo de registro de alterações
- Crie a lista de destino de auditoria
No seu site do SharePoint, crie uma nova lista personalizada chamada “Log de Alterações” ou “Log de Auditoria”. Adicione estas colunas: Título (linha de texto simples), CampoAlterado (linha de texto simples), ValorAntigo (várias linhas de texto), ValorNovo (várias linhas de texto), TipoAlteração (escolha: Criado, Modificado, Excluído), AlteradoPor (pessoa ou grupo) e HoraAlteração (data e hora). Essas colunas armazenarão os detalhes de cada alteração. - Abra o Power Automate e crie um fluxo automatizado
Acesse make.powerautomate.com, faça login com sua conta corporativa do Microsoft 365. Selecione Criar no menu à esquerda e escolha Fluxo automatizado em nuvem. Dê um nome ao fluxo, como “Registrar alterações de lista no log de auditoria”. - Adicione o trigger: Quando um item é criado ou modificado
Pesquise pelo conector do SharePoint e selecione o trigger “Quando um item é criado ou modificado”. Forneça o endereço do site e o nome da lista de origem que você deseja monitorar. Defina a condição do trigger para executar para todas as alterações, não apenas para novos itens. - Adicione uma ação para obter as propriedades alteradas
Pesquise pelo conector do SharePoint e selecione a ação “Obter alterações de um item ou arquivo (somente propriedades)”. Defina o endereço do site e o nome da lista para a mesma lista de origem. Para o ID do item, selecione o conteúdo dinâmico ID do trigger. Esta ação retorna apenas as colunas que realmente foram alteradas, mantendo seu log de auditoria limpo e eficiente. - Adicione uma condição para lidar com novos itens vs. modificações
Insira uma ação Condição. No lado esquerdo, selecione o conteúdo dinâmico “Saídas do Trigger” e depois “É novo item”. Defina o operador como “é igual a” e o valor como “true”. Isso separa a lógica para novos itens e itens modificados. - Configure o ramo “Se sim” para novos itens
Dentro do ramo “Se sim”, adicione uma ação Compor. Defina a entrada como o conteúdo dinâmico “Hora de criação” do trigger. Isso captura o timestamp. Em seguida, adicione uma ação Criar item direcionada à sua lista de auditoria. Mapeie as colunas: Título = conteúdo dinâmico “Título”, CampoAlterado = “Todos os campos”, ValorAntigo = “N/A”, ValorNovo = conteúdo dinâmico “Título” (ou outros campos relevantes), TipoAlteração = “Criado”, AlteradoPor = conteúdo dinâmico “Modificado por”, HoraAlteração = saída da etapa Compor. - Configure o ramo “Se não” para itens modificados
Dentro do ramo “Se não”, adicione um loop Aplicar a cada. Na entrada, selecione o conteúdo dinâmico “Propriedades Alteradas” da ação Obter alterações. Dentro do loop, adicione uma ação Criar item para a lista de auditoria. Mapeie as colunas: Título = conteúdo dinâmico “Título” do trigger, CampoAlterado = conteúdo dinâmico “Nome de exibição” do loop, ValorAntigo = conteúdo dinâmico “Valor antigo” do loop, ValorNovo = conteúdo dinâmico “Valor novo” do loop, TipoAlteração = “Modificado”, AlteradoPor = conteúdo dinâmico “Modificado por” do trigger, HoraAlteração = conteúdo dinâmico “Hora da modificação” do trigger. - Salve e teste o fluxo
Clique em Salvar e depois em Testar. Escolha Manualmente e depois Testar. Crie um novo item na lista de origem e edite um item existente. Após alguns segundos, verifique a lista de auditoria para ver as entradas registradas. Confirme se as colunas CampoAlterado, ValorAntigo, ValorNovo e outras estão preenchidas corretamente.
Erros comuns e considerações de desempenho
O fluxo registra todas as colunas em vez de apenas as colunas alteradas
Se você usar a ação padrão “Obter item” em vez de “Obter alterações de um item ou arquivo (somente propriedades)”, o fluxo recuperará todos os valores de coluna, mesmo que nada tenha mudado. Isso cria um log muito grande e diminui o fluxo. Sempre use a ação dedicada Obter alterações para capturar apenas as colunas modificadas.
A lista de auditoria cresce demais e fica lenta
Uma lista de auditoria que registra todas as alterações por anos pode exceder 5.000 itens e acionar a limitação de exibição de lista. Para evitar isso, adicione um fluxo de limpeza agendado que exclua registros com mais de 90 dias ou crie uma política de retenção no portal de conformidade do Microsoft Purview para excluir automaticamente entradas antigas.
O fluxo falha quando o item de origem é excluído
O trigger padrão do SharePoint não é acionado quando um item é excluído. Para capturar exclusões, você precisa de um fluxo separado que use o trigger “Quando um item é excluído”. Esse fluxo deve ler o ID do item do trigger e gravar um registro de exclusão na lista de auditoria com o TipoAlteração definido como “Excluído”.
Fluxo do Power Automate vs. Histórico de versões nativo do SharePoint
| Item | Log de Alterações do Power Automate | Histórico de Versões do SharePoint |
|---|---|---|
| Local de armazenamento | Lista de auditoria separada | Dentro da mesma lista |
| Sobrevive à exclusão do item | Sim, se a exclusão for registrada separadamente | Não, o histórico de versões é excluído com o item |
| Colunas personalizáveis | Totalmente personalizável | Colunas fixas (número da versão, data, editor) |
| Impacto no desempenho | Mínimo se usar a ação Obter alterações | Sem carga adicional |
| Requer licenciamento | Licença do Power Automate (incluída em muitos planos M365) | Nenhuma licença extra necessária |
Agora você pode configurar um fluxo do Power Automate para registrar alterações de lista do SharePoint em outra lista. Use a ação Obter alterações para capturar apenas colunas modificadas e manter sua lista de auditoria gerenciável. Adicione um fluxo separado para itens excluídos para manter um registro completo. Para arquivamento de longo prazo, defina uma política de retenção no portal de conformidade do Microsoft Purview para excluir automaticamente entradas antigas após 90 dias.