M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

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.

✦ CONCEPTDataverse plug-inM365.FM
Title graphic: Dataverse plug-in (Concept)

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.

TipoConcept

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.

Glossário

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: