Procédure pas à pas : créer une application console qui se connecte à Microsoft Dynamics CRM 2015 à l’aide des extensions développeur

Article
07/06/2017

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Cette procédure pas à pas montre comment écrire une application console simple qui se connecte à Microsoft Dynamics CRM 2015 avec les extensions développeur et crée un enregistrement de contact.

Vous trouverez l’exemple de code que génère cette procédure dans le dossier Walkthroughs\Portal\ConsoleAppWalkthrough.

Contenu de la rubrique

Générer des types à liaison anticipée

Créer un projet d’application console dans Visual Studio

Générer des types à liaison anticipée

Exécutez l’outil CrmSvcUtil.exe, avec l’extension « Microsoft.Xrm.Client.CodeGeneration »», pour générer vos classes d’entité et contextes de service. L’exemple de commande suivant crée un fichier nommé Xrm.cs qui pointe vers une instance de Microsoft Dynamics 365. Notez que le fichier Microsoft.Xrm.Client.CodeGeneration.dll doit se trouver dans le même répertoire que le fichier CrmSvcUtil.exe, ou dans le Global Assembly Cache du système, lorsque vous exécutez cette commande. La première commande indiquée s’applique à une organisation locale. La deuxième commande s’applique à une organisation CRM Online. Les deux commandes doivent être exécutées en tant que ligne de commande unique sans sauts de ligne.
```
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
```
Conseil

L’outil CrmSvcUtil est disponible dans le dossier Bin du téléchargement SDK ou en installant le package NuGetMicrosoft.CrmSdk.CoreTools.

Créer un projet d’application console dans Visual Studio

Créez un projet d’application console intitulé « ConsoleAppWalkthrough » Si le .NET Framework 4.5.2 n’est pas déjà installé, vous pouvez obtenir le pack développeur à partir de Installation du .NET Framework.
Ajoutez les références suivantes à partir du dossier SDK\bin. Vous pouvez ignorer cette étape et la suivante en installant simplement le package NuGetMicrosoft.CrmSdk.Extensions.
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
Ajoutez les références suivantes à partir du .NET.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
Assurez-vous que le projet de la console définit .NET Framework 4.5.2 comme l'infrastructure cible et pas comme profil client de .NET Framework 4.5.2. Cochez les propriétés du projet en sélectionnant le projet ConsoleAppWalkthrough dans l’Explorateur de solutions et en cliquant sur Alt+Entrée.
Cliquez avec le bouton droit sur le projet dans Visual Studio, cliquez sur Ajouter, puis cliquez sur Élément existant.
Sélectionnez le fichier « xrm.cs » créé lorsque vous avez généré les types à liaison anticipée.
Cliquez à nouveau avec le bouton droit sur votre projet, cliquez sur Ajouter, puis sur Nouvel élément.
Dans les options, sélectionnez Fichier de configuration de l’application, puis cliquez sur Ajouter.

Modifiez le fichier de configuration App.config avec votre chaîne de connexion spécifique.

<?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>

Ajoutez une instruction using à l’espace de noms que vous avez utilisé à l’étape 1, lors de la création du projet (« Xrm » dans cet exemple).

Ajoutez le code suivant à votre classe de programme :

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);
    }
}

Déboguez et testez la solution. Un contact est ainsi créé dans votre organisation Dynamics 365.

Voir aussi

Guide destiné aux développeurs du portail pour Microsoft Dynamics CRM 2015
Procédures pas-à-pas du portail pour Dynamics CRM 2015
Procédure pas à pas : créer une application Web qui se connecte à Microsoft Dynamics CRM 2015 à l’aide des extensions développeur

Partager via

Procédure pas à pas : créer une application console qui se connecte à Microsoft Dynamics CRM 2015 à l’aide des extensions développeur

Contenu de la rubrique

Générer des types à liaison anticipée

Créer un projet d’application console dans Visual Studio

Voir aussi

Ressources supplémentaires