Tutorial: Crear una aplicación de consola conectada a Microsoft Dynamics CRM 2015 mediante extensiones para desarrolladores

Artículo
07/06/2017

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Este tutorial muestra cómo escribir una aplicación de consola sencilla que se conecta a Microsoft Dynamics CRM 2015 mediante extensiones para desarrolladores y crea un registro de contacto.

Puede encontrar el código de muestra que genera este tutorial en la carpeta Walkthroughs\Portal\ConsoleAppWalkthrough.

En este tema

Generación de tipos de enlace de tiempo de compilación

Crear un nuevo proyecto de aplicación de consola en Visual Studio

Generación de tipos de enlace de tiempo de compilación

Ejecute la herramienta CrmSvcUtil.exe, con la extensión “Microsoft.Xrm.Client.CodeGeneration", para generar las clases de entidad y los contextos de servicio. El siguiente es un comando de ejemplo para crear un archivo llamado Xrm.cs que señala a una instancia de Microsoft Dynamics 365. Tenga en cuenta que el archivo Microsoft.Xrm.Client.CodeGeneration.dll debe estar en el mismo directorio que el archivo CrmSvcUtil.exe, o en la memoria caché de ensamblados global del sistema, al ejecutar este comando. El primer comando mostrado es para una organización local. El segundo comando es para una organización de CRM Online. Ambos comandos deben ser ejecutados como una sola línea de comandos sin saltos de línea.
```
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
```

Sugerencia

La herramienta CrmSvcUtil está disponible en la carpeta Bin de la descarga de SDK o instalando el paquete Microsoft.CrmSdk.CoreToolsNuGet.

Crear un nuevo proyecto de aplicación de consola en Visual Studio

Cree una nueva aplicación de consola denominada “ConsoleAppWalkthrough”. Si aún no ha instalado .NET Framework 4.5.2, puede obtener el paquete de desarrollador de Instalación de .NET Framework.
Agregue las siguientes referencias desde la carpeta de SDK\bin. Puede omitir este paso y el siguiente instalando simplemente el paquete 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
Agregue las siguientes referencias desde .NET.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
Asegúrese de que el proyecto de la consola especifica .NET Framework 4.5.2 como marco de destino y no .NET Framework 4.5.2 Client Profile. Compruebe las propiedades del proyecto seleccionando el proyecto ConsoleAppWalkthrough en el Explorador de soluciones y haciendo clic en Alt-Entrar.
Haga clic con el botón derecho en Visual Studio, haga clic en Agregar y, a continuación, haga clic en Elemento existente.
Seleccione el archivo “xrm.cs” creado al generar los tipos enlazados en tiempo de compilación.
Vuelva a hacer clic en el proyecto con el botón secundario, haga clic en Agregar y, a continuación, haga clic en Nuevo elemento.
En las opciones, seleccione Archivo de configuración de la aplicación y haga clic en Agregar.

Edite el archivo de configuración App.config con la cadena de conexión 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>

Agregue una instrucción Using al espacio de nombres que usó en el paso 1 al crear el proyecto (para este ejemplo "Xrm").

Agregue el siguiente código a la clase de 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 y pruebe la solución. Se creará un contacto en la organización Dynamics 365.

Ver también

Manual de desarrollador de portal para Microsoft Dynamics CRM 2015
Tutoriales de portal para Dynamics CRM 2015
Tutorial: Crear una aplicación web conectada a Microsoft Dynamics CRM 2015 mediante extensiones para desarrolladores

Compartir a través de

Tutorial: Crear una aplicación de consola conectada a Microsoft Dynamics CRM 2015 mediante extensiones para desarrolladores

En este tema

Generación de tipos de enlace de tiempo de compilación

Crear un nuevo proyecto de aplicación de consola en Visual Studio

Ver también

Recursos adicionales