Share via

Passo a passo: Registrar um plug-in usando a ferramenta de registro de plug-in

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Esse passo a passo demonstra como registrar um plug-in usando a ferramenta Plug-in Registration que está disponível no SDK. O plug-in para registrar é FollowupPlugin do tópico Amostra: Criar um plug-in básico.

O plug-in a ser registrado na entidade account , mensagem CreateRequest , em um pós-evento e na área restrita. O plug-in pode ser registrado em qualquer implantação do Microsoft Dynamics 365 (online e local) em que a conta de usuário tem uma função de personalizador de sistema ou de administrador do sistema.

Os seguintes pré-requisitos devem ser concluídos antes de iniciar este passo a passo:

Conectar-se ao servidor Microsoft Dynamics 365

  1. Executar a ferramenta Plug-in Registration.

  2. Clique em CRIAR NOVA CONEXÃO.

  3. Na caixa de diálogo Logon, selecione o botão de opção do tipo de implantação que corresponde ao servidor Microsoft Dynamics 365 em que você deseja registrar os plug-ins. O botão de opção Local inclui uma implantação IFD, o botão Online é para o provedor Windows Live do Microsoft Dynamics 365 (online), e o botão Office 365 é para o provedor Microsoft Online Services do Microsoft Dynamics 365 (online).

    Caixa de diálogo do logon para uma implantação online

    Janela de logon para uma implantação online
    Janela de logon para uma implantação local

    Janela de logon para uma implantação local

  4. Se você marcar Sempre exibir uma lista de organizações disponíveis, será exibida uma lista de organizações às quais você pertence após clicar em Logon. Isso permite escolher a organização na qual você deseja registrar o plug-in. Caso contrário, será usada a organização padrão.

  5. Insira as informações indicadas sobre o servidor e a conta de logon e, em seguida, clique em Logon.

Você verá uma lista recolhida dos plug-ins registrados ou conjuntos de atividades de fluxo de trabalho e pontos de extremidade de serviço. Os feeds de atividades e conjuntos do Microsoft.Crm.ObjectModel são necessários para que o Microsoft Dynamics 365 funcione corretamente, por isso a ferramenta que impede que o você os modifique. Selecionar um item na lista resulta nos painéis de guia Propriedades e Detalhes exibindo informações sobre esse item da lista.

A janela principal do aplicativo

A janela principal do aplicativo

