Passo a passo: Criar um aplicativo de console que se conecta ao Microsoft Dynamics CRM 2015 usando extensões do desenvolvedor

Artigo
07/06/2017

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Esta explicação passo a passo demonstra como escrever um aplicativo de console simples que se conecta ao Microsoft Dynamics CRM 2015 usando as Extensões do Desenvolvedor e cria um registro do contato.

É possível encontrar o código de exemplo criado por esta explicação passo a passo na pasta Walkthroughs\Portal\ConsoleAppWalkthrough.

Neste tópico

Gerencie tipos early bound

Crie um novo projeto do aplicativo de console no Visual Studio

Gerencie tipos early bound

Execute a ferramenta CrmSvcUtil.exe com a extensão “Microsoft.Xrm.Client.CodeGeneration” para gerar as classes de entidade e os contextos de serviço. Segue abaixo um comando de exemplo que cria um arquivo chamado Xrm.cs, que aponta para uma instância do Microsoft Dynamics 365. Observe que, ao executar o comando, o arquivo Microsoft.Xrm.Client.CodeGeneration.dll deverá estar no mesmo diretório que o arquivo CrmSvcUtil.exe ou no cache do assembly global do sistema. O primeiro comando mostrado é para uma organização local. O segundo comando é para uma organização do CRM Online. Ambos os comandos devem ser executados como uma linha de comandos única sem quebras de linha.
```
    CrmSvcUtil.exe
    /codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"/out:Xrm.cs /url:http://<myserver>/<myorg>/XRMServices/2011/Organization.svc 
    /domain:<mydomain> /username:<myusername> /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
```
    CrmSvcUtil.exe
    /codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"
    /out:Xrm.cs /url:https://<mydomain>.api.crm.dynamics.com/XRMServices/2011/Organization.svc
    /username:<myusername>@<mydomain>.onmicrosoft.com /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
Dica

A ferramenta CrmSvcUtil está disponível na pasta Bin do download do SDK ou com a instalação do pacote Microsoft.CrmSdk.CoreToolsNuGet.

Crie um novo projeto do aplicativo de console no Visual Studio

Crie um novo aplicativo de console chamado “ConsoleAppWalkthrough”. Se você não tiver o .NET Framework 4.5.2 instalado, poderá obter o Pacote do Desenvolvedor em Instalando o .NET Framework.
Adicione as seguintes referências da pasta SDK\bin. Você pode ignorar esta etapa e a seguinte simplesmente instalando o pacote Microsoft.CrmSdk.ExtensionsNuGet.
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
Adicione as seguintes referências do .NET.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
Verifique se o projeto de console especifica o .NET Framework 4.5.2 como a estrutura de destino e não o perfil do cliente do .NET Framework 4.5.2. Verifique as propriedades do projeto, selecionando o projeto ConsoleAppWalkthrough no Solution Explorer e clicando Alt-Enter.
Clique com o botão direito no projeto do Visual Studio, clique em Adicionar e em Item existente.
Selecione o arquivo “xrm.cs” criado quando os tipos early bound foram gerados.
Clique com o botão direito novamente no projeto, clique em Adicionar e em Novo item.
Selecione Arquivo de configuração do aplicativo nas opções e clique em Adicionar.

Edite o arquivo de configuração App.config com a cadeia de conexão específica.

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="microsoft.xrm.client" type="Microsoft.Xrm.Client.Configuration.CrmSection, Microsoft.Xrm.Client"/>
  </configSections>
  <connectionStrings>   <add name="Xrm" connectionString="Server=http://crmserver/contoso; Domain=CONTOSO; Username=Administrator;Password=pass@word1"/></connectionStrings>
  <microsoft.xrm.client>
    <contexts default="Xrm">
      <add name="Xrm" type="Xrm.XrmServiceContext, Xrm" connectionStringName="Xrm"/>
    </contexts>
  </microsoft.xrm.client>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
  </startup>
</configuration>

Adicione uma instrução de uso ao namespace usado na Etapa 1 ao criar o projeto (neste exemplo, “Xrm“).

Adicione o seguinte código à classe do programa:

static void Main(string[] args)
{
    var xrm = new XrmServiceContext("Xrm");

    WriteExampleContacts(xrm);

    //Create a new contact called Allison Brown.
    var allisonBrown = new Xrm.Contact
    {
        FirstName = "Allison",
        LastName = "Brown",
        Address1_Line1 = "23 Market St.",
        Address1_City = "Sammamish",
        Address1_StateOrProvince = "MT",
        Address1_PostalCode = "99999",
        Telephone1 = "12345678",
        EMailAddress1 = "allison.brown@example.com"
    };

    xrm.AddObject(allisonBrown);
    xrm.SaveChanges();

    WriteExampleContacts(xrm);

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();
}

/// <summary>
/// Use all contacts where the email address ends in @example.com.
/// </summary>
private static void WriteExampleContacts(XrmServiceContext xrm)
{
    var exampleContacts = xrm.ContactSet
        .Where(c => c.EMailAddress1.EndsWith("@example.com"));

    //Write the example contacts.
    foreach (var contact in exampleContacts)
    {
        Console.WriteLine(contact.FullName);
    }
}

Depure e teste a solução. Isso criará um contato na organização do Dynamics 365.

Confira Também

Guia do desenvolvedor para o portal do Microsoft Dynamics CRM 2015
Instruções passo a passo do portal do Dynamics CRM 2015
Passo a passo: Criar um aplicativo Web que se conecta ao Microsoft Dynamics CRM 2015 usando extensões do desenvolvedor

Partilhar via

Passo a passo: Criar um aplicativo de console que se conecta ao Microsoft Dynamics CRM 2015 usando extensões do desenvolvedor

Neste tópico

Gerencie tipos early bound

Crie um novo projeto do aplicativo de console no Visual Studio

Confira Também

Recursos adicionais