Escolha seu estilo de desenvolvimento para o Dynamics 365

Artigo
09/22/2017

Publicado: janeiro de 2017

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

O SDK do Microsoft Dynamics 365 oferece uma grande variedade de tecnologias e métodos que podem ser usados ao escrever códigos para acessar os serviços da Web de Microsoft Dynamics 365 (online e local) ou para estender o aplicativo. Este tópico fornece diretrizes para escolher o estilo de desenvolvimento de acordo com sua área de tecnologia.

Neste tópico

.NET versus desenvolvimento não .NET

Desenvolvimento .NET: use assemblies de SDK do Dynamics 365

Desenvolvimento .NET: usar assemblies de ferramentas XRM

Escolher como conectar-se ao Dynamics 365

.NET versus desenvolvimento não .NET

A primeira coisa a considerar ao escrever código para estender o Dynamics 365 é se seu código é escrito usando o .NET Framework.

Se você usar o .NET Framework para escrever código, considere usar um destes procedimentos dependendo do que está você está criando:
- Se estiver criando plug-ins, atividades de fluxo de trabalho personalizadas ou fluxos de trabalho XAML, use os assemblies de SDK do Dynamics 365, Para obter mais informações:Desenvolvimento .NET: use assemblies de SDK do Dynamics 365
- Se estiver criando aplicativos do Windows para assemblies do Dynamics 365, use assemblies das ferramentas do XRM.Para obter mais informações:Desenvolvimento .NET: usar assemblies de ferramentas XRM
- Se estiver criando aplicativos não Windows para o Dynamics 365, use a API Web.Para obter mais informações:Use a API da Web do Microsoft Dynamics 365
Se você não usar o .NET Framework para escrever, use a API Web.Para obter mais informações:Use a API da Web do Microsoft Dynamics 365

O diagrama a seguir mostra qual estilo de desenvolvimento escolher ao desenvolver para o Dynamics 365:

Fluxo de estilo de desenvolvimento para o Dynamics 365

Desenvolvimento .NET: use assemblies de SDK do Dynamics 365

Os assemblies de SDK do Dynamics 365 oferecem classes que você pode usar para se conectar aos serviços Web do Dynamics 365 para identificar sua organização e realizar operações de negócios comuns, como criar, recuperar, atualizar e excluir dados no Dynamics 365. Os assemblies do SDK estão disponíveis como pacotes NuGet e também estão incluídos no pacote de download do SDK do Dynamics 365.Para obter mais informações:Assinar atualizações de assembly do SDK usando o NuGet e Assemblies incluídos no Microsoft Dynamics 365 SDK.

Importante

Se estiver usando o NET Framework 4.5.2 ou posterior para escrever seu código, use a versão mais recente dos assemblies do SDK do Dynamics 365 para criar plug-ins, atividades de fluxo de trabalho personalizadas ou fluxos de trabalho XAML.

Porém, se você estiver usando o .NET Framework 4 e usando a classe CrmConnection das extensões do SDK (preteridas) para conectar-se à Atualização 1 do Dynamics CRM 2016 (local) e o CRM Online 2016 Atualização 1 (versão 8.1.0) ou posterior, você precisará usar a versão 6.1.2 dos assemblies do SDK do Dynamics 365. Caso contrário, você não poderá conectar-se. Para obter mais informações sobre a compatibilidade com versões anteriores, veja o Blog: Compatibilidade com versões anteriores do SDK do Dynamics 365

Ao escrever código usando os assemblies do SDK, você trabalha com o Serviço Web de Organização (ponto de extremidade SOAP) para conectar-se a uma instância do Microsoft Dynamics 365 e executar as operações compatíveis com o serviço Web.Para obter mais informações:Usar o serviço da organização do Microsoft Dynamics 365

Observação

Os assemblies do SDK serão migrados para usar a API Web internamente em vez do ponto de extremidade SOAP 2011. Quando isso acontecer, todo código escrito com os assemblies do SDK continuará a ser compatível pois ele será transferido automaticamente do ponto de extremidade SOAP de 2011 para usar a API Web. Essa atualização será totalmente transparente para você. Os detalhes serão publicados nas futuras versões do SDK.Para obter mais informações:Ponto de extremidade Microsoft Dynamics CRM 2011