Registre um conjunto de plug-in

  1. Selecione uma guia da organização para torná-la ativa.

  2. Na barra de ferramentas da guia, clique em Registrar e em Registrar Novo Assembly.

  3. Na caixa de diálogo Registrar novo conjunto, clique no botão de reticências…] [à direita de campo Etapa 1.

  4. Na caixa de diálogo Abrir, navegue até o local do conjunto SamplePlugin.dll compilado. O local padrão é SDK\SampleCode\CS\Plug-ins\bin\Debug. Selecione o assembly e clique em Abrir.

  5. Na seção Etapa 2, expanda o conjunto SamplePlugins para exibir todos os plug-ins nesse conjunto. Selecione (marque) somente o plug-in Microsoft.Crm.Sdk.Samples.FollowupPlugin.

  6. Na seção Etapa 3, selecione a opção Área restrita.

  7. Na seção Etapa 4, selecione a opção Banco de dados.

    Caixa de diálogo para registrar um conjunto

    Caixa de diálogo para registrar um conjunto

  8. Clique em Registrar Plug-ins Selecionados. Você pode fechar todas as caixas de diálogo abertas.

    Um plug-in registrado mostrado na exibição de árvore

    Um plug-in registrado mostrado na exibição de árvore

    Dica

    Você vê um erro na área Log e o log contém a seguinte mensagem?

    <Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

    Em caso positivo, você deve habilitar o código personalizado no servidor e tentar novamente. Para obter mais informações, consulte Habilitar ou desabilitar a execução de código personalizado.

O conjunto SamplePlugins.dll e o plug-in FollowupPlugin estão agora registrados e implantados no servidor. Se você usou a ferramenta para registrar um conjunto de atividades de fluxo de trabalho personalizadas, a próxima seção sobre o registro de uma etapa não se aplica.

Registrar uma etapa do plug-in para um evento

  1. Na exibição de árvore Plug-ins e atividades de fluxo de trabalho personalizados registrados, expanda o nó (Conjunto) SamplePlugins e selecione um plug-in registrado.

  2. Navegue até o menu Registrar na barra de ferramentas e clique em Registrar Nova Etapa.

    Observação

    Os plug-ins são registrados para executar quando um evento for processado no pipeline de execução do evento. Cada evento tem um nome e número de estágio para indicar a sua localização no pipeline, seja antes ou depois da operação da plataforma central. Uma etapa refere-se à entidade da etapa de processamento da mensagem SDK usada para configurar quando e como o plug-in deve ser executado.

  3. Preencha a caixa de diálogo Registrar nova etapa conforme mostrado na figura a seguir.

    Caixa de diálogo para registrar uma nova etapa

    Caixa de diálogo para registrar uma nova etapa

  4. Clique em Registrar Nova Etapa.

  5. Expanda o nó (Conjunto) SamplePlugins e os subnós para ver os nós do plug-in e da etapa que você criou. Agora você pode fechar a ferramenta, mas talvez queira mantê-la aberta até depois de testar o plug-in e cancelar o registro do conjunto.

    Observação

    Para cancelar o registro da etapa, do plug-in ou do assembly, selecione seu nó na árvore e clique em Cancelar Registro na barra de ferramentas. Para modificar um registro de conjunto ou etapa, clique duas vezes no nó do conjunto ou etapa na exibição de árvore. Se preferir, você pode selecionar o nó e clicar em Atualizar na barra de ferramentas.

O plug-in já está registrado para executar na área restrita, para um evento de criação de conta e depois que a operação central é executada. Você registrou o plug-in para executar de forma assíncrona, uma vez que a criação da atividade de acompanhamento da tarefa não é crítica para o tempo. Depois que uma conta é criada, o plug-in executará na próxima vez que o serviço assíncrono processar sua fila.

Teste o plug-in

Depois de registrar o plug-in, você pode opcionalmente testar sua execução usando o seguinte procedimento.

  1. Abra o aplicativo Web Microsoft Dynamics 365 para a mesma organização em que você registrou o conjunto do plug-in.

  2. Vá para o local de trabalho, selecione Contas e clique em Novo.

  3. Na caixa Nome da conta digite um nome de conta, por exemplo, Adventure Works Cycle e clique em Salvar e fechar.

  4. Clique duas vezes no nome do formulário na grade Contas para abrir o formulário.

  5. Clique em Atividades para exibir uma lista de atividades relacionadas à conta. Você deverá visualizar a atividade chamada “Send email to the new customer“ que o plug-in criou.

  6. Se você registrou o plug-in para executar de forma assíncrona, e não selecionou a opção Excluir AsyncOperation se StatusCode = Sucesso no formulário Registrar nova etapa, haverá um novo trabalho do sistema chamado “FollowupPlugin: Create of account”. Para exibir o trabalho do sistema relacionado, clique em Configurações e em Trabalhos do sistema. Clique duas vezes no trabalho do sistema mencionado anteriormente.

Agora, você pode cancelar o registro da etapa, plug-in e conjunto, se quiser. Talvez você também queira excluir o trabalho do sistema e a conta que você criou.

Confira Também

Desenvolvimento de plug-in
Passo a passo: Configurar a segurança do conjunto de um plug-in offline
Registrar e implantar plug-ins
Pipeline de execução do evento
Isolamento, estatísticas e confianças de plug-in
Entidades e mensagens suportadas para plug-ins

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais