Interceptores

Los interceptores permiten ejecutar lógica personalizada del lado del servidor antes y después de las operaciones de Dataverse. Al implementar la ITableRecordInterceptor interfaz, puedes conectarte al ciclo de vida de la creación de registros, actualizaciones, eliminaciones, asociaciones y disociaciones.

Resumen

Los casos de uso comunes de los interceptores incluyen:

• Establecer valores predeterminados de campo antes de que se cree un registro (por ejemplo, un estado inicial o un nombre de visualización derivado de otro campo)
• Validar o transformar datos antes de que se conserven
• Hacer cumplir reglas de negocio que van más allá de la validación a nivel de campo
• Registro de auditoría después de crear, actualizar o eliminar registros
• Efectos secundarios desencadenantes como enviar notificaciones o actualizar registros relacionados

Nota

Los interceptores se ejecutan en el servidor y se aplican a todas las operaciones de todas las tablas. Usa la TableRecord.TableName propiedad para filtrar la lógica a tablas específicas.

Nota

Para registrar quién creó una fila, no se establece la columna propietaria en un interceptor — descríbela en el acceso de la tabla con OwnedBy o RowsOwnedByContact en su lugar (ver Seguridad de la Tabla). El framework entonces establece la columna después de las comprobaciones de permisos, desde el usuario iniciado sesión en lugar de desde la solicitud, y rechaza una actualización posterior que entregaría la fila a otra persona. Un gancho antes se ejecuta antes de las comprobaciones de permisos, por lo que un valor que establece se juzga como si el usuario lo hubiera enviado, y nada impide que una actualización posterior lo cambie.

Empezando

1. Crear un interceptor

Crea una clase que implemente ITableRecordInterceptor y proporcione implementaciones para cada método. Devuélvelo Task.CompletedTask por cualquier ganchos que no necesites.

2. Registrar en la inyección de dependencias

Registra tu interceptor en el contenedor DI del archivo de Program.cs tu proyecto:

Dado que los interceptores se resuelven desde el contenedor DI, puedes inyectar cualquier servicio necesario mediante inyección de constructores.

Ganchos del ciclo de vida

La interfaz proporciona ganchos antes y después para cinco tipos de operaciones:

Crear

OnBeforeCreateAsync y OnAfterCreateAsync correr por la creación de nuevos discos. El gancho antes es ideal para establecer valores predeterminados o validar campos requeridos.

Actualización

OnBeforeUpdateAsync y OnAfterUpdateAsync que se corran para registrar actualizaciones. Utiliza el gancho antes para hacer cumplir reglas de negocio o modificar valores antes de que se mantengan.

Borrar

OnBeforeDeleteAsync y OnAfterDeleteAsync evitar la eliminación de registros. Cabe señalar que estos ganchos reciben un TableRecordReference (nombre de tabla e ID) en lugar de un archivo completo TableRecord.

Asociado y Disociado

OnBeforeAssociateAsync / OnAfterAssociateAsync y OnBeforeDisassociateAsync / OnAfterDisassociateAsync se ejecutan cuando se crean o eliminan relaciones de muchos-a-muchos.

Servicios de inyección

Como los interceptores están registrados en el contenedor DI, puedes inyectar servicios mediante inyección de constructores. Esto es útil para acceder al estado de autenticación, registro u otros servicios de aplicación.

Referencia API