Guia para plugin para o Microsoft Dataverse

O Microsoft Dataverse é uma plataforma de dados poderosa e flexível que permite às organizações armazenar e gerenciar dados para uma ampla gama de aplicações. Embora o Dataverse ofereça funcionalidades robustas prontas para uso, você pode estendê-lo e personalizá-lo ainda mais criando plugins. Neste artigo, forneceremos um guia passo a passo sobre como criar um plugin para o Microsoft Dataverse.

Pré-requisitos

Antes de se aprofundar no desenvolvimento de plugins para o Microsoft Dataverse, certifique-se de ter os seguintes pré-requisitos em vigor:

1. Instância do Microsoft Dataverse: Você precisa de acesso a um ambiente Dataverse onde possa criar e testar seus plugins.
2. Visual Studio: Você estará desenvolvendo plugins usando C# e o SDK do Dynamics 365, portanto, deve ter o Visual Studio instalado e configurado.
3. Conta de Desenvolvedor: Você deve ter uma conta de desenvolvedor com as permissões necessárias para criar e gerenciar plugins em seu ambiente Dataverse.

Criando um Plugin Simples do Dataverse

Neste guia, criaremos um plugin básico do Dataverse que é acionado quando um novo registro de contato é criado e atualiza um campo personalizado.

Passo 1: Configurar o Seu Projeto

1. Inicie o Visual Studio e crie um novo projeto de Biblioteca de Classes (.NET Standard).
2. Adicione referências às assemblies necessárias do SDK do Dynamics 365.

Passo 2: Escrever o Código do Plugin

Em seu projeto, crie uma classe que implementa a interface IPlugin. Essa interface contém um método Execute, que é o ponto de entrada para o seu plugin.

using System;
using Microsoft.Xrm.Sdk;

namespace MeuPluginDataverse
{
    public class PluginDeCriacaoDeContato : IPlugin
    {
        public void Execute(IServiceProvider serviceProvider)
        {
            // Obtenha o contexto de execução
            IPluginExecutionContext contexto = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));

            // Verifique se o plugin é acionado por uma operação de criação
            if (contexto.InputParameters.Contains("Target") && contexto.InputParameters["Target"] is Entity)
            {
                Entity contato = (Entity)contexto.InputParameters["Target"];

                // Verifique se a entidade é um Contato
                if (contato.LogicalName == "contact")
                {
                    // Sua lógica personalizada aqui
                    contato["new_campopersonalizado"] = "Valor Atualizado pelo Plugin";
                }
            }
        }
    }
}

Passo 3: Registrar o Plugin

1. Compile o seu projeto para gerar a assembly do plugin.
2. Em seu ambiente Dataverse, navegue até o centro de administração do Power Platform.
3. Crie uma nova Solução do Dataverse ou use uma existente.
4. Adicione uma nova etapa de plugin sob a entidade apropriada (por exemplo, Contato) em sua solução. Configure a etapa para acionar a mensagem de Criação e especifique sua assembly e classe personalizada.

Passo 4: Testar o Seu Plugin

1. Crie um novo registro de Contato em seu ambiente Dataverse.
2. Verifique o valor do campo personalizado que você especificou no código do plugin. Ele deve refletir o “Valor Atualizado pelo Plugin”.

Parabéns! Você criou e registrou com sucesso um plugin simples para o Microsoft Dataverse.

Desenvolvimento de Plugins Avançados

Este guia cobre o básico da criação de um plugin do Dataverse. Para cenários mais avançados, você pode explorar conceitos adicionais, como:

• Imagens Pré e Pós: Use essas imagens para acessar o estado da entidade antes e depois da operação.
• Ferramenta de Registro de Plugins: Considere usar a Ferramenta de Registro de Plugins para gerenciar e implantar seus plugins.
• Tratamento de Erros: Implemente um tratamento de erros robusto para garantir que seus plugins lidem com exceções de forma adequada.
• Recursos da Web: Incorpore recursos da web (HTML, JavaScript, CSS) em seus plugins para funcionalidade aprimorada.
• Configuração Segura: Implemente opções de configuração segura para seus plugins.

Conclusão

A criação de plugins para o Microsoft Dataverse permite que você estenda e personalize a plataforma para atender às necessidades específicas de sua organização. Seja automatizando processos de negócios, integrando-se a sistemas externos ou adicionando novas funcionalidades, os plugins são uma ferramenta poderosa em seu kit de personalização do Dataverse. Comece com o básico, experimente e, gradualmente, desenvolva sua experiência para desbloquear todo o potencial do desenvolvimento de plugins do Dataverse.

Veja também nosso artigo sobre Dataverse: Power Automate vs Plug-ins.