Criar e implantar plug-ins ou atividades de fluxo de trabalho personalizadas: as classes do plug-in e das atividades de fluxo de trabalho personalizadas permitem criar manipuladores de eventos para executar lógica de negócios personalizada que você pode integrar com o Microsoft Dynamics 365 para mudar ou aumentar o comportamento padrão da plataforma.

Se desejar escrever plug-ins e atividades de fluxo de trabalho personalizadas desde o início, use a Ferramenta de Registro de Plug-ins para registrá-los. Esta ferramenta fornece uma interface gráfica do usuário e oferece suporte ao registro de plug-ins e atividades de fluxo de trabalho personalizadas com o Microsoft Dynamics 365.Para obter mais informações:Desenvolvimento de plug-in e Atividades personalizadas de fluxo de trabalho (assemblies de fluxo de trabalho)
Criar e implantar fluxos de trabalho XAML personalizados: o Microsoft Dynamics 365 local e o IFD permitem criar fluxos de trabalho XAML personalizados. Usando o Designer de Fluxo de trabalho do Microsoft Visual Studio, você pode criar fluxos de trabalho XAML personalizados, também chamados fluxos de trabalho declarativos, arrastando as atividades do fluxo de trabalho da caixa de ferramentas para a superfície de design, criando variáveis e definindo as propriedades dessas atividades para implementar a funcionalidade do fluxo de trabalho. Você pode usar as atividades internas do Windows Workflow Foundation ou processar as atividades específicas do Microsoft Dynamics 365.Para obter mais informações:Fluxos de trabalho do XAML personalizados

Modelos de programação de associações inicial e tardia para entidades do Dynamics 365: ao usar os assemblies do SDK, você pode escolher entre dois modelos de programação:

Associação inicial	Associação tardia
Use a ferramenta de geração de código (CrmSvcUtil) para criar classes de entidade de associação inicial, derivadas da classe Entity, que você pode usar para acessar dados corporativos no Microsoft Dynamics 365. Estas classes incluem uma classe para cada entidade na instalação, incluindo entidades personalizadas.Para obter mais informações:Use classes de entidade de limite antecipado no código	A classe Entity contém o nome lógico de uma entidade e uma matriz do recipiente de propriedades dos atributos da entidade. Isso permite usar a associação recente, para ser possível trabalhar com tipos como entidades personalizadas e atributos personalizados que não estavam presentes durante a compilação do aplicativo.Para obter mais informações:Usar a classe de entidade late bound no código

Use a ferramenta de geração de código (CrmSvcUtil) para criar classes de entidade de associação inicial, derivadas da classe Entity, que você pode usar para acessar dados corporativos no Microsoft Dynamics 365. Estas classes incluem uma classe para cada entidade na instalação, incluindo entidades personalizadas.Para obter mais informações:Use classes de entidade de limite antecipado no código

A classe Entity contém o nome lógico de uma entidade e uma matriz do recipiente de propriedades dos atributos da entidade. Isso permite usar a associação recente, para ser possível trabalhar com tipos como entidades personalizadas e atributos personalizados que não estavam presentes durante a compilação do aplicativo.Para obter mais informações:Usar a classe de entidade late bound no código

Consulta de dados no Dynamics 365: há três maneiras de recuperar e consultar dados no Dynamics 365 usando os assemblies do SDK: FeatchXML, QueryExpression e .NET LINQ.Para obter mais informações:Recuperar dados com consultas utilizando assemblies SDK

Desenvolvimento .NET: usar assemblies de ferramentas XRM

