Interceptadores

Interceptores permitem que você execute lógica personalizada do lado do servidor antes e depois das operações do Dataverse. Ao implementar a ITableRecordInterceptor interface, você pode se conectar ao ciclo de vida da criação de registros, atualizações, exclusões, associações e dissociações.

Visão geral

Casos de uso comuns para interceptadores incluem:

• Definir valores padrão de campo antes de um registro ser criado (por exemplo, atribuir um proprietário)
• Validação ou transformação de dados antes que sejam persistidos
• Aplicando regras de negócios que vão além da validação em nível de campo
• Registro de auditoria após a criação, atualização ou exclusão de registros
• Efeitos colaterais desencadeadores, como enviar notificações ou atualizar registros relacionados

Nota

Interceptadores rodam no servidor e se aplicam a todas as operações de todas as tabelas. Use a TableRecord.TableName propriedade para filtrar a lógica para tabelas específicas.

Começando

1. Criar um Interceptor

Crie uma classe que implemente ITableRecordInterceptor e forneça implementações para cada método. Devolva Task.CompletedTask qualquer gancho, que não precisar.

2. Registro na Injeção de Dependência

Registre seu interceptador no contêiner DI no arquivo do Program.cs seu projeto:

Como interceptores são resolvidos a partir do contêiner DI, você pode injetar quaisquer serviços necessários por meio da injeção do construtor.

Ganchos do Ciclo de Vida

A interface fornece ganchos antes e depois para cinco tipos de operações:

Criar

OnBeforeCreateAsync e OnAfterCreateAsync correr por aí na criação de novos discos. O gancho antes é ideal para definir valores padrão ou validar campos exigidos.

Atualização

OnBeforeUpdateAsync e OnAfterUpdateAsync correr ao redor de atualizações de registro. Use o gancho antes para impor regras de negócio ou modificar valores antes que sejam mantidos.

Excluir

OnBeforeDeleteAsynce OnAfterDeleteAsync contornar a exclusão de registros. Note que esses ganchos recebem um TableRecordReference (nome da tabela e ID) em vez de um .TableRecord

Associado e Dissociado

OnBeforeAssociateAsync / OnAfterAssociateAsync e OnBeforeDisassociateAsync / OnAfterDisassociateAsync funcionam quando relacionamentos muitos-para-muitos são criados ou removidos.

Serviços de Injeção

Como interceptores são registrados no contêiner DI, você pode injetar serviços via injeção de construtor. Isso é útil para acessar estados de autenticação, registro ou outros serviços de aplicação.

Referência API