Registrar Alterações de Lista do SharePoint em Outra Lista: Checklist Prático para Proprietários

Proprietários de listas do SharePoint frequentemente precisam rastrear quem alterou o quê e quando em uma lista. O histórico de versões interno armazena esses dados, mas não facilita a revisão de alterações em vários itens ou o envio de alertas para edições específicas. Você pode querer registrar todas as alterações em uma lista separada para executar relatórios ou configurar fluxos do Power Automate na trilha de auditoria. Este artigo explica como usar o Power Automate para registrar automaticamente alterações de lista em outra lista e fornece um checklist prático para configurar o sistema corretamente.

Como o Sistema de Registro de Alterações Funciona

O SharePoint não possui um recurso nativo que registre alterações de lista em uma lista separada automaticamente. O histórico de versões de cada item registra as alterações, mas você não pode consultar o histórico de versões em vários itens em uma única exibição nem acionar fluxos de trabalho com base em alterações de campo específicas. O Power Automate resolve essa limitação monitorando a lista de origem e gravando um registro em uma lista de destino de auditoria sempre que um item é criado ou modificado.

O gatilho principal é o Quando um item é criado ou modificado no Power Automate. Após o gatilho disparar, você precisa usar a ação Obter alterações de um item ou arquivo (somente propriedades) para identificar qual campo foi alterado e capturar os valores antigo e novo. Essa ação retorna um objeto JSON que lista todas as propriedades alteradas. Em seguida, você analisa esse JSON e grava os dados relevantes na lista de auditoria.

Antes de criar o fluxo, você deve criar a lista de destino de auditoria. Essa lista precisa de colunas para armazenar cada informação de auditoria. Uma lista de auditoria típica inclui as seguintes colunas:

• ItemID (Número) – o ID do item na lista de origem
• ChangeType (Escolha) – valores: Criado, Modificado
• ChangedField (Linha de texto única) – o nome de exibição do campo que foi alterado
• OldValue (Várias linhas de texto) – o valor anterior
• NewValue (Várias linhas de texto) – o valor atual
• ChangedBy (Linha de texto única) – o usuário que fez a alteração
• Timestamp (Data e Hora) – quando a alteração ocorreu

Passos para Configurar o Fluxo de Registro de Alterações

1. Crie a lista de auditoria
   Acesse o site do SharePoint onde deseja armazenar o log de auditoria. Crie uma nova lista personalizada chamada AuditLog. Adicione as colunas listadas acima. Defina ItemID como número, ChangeType como escolha com Criado e Modificado, e o restante conforme especificado.
2. Abra o Power Automate e crie um fluxo automatizado
   Acesse make.powerautomate.com. Selecione Criar e depois Fluxo de nuvem automatizado. Dê ao fluxo um nome como Registrar Alterações de Lista na Auditoria.
3. Adicione o gatilho do SharePoint
   Pesquise pelo conector do SharePoint e selecione o gatilho Quando um item é criado ou modificado. Forneça o endereço do site e o nome da lista de origem que deseja monitorar.
4. Inicialize uma variável para armazenar os dados de alteração
   Adicione uma ação Inicializar variável. Nomeie como ChangesJSON, defina Tipo como String e deixe Valor vazio. Essa variável armazenará o JSON bruto da ação de obter alterações.
5. Obtenha as alterações do item
   Adicione a ação do SharePoint Obter alterações de um item ou arquivo (somente propriedades). Forneça o endereço do site e o nome da lista. No campo Id, selecione ID na lista de conteúdo dinâmico. Defina Desde como @addHours(utcNow(), -24) para capturar alterações nas últimas 24 horas. Defina ItemDeleted como Não.
6. Analise a resposta JSON
   Adicione uma ação Analisar JSON. No campo Conteúdo, selecione a saída Valor da ação Obter alterações. Use o seguinte esquema para analisar a matriz de alterações:

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "PropertyName": {"type": "string"},
               "OldValue": {"type": "string"},
               "NewValue": {"type": "string"}
           },
           "required": ["PropertyName"]
       }
   }

7. Aplique a cada alteração
   Adicione uma ação Aplicar a cada. No campo Selecionar uma saída das etapas anteriores, selecione a saída Corpo da ação Analisar JSON. Dentro do loop, adicione uma ação Criar item para o conector do SharePoint. Aponte para o site e o nome da lista de auditoria.
8. Mapeie as colunas de auditoria
   Na ação Criar item, mapeie o conteúdo dinâmico da seguinte forma:
   • Título – deixe em branco ou use uma concatenação de ChangeType e ItemID
   • ItemID – selecione ID das saídas do gatilho
   • ChangeType – use uma condição: se a saída do gatilho Modificado for igual ao item atual, use Modificado; caso contrário, use Criado
   • ChangedField – selecione PropertyName da saída do Analisar JSON
   • OldValue – selecione OldValue da saída do Analisar JSON
   • NewValue – selecione NewValue da saída do Analisar JSON
   • ChangedBy – selecione Modificado Por Nome de Exibição das saídas do gatilho
   • Timestamp – selecione Modificado das saídas do gatilho
9. Salve e teste o fluxo
   Salve o fluxo. Adicione ou modifique um item na lista de origem. Aguarde alguns minutos e verifique a lista AuditLog para uma nova entrada. Se nenhuma entrada aparecer, revise o histórico de execução do fluxo acessando a página de detalhes do fluxo e selecionando a execução com falha.

Problemas Comuns ao Registrar Alterações de Lista

Fluxo Não Dispara para Edições em Massa

O gatilho Quando um item é criado ou modificado dispara uma vez por item, não uma vez por alteração. Quando você edita vários itens de uma vez usando Edição Rápida ou um formulário do Power Apps, o fluxo pode perder algumas atualizações. Para capturar todas as alterações, garanta que o fluxo seja executado para cada item individualmente. Se você usar edição em massa, considere usar um fluxo agendado que verifique alterações periodicamente em vez de depender do gatilho em tempo real.

Ação Obter Alterações Retorna Sem Dados

A ação Obter alterações de um item ou arquivo (somente propriedades) requer que o parâmetro Desde seja configurado corretamente. Se você defini-lo para um horário anterior à criação do item, pode retornar todas as propriedades. Se defini-lo para um horário muito distante no passado, a ação pode expirar. Defina Desde como @addHours(utcNow(), -24) para capturar alterações nas últimas 24 horas. Para itens novos, a ação retorna todas as propriedades como alterações.

Lista de Auditoria Cresce Muito Rápido

Se sua lista de origem for grande ou frequentemente editada, a lista de auditoria pode acumular milhares de linhas rapidamente. Para gerenciar o crescimento, adicione um fluxo de limpeza que exclua registros com mais de 90 dias. Como alternativa, use uma política de retenção nas configurações da lista do SharePoint para excluir itens automaticamente após um período definido.

Gatilho do Power Automate vs. Log de Alterações do SharePoint: Principais Diferenças

Item	Fluxo do Power Automate	Histórico de Versões do SharePoint
Local de armazenamento	Lista de auditoria separada que você controla	Armazenado por item na mesma lista
Consulta entre itens	Sim – veja todas as alterações em uma lista	Não – é necessário abrir cada item individualmente
Detalhamento por campo	Captura valores antigos e novos por campo	Mostra diferenças de versão por campo
Gatilho de automação	Pode iniciar outros fluxos ou enviar e-mails	Nenhum gatilho interno na criação de versão
Controle de retenção	Limpeza manual ou baseada em fluxo	Defina limite de contagem de versões nas configurações da lista

Agora você pode configurar um fluxo do Power Automate para registrar cada alteração de uma lista do SharePoint em uma lista de auditoria dedicada. Isso oferece uma visão única de todas as edições entre itens e permite criar relatórios ou alertas sobre os dados de auditoria. Comece criando a lista de auditoria com as colunas necessárias e, em seguida, crie o fluxo usando o gatilho e a ação Obter alterações. Para listas grandes, adicione um fluxo de limpeza agendado para manter a lista de auditoria gerenciável. Teste o fluxo com um único item antes de ativá-lo em uma lista de produção.