Os assemblies de ferramentas XRM utilizam as APIs de assemblies do SDK do Dynamics 365 (serviço da Organização e IDiscoveryService) para fornecer suporte fácil à autenticação com menos linhas de código e usando cmdlets do Windows PowerShell. Todas as chamadas de função nessas classes fornecem segurança aos threads para as ações realizadas no Dynamics 365 em um ambiente com vários threads. As ferramentas XRM fornecem um controle comum de início de sessão com uma lógica de autenticação integrada e a capacidade de armazenar e reutilizar com segurança as informações de autenticação para proporcionar uma experiência consistente e integrada de entrada no Dynamics 365 em seus aplicativos cliente do Windows.Para obter mais informações:Criar aplicativos cliente do Windows usando as ferramentas XRM

Os assemblies das ferramentas XRM estão disponíveis como pacotes NuGet; os pacotes são encontrados no perfil crmsdk. Selecione qualquer pacote na lista com o nome "Xrm Tooling" para navegar até a página de detalhes do pacote. Os assemblies das ferramentas XRM também estão disponíveis no pacote de download do SDK do Dynamics 365. Baixe o pacote do SDK do Microsoft Dynamics CRM.

Com o suporte à cadeia de conexão disponível nas ferramentas XRM e a reprovação das extensões do SDK para o Dynamics 365, use os assemblies das ferramentas XRM em vez da classe CrmConnection para conectar-se ao Dynamics 365.Para obter mais informações:Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se conectar ao Dynamics 365 e Exemplo: início rápido de conexão simplificada usando o Microsoft Dynamics 365

Escolher como conectar-se ao Dynamics 365

Dependendo de seu estilo de desenvolvimento (.NET versus não .NET), você escolherá a maneira como seu código autentica os usuários no Dynamics 365. A tabela a seguir fornece informações breves sobre o modelo de autenticação que você deve considerar de acordo com seu estilo de desenvolvimento:

Estilo de desenvolvimento	Descrição
.NET: assemblies do SDK do Dynamics 365	Os assemblies do SDK do Microsoft Dynamics 365 usam a tecnologia WCF (Windows Communication Foundation) para estabelecer comunicação com os serviços Web do Microsoft Dynamics 365. O SDK do Microsoft Dynamics 365 simplifica o uso da tecnologia WCF fornecendo classes proxy auxiliares que facilitam a criação de aplicativos que se conectam e se autenticam com os serviços Web do Microsoft Dynamics 365. Mais Informações: Usar o código de exemplo e auxiliar, Código auxiliar: Classe ServerConnection
.NET: assemblies de ferramentas XRM	Use a cadeia de conexão, classe CrmServiceClient, ou os cmdlets do PowerShell das ferramentas XRM para conectar-se ao Dynamics 365. Mais informações: Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se conectar ao Dynamics 365, Os os construtores para conectar ao Dynamics 365, Usar cmdlets do PowerShell para ferramentas XRM e conectar ao Dynamics 365
API Web do Dynamics 365	Mais Informações: Autentique Microsoft Dynamics 365 com API da Web

.NET: assemblies do SDK do Dynamics 365

Os assemblies do SDK do Microsoft Dynamics 365 usam a tecnologia WCF (Windows Communication Foundation) para estabelecer comunicação com os serviços Web do Microsoft Dynamics 365. O SDK do Microsoft Dynamics 365 simplifica o uso da tecnologia WCF fornecendo classes proxy auxiliares que facilitam a criação de aplicativos que se conectam e se autenticam com os serviços Web do Microsoft Dynamics 365.

Mais Informações: Usar o código de exemplo e auxiliar, Código auxiliar: Classe ServerConnection

.NET: assemblies de ferramentas XRM

Use a cadeia de conexão, classe CrmServiceClient, ou os cmdlets do PowerShell das ferramentas XRM para conectar-se ao Dynamics 365.

Mais informações: Usar cadeias de conexão no trabalho realizado com ferramentas de XRM para se conectar ao Dynamics 365, Os os construtores para conectar ao Dynamics 365, Usar cmdlets do PowerShell para ferramentas XRM e conectar ao Dynamics 365

API Web do Dynamics 365

Mais Informações: Autentique Microsoft Dynamics 365 com API da Web

Para obter informações detalhadas sobre como autenticar usuários para conexão ao Dynamics 365, veja Autenticar usuários no Microsoft Dynamics 365