Exemple : auditer les modifications des données de table

Cet exemple montre comment activer et désactiver l’audit sur une table et ses colonnes, récupérer l’historique des modifications apportées aux données de la table auditée, puis supprimer les enregistrements d’audit. Vous pouvez afficher l’exemple ici.

Comment exécuter cet exemple

1. Téléchargez ou clonez le dépôt Microsoft/PowerApps-Samples afin d’avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une connection string en spécifiant l’instance de Microsoft Dataverse à laquelle vous souhaitez vous connecter.
3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une connection string dans dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de connection string dans dataverse/App.config fichier, une boîte de dialogue s'ouvre chaque fois que vous exécutez l'exemple et que vous devez entrer des informations sur l'instance Dataverse à laquelle vous souhaitez vous connecter et les informations d'identification à utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

Ces exemples de ce référentiel qui nécessitent une connexion à une instance Dataverse pour s’exécuter incluent une référence liée au dataverse/App.config fichier.

En quoi consiste cet exemple

Cet exemple effectue ce qui suit :

1. Activez l’audit pour l’organisation et le tableau des comptes s’il n’est pas déjà activé.
2. Créez un enregistrement de compte.
3. Utilisez le message RetrieveRecordChangeHistory via la RetrieveRecordChangeHistoryRequest Class pour récupérer l’historique de l’enregistrement de compte créé à l’étape 2.
4. Affichez certaines informations détaillées dans chaque enregistrement d’audit.
5. Mettez à jour l’enregistrement du compte, en mettant à jour une colonne spécifique.
6. Récupérez l’historique des modifications de la colonne modifiée à l’aide du message RetrieveAttributeChangeHistory avec la RetrieveAttributeChangeHistoryRequest Class.
7. Affichez l’historique des modifications d’attributs.
8. Utilisez le message RetrieveAuditDetails via la RetrieveAuditDetailsRequest Class pour afficher certains des détails de l’audit.
9. Remettez l’audit environnemental à son état d’origine et supprimez le compte créé ainsi que son enregistrement.

Comment cet échantillon fonctionne

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l′exemple procède comme suit :

Configuration

1. Vérifie la version actuelle de l′organisation.
2. Permet l’audit pour l’organisation et la table de comptes si nécessaire.
3. Crée un enregistrement de compte d'exemple.

Démontrer

Utilisez les messages RetrieveRecordChangeHistory, RetrieveAttributeChangeHistory et RetrieveAuditDetails pour afficher les types de données disponibles via ces API d’audit.

Nettoyer

Présentez une option pour supprimer l’exemple de données créé dans Installation. La suppression est facultative au cas où vous souhaiteriez examiner les tables et les données créées par l’échantillon. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.