Registre um plug-in a ser implantado no local

Plug-ins e atividades de fluxo de trabalho personalizadas são códigos personalizados que você desenvolve para estender a funcionalidade existente do Dynamics 365 Customer Engagement (on-premises). Antes que um plug-in ou atividade de fluxo de trabalho personalizada possa ser usado, ele deve ser registrado no servidor. Um plug-in e uma ferramenta de registro de atividade de fluxo de trabalho personalizada estão disponíveis para download.

Informações gerais sobre o registro de assembly de plug-in e fluxo de trabalho personalizado podem ser encontradas nos tópicos do Dataverse Registrar um plug-in e Registrar seu assembly. As informações a seguir são específicas para o desenvolvimento de plug-ins locais.

Embora este tópico se concentre principalmente em plug-ins, a maioria das informações também é aplicável a atividades de fluxo de trabalho personalizadas. Uma diferença entre os dois é que, para conjuntos de atividades de fluxo de trabalho personalizadas, você registra apenas o conjunto. Para plug-ins, você registra o assembly do plug-in e um ou mais passos por plug-in. Para obter mais informações sobre atividades de fluxo de trabalho personalizadas, consulte Atividades de fluxo de trabalho personalizadas (assemblies de fluxo de trabalho).

Armazenamento de plug-ins

Para uma implantação local, os plug-ins que não estão registrados na área restrita podem ser armazenados no banco de dados do Dynamics 365 Server ou no sistema de arquivos em disco . É altamente recomendável que você armazene seus plug-ins prontos para produção no banco de dados do Dynamics 365 Customer Engagement (on-premises), em vez de no disco. Os plug-ins armazenados no banco de dados são distribuídos automaticamente entre vários Dynamics 365 Servers em um cluster de data center. O armazenamento em disco de plug-ins é útil para a depuração de plug-ins no Visual Studio. No entanto, você pode depurar um plug-in armazenado no banco de dados. Para obter mais informações, consulte Depurar um plug-in.

Os plug-ins registrados na sandbox devem ser armazenados no banco de dados, independentemente da implantação do Dynamics 365 Customer Engagement (on-premises, IFD ou Online).

Implantação

Para instalações locais ou voltadas para a Internet (IFD) do Dynamics 365 Customer Engagement (on-premises), quando você implanta plug-ins de outro computador no disco do Dynamics 365 Server (implantação em disco), o assembly de plug-in deve ser copiado manualmente para o servidor antes do registro. O assembly deve ser implantado na <installdir>pasta \Arquivos de Programas\Microsoft CRM\server\bin\assembly em cada servidor em que o plug-in deve ser executado.

O registro do plug-in deve ser feito depois que o assembly tiver sido copiado para a pasta ...\bin\assembly no servidor para evitar a situação em que um usuário do sistema faz com que um evento no Dynamics 365 Customer Engagement (on-premises) seja gerado, mas o assembly de plug-in registrado ainda não existe no servidor. Para implantação do banco de dados no servidor, o assembly de plug-in é automaticamente copiado durante o registro do plug-in para que a situação anterior não seja um problema.

Dependendo do design do seu plug-in, os seus plug-ins podem exigir que outras bibliotecas referenciadas estejam presentes para serem executados. Independentemente de você implantar o plug-in no banco de dados ou no disco, se o plug-in exigir que outros assemblies sejam executados, você deverá colocar cópias desses assemblies no cache de assembly global em cada servidor em que o plug-in deve ser executado.

Para mover um plug-in de um ambiente de desenvolvimento para um servidor de preparo ou produção

1. No computador de desenvolvimento, crie o código do plug-in. Não inclua informações de depuração. Otimize o plug-in para melhorar o desempenho.
2. Registre o plug-in no banco de dados do Dynamics 365 Server.
3. Usando o aplicativo Web do Dynamics 365 Customer Engagement (on-premises), crie uma solução ou use uma existente e adicione o plug-in a essa solução.
4. Depois de adicionar outros componentes desejados à solução, exporte a solução.
5. Importe a solução para o servidor de preparo ou produção.

Restrições de segurança

Há uma restrição de segurança que permite que apenas usuários privilegiados registrem plug-ins. Para plug-ins que não estão registrados no ambiente de simulação (isolamento), a conta de usuário do sistema na qual o plug-in está sendo registrado deve existir no grupo Administradores de Implantação do Gerenciador de Implementação. Somente a conta de usuário Administrador do sistema ou qualquer conta de usuário incluída no grupo Administradores de implantação pode executar o Gerenciador de implantação.

Para plug-ins registrados na área restrita (modo de isolamento), a conta de usuário do sistema na qual o plug-in está sendo registrado deve ter a função de Administrador do Sistema. A associação ao grupo Administradores de Implantação não é necessária.

Consulte também

Desenvolvimento de plug-ins
Depurar um plug-in
Empacotar e distribuir extensões com as soluções do Dynamics 365 Customer Engagement (on-premises)