Usar o SDK para .NET

O SDK para .NET fornece acesso aos dados corporativos, definições de tabela de dados (metadados) e operações de dados compatíveis com a plataforma Dataverse.

Determinados cenários de desenvolvimento exigem o uso do SDK do Dataverse para .NET. Ao escrever código personalizado para estender a funcionalidade do Dataverse, como quando você cria plug-ins e atividades de fluxo de trabalho personalizadas, você deve criar seu código usando o .NET Framework e o Dataverse SDK.

Obter os assemblies do SDK

Use o SDK para assemblies do .NET em aplicativos baseados no .NET Framework ou no .NET Core. Para desenvolvimento somente para .NET Framework, obtenha os assemblies do SDK no pacote NuGet Microsoft.CrmSdk.CoreAssemblies. Para desenvolvimento em .NET Framework ou .NET Core, obtenha os assemblies do SDK no pacote NuGet Microsoft.PowerPlatform.Dataverse.Client.

Depois de adicionar o pacote NuGet ao seu projeto Visual Studio, você terá acesso aos namespaces e classes que permitem que seu aplicativo interaja com os serviços Web de Organização e Descoberta.

Interagir com o serviço da organização

Esta seção aborda alguns dos principais conceitos sobre como usar classes SDK fornecidas para se conectar com os serviços Web e executar operações.

Estabelecer uma conexão de serviço Web

A interface IOrganizationService fornece conexão com o serviço de Organização, permitindo que os aplicativos trabalhem com dados de negócios e definições de tabelas e colunas. O SDK inclui duas implementações dessa interface: CrmServiceClient e ServiceClient. Para o desenvolvimento de novos aplicativos, use a classe ServiceClient, que oferece suporte a tecnologias de autenticação mais recentes (MSAL) e tem alguns recursos adicionais não disponíveis na CrmServiceClient. No entanto, ambas as classes de cliente são basicamente as mesmas de uma perspectiva de API. Você vê exemplos de código nesta documentação usando qualquer uma dessas classes e é bastante fácil converter o código que usa CrmServiceClient para usar ServiceClient.

Mais informações: Fazer a transição de aplicativos para o Dataverse ServiceClient, interface IOrganizationService

Operações de serviço Web

No SDK do Dataverse para .NET, você inicia operações de serviço Web enviando mensagens ou solicitações de mensagem para o serviço. Cada mensagem tem um nome que indica a finalidade da mensagem e o nome da classe de solicitação correspondente é baseado nesse nome de mensagem. Por exemplo, para criar uma linha de dados em uma tabela, você preenche uma solicitação de criação com dados e faz com que o cliente de serviço envie (Execute) essa solicitação para o serviço da Organização. A operação é 'create' e a solicitação de mensagem é nomeada CreateRequest. Quando você executa uma solicitação, o serviço retorna um objeto de classe de resposta (por exemplo, CreateResponse) que contém um status de execução e dados de resultados. Esse padrão é o mesmo para as outras operações compatíveis com o serviço.

Dê uma olhada nas classes de solicitação e de resposta de mensagem disponíveis nos namespaces Microsoft.Crm.Sdk.Messages e Microsoft.Xrm.Sdk.Messages.

Sobre o ponto de extremidade SOAP herdado

A Microsoft introduziu o endpoint do serviço de Organização, conhecido como endpoint SOAP, em 2011. Este endpoint está obsoleto. Isso significa que ele continua a funcionar e ter suporte até Microsoft removê-lo. Microsoft também anunciou que atualizará o SDK para .NET assemblies para que eles continuem funcionando depois que o ponto de extremidade for removido. Isso significa que o SDK atualizado para assemblies do .NET estará disponível antes que o endpoint seja removido. Os desenvolvedores serão obrigados a atualizar seu código para usar esses novos assemblies em algum momento no futuro. A principal conclusão é que os desenvolvedores acessam o serviço Organization por meio do SDK para .NET e ignoram o endpoint e seu protocolo. Para obter mais informações, consulte Aplicativos de transição para o Dataverse ServiceClient.

Como a Web API usa um endpoint diferente, ela não é afetada por essa depreciação do endpoint SOAP de 2011.

Próximas Etapas 

Vamos escrever um código! Início Rápido: Exemplo do SDK para .NET (C#)

Consulte também

Descobrir organizações de usuários
Use plug-ins para estender processos corporativos
Extensões de fluxo de trabalho