Dataverse plug-in
Concept
Código personalizado do lado do servidor registrado no pipeline de eventos do Dataverse, executado quando ocorrem operações de dados, usado no Dynamics 365 para validação transacional e cálculos.
Também abordados
Os episódios sobre Dataverse plug-in abordam também Saga pattern, Transactional outbox pattern, Database normalization, Dataverse business skills, Dataverse business units e PSDataverse.
Descrição
Um plug-in do Dataverse é um manipulador de eventos personalizado que responde a um evento específico durante o processamento de uma operação de dados no Microsoft Dataverse. Ele é escrito como uma classe em um assembly do .NET Framework, e esse assembly é então registrado no Dataverse. Um único assembly pode conter várias classes, cada uma registrada em uma etapa diferente do framework de eventos. No Dynamics 365, os plug-ins são usados para lógica do lado do servidor, como validação transacional e cálculos que precisam ser executados quando os dados são criados, atualizados ou processados de alguma outra forma.
Cada classe de plug-in implementa a interface IPlugin, que define um único método Execute. Quando o evento registrado ocorre, o Dataverse chama esse método e passa dados de contexto sobre a operação que está sendo processada. A partir daí, o código pode cancelar a operação em execução no pipeline, alterar os dados de negócio que estão sendo processados, chamar outras operações de dados, se comunicar com sistemas externos ou repassar informações para plug-ins posteriores no mesmo pipeline. Os plug-ins podem ser executados de forma síncrona, caso em que a operação aguarda sua conclusão, ou de forma assíncrona, após a conclusão da operação.
A escolha entre esses modos importa na prática. A lógica que precisa impedir que dados incorretos sejam salvos pertence à parte síncrona do pipeline, enquanto o trabalho que pode acontecer após o salvamento pode ser executado de forma assíncrona. A Microsoft Learn observa que os plug-ins síncronos precisam ser executados rapidamente e que a execução está sujeita a um limite de tempo rígido. Código mal escrito também pode prejudicar o desempenho, e a criação de plug-ins exige habilidades de desenvolvedor, por isso eles têm um custo que as opções declarativas não têm.
Por causa dessas desvantagens, a documentação da Microsoft recomenda verificar primeiro as opções declarativas. As alternativas listadas incluem ações personalizadas, colunas calculadas e de rollup, webhooks e Power Automate. Um plug-in se torna a ferramenta adequada quando essas opções não atendem ao requisito, por exemplo quando a lógica precisa ser aplicada dentro da própria transação.
O episódio do M365.FM "Customize Dataverse for Complex Business Apps" coloca o plug-in do Dataverse dentro de uma matriz de decisão para regras de negócio. De acordo com o episódio, as perguntas seguem aproximadamente esta ordem: se uma regra precisa bloquear dados incorretos, use lógica de servidor síncrona; se ela pode ser executada após o salvamento, use lógica de servidor assíncrona; para mensagens entre aplicativos ou aprovações, use Flow ou Teams; e para computação pesada ou junções complexas, use um plug-in do Dataverse ou um Dataflow. O episódio também recomenda manter um catálogo de regras que registre a tabela, o gatilho, a condição, a ação e o responsável de cada regra, e orienta o uso de campos calculados e de rollup para cálculos determinísticos e somas sobre registros relacionados, em vez de recorrer a código.
O episódio "Why Power Platform Is Your Real Automation Layer — Not Custom Code" aborda o mesmo tema sob a perspectiva do histórico de personalizações. Ele descreve o modelo tradicional do Dynamics, no qual cada diferença entre o aplicativo padrão e o processo de negócio se torna mais uma personalização: um plug-in do Dataverse, JavaScript anexado a um formulário, uma atividade de fluxo de trabalho personalizada, uma tarefa agendada ou outro serviço de integração. O episódio afirma que cada recurso pode funcionar corretamente isoladamente, mas o processo completo se distribui gradualmente entre assemblies, scripts, fluxos de trabalho, APIs, valores de configuração e conhecimento especializado. Como resultado, o responsável pelo processo entende a política, mas não consegue inspecionar como ela é implementada. Esse é o principal argumento para tratar os plug-ins como uma escolha deliberada, e não como uma resposta padrão a toda mudança de processo.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Tipo | Concept |
|---|
Perguntas frequentes
Questions marked with AI were written with AI from the facts on this page.
O que é um plug-in do Dataverse? (AI)
Um plug-in do Dataverse é um manipulador de eventos personalizado, escrito como uma classe em um assembly do .NET Framework e registrado no Dataverse, que é executado em resposta a um evento específico durante uma operação de dados. Cada classe implementa a interface IPlugin com um único método Execute.
Um plug-in do Dataverse pode ser executado de forma síncrona e assíncrona? (AI)
Sim. Os plug-ins podem ser executados de forma síncrona, caso em que a operação aguarda sua conclusão, ou de forma assíncrona, após a conclusão da operação. A Microsoft Learn observa que os plug-ins síncronos precisam ser executados rapidamente e que há um limite de tempo rígido para a execução.
Quando um plug-in do Dataverse deve ser usado em vez de outras opções? (AI)
A Microsoft Learn recomenda verificar primeiro as opções declarativas, como ações personalizadas, colunas calculadas e de rollup, webhooks e Power Automate. O episódio "Customize Dataverse for Complex Business Apps" sugere um plug-in ou um Dataflow para computação pesada ou junções complexas.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Especialistas e empresas para este tópico
Ninguém indicou ainda este tópico. Adicione-o ao seu perfil.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: