Exemplo: Auditar alterações de dados da tabela

Este exemplo mostra como habilitar e desabilitar a auditoria em uma tabela e suas colunas, recuperar o histórico de alterações de dados da tabela auditada e excluir os registros de auditoria. Você pode exibir o exemplo aqui.

Como executar este exemplo

1. Baixe ou clone o repositório Microsoft/PowerApps-Samples para que você tenha uma cópia local.
2. (Opcional) Edite o arquivo dataverse/App.config para definir um cadeia de conexão especificando a instância de Microsoft Dataverse à qual você deseja se conectar.
3. Abra a solução de exemplo no Visual Studio e pressione F5 para executar o exemplo. Depois de especificar um cadeia de conexão em dataverse/App.config, qualquer exemplo executado usará essas informações de conexão.

Se você não especificar um cadeia de conexão no arquivo dataverse/App.config, uma caixa de diálogo será aberta sempre que você executar o exemplo e você precisar inserir informações sobre a instância do Dataverse à qual deseja se conectar e a quais credenciais deseja usar. Essa caixa de diálogo armazena em cache conexões anteriores para que você possa escolher uma conexão usada anteriormente.

Esses exemplos neste repositório que exigem uma conexão com uma instância do Dataverse para execução incluem uma referência vinculada ao dataverse/App.config arquivo.

O que este exemplo faz

Este exemplo faz o seguinte:

1. Habilite a auditoria para a organização e a tabela da conta se ainda não estiver habilitada.
2. Crie um registro de conta.
3. Use a RetrieveRecordChangeHistory mensagem por meio da Classe RetrieveRecordChangeHistoryRequest para recuperar o histórico do registro de conta criado na etapa 2.
4. Exiba algumas das informações de detalhes em cada registro de auditoria.
5. Atualize o registro da conta, atualizando uma coluna específica.
6. Recupere o histórico de alterações da coluna alterada usando a RetrieveAttributeChangeHistory mensagem com a classe RetrieveAttributeChangeHistoryRequest.
7. Exiba o histórico de alterações de atributo.
8. Utilize a RetrieveAuditDetails mensagem por meio da Classe RetrieveAuditDetailsRequest para exibir alguns dos detalhes da auditoria.
9. Restabeleça a auditoria ambiental ao estado original e exclua a conta criada.

Como este exemplo funciona

Para simular o cenário descrito no que este exemplo faz, o exemplo fará o seguinte:

Configuração

1. Verifica a versão atual da organização.
2. Habilita a auditoria na organização e na tabela de contas, se necessário.
3. Cria um registro de conta de exemplo.

Demonstrar

Uso das mensagens RetrieveRecordChangeHistory, RetrieveAttributeChangeHistory e RetrieveAuditDetails para mostrar os tipos de dados disponíveis por meio dessas APIs de auditoria.

Limpeza

Exiba uma opção para excluir os dados de exemplo criados na Instalação. A exclusão é opcional caso você queira examinar as tabelas e os dados criados pelo exemplo. Você pode excluir manualmente os registros para obter o mesmo resultado.