Intercepteurs

Les intercepteurs permettent d’exécuter une logique côté serveur personnalisée avant et après les opérations Dataverse. En implémentant l’interface ITableRecordInterceptor , vous pouvez vous connecter au cycle de vie de la création d’enregistrements, des mises à jour, suppressions, associations et dissociations.

Aperçu

Les cas d’usage courants des intercepteurs incluent :

• Définir les valeurs de champ par défaut avant la création d’un enregistrement (par exemple, assigner un propriétaire)
• Valider ou transformer les données avant qu’elles ne soient conservées
• Appliquer des règles métier qui vont au-delà de la validation au niveau du terrain
• Audit de la journalisation après la création, la mise à jour ou la suppression des enregistrements
• Effets secondaires déclencheurs tels que l’envoi de notifications ou la mise à jour des dossiers connexes

Note

Les intercepteurs s’exécutent sur le serveur et s’appliquent à toutes les opérations de toutes les tables. Utilisez cette TableRecord.TableName propriété pour filtrer la logique vers des tables spécifiques.

Commencer

1. Créer un intercepteur

Créez une classe qui implémente ITableRecordInterceptor et fournit des implémentations pour chaque méthode. Retournez Task.CompletedTask pour les crochets dont vous n’avez pas besoin.

2. Enregistrer dans l’injection de dépendance

Enregistrez votre intercepteur dans le conteneur DI du fichier de Program.cs votre projet :

Puisque les intercepteurs sont résolus à partir du conteneur DI, vous pouvez injecter tous les services nécessaires via l’injection du constructeur.

Crochets du cycle de vie

L’interface fournit des crochets avant et après pour cinq types d’opérations :

Créer

OnBeforeCreateAsync et OnAfterCreateAsync de créer de nouveaux disques en partant. Le crochet avant est idéal pour définir les valeurs par défaut ou valider les champs requis.

Mise à jour

OnBeforeUpdateAsync et OnAfterUpdateAsync faire des enregistrements de mises à jour en contournement. Utilisez le crochet avant pour faire respecter les règles métier ou modifier les valeurs avant qu’elles ne soient maintenues.

Supprimer

OnBeforeDeleteAsync et OnAfterDeleteAsync contourner la suppression des enregistrements. Notez que ces crochets reçoivent un TableRecordReference (nom de table et ID) plutôt qu’un fichier complet TableRecord.

Associé et Dissociation

OnBeforeAssociateAsync / OnAfterAssociateAsync et OnBeforeDisassociateAsync / OnAfterDisassociateAsync fonctionnent lorsque des relations de plusieurs-à-plusieurs sont créées ou supprimées.

Services d’injection

Comme les intercepteurs sont enregistrés dans le conteneur DI, vous pouvez injecter des services via injection de constructeur. Cela est utile pour accéder à l’état d’authentification, la journalisation ou d’autres services applicatifs.

Référence API