Overzicht: Een consoletoepassing maken die verbinding met Microsoft Dynamics CRM 2015 maakt met behulp van uitbreidingen voor ontwikkelaars

Artikel
07/06/2017

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Dit overzicht laat zien hoe u een eenvoudige consoletoepassing kunt schrijven die verbinding met Microsoft Dynamics CRM 2015 maakt via uitbreidingen voor ontwikkelaars en een contactpersoonrecord maakt.

U vindt de voorbeeldcode die dit overzicht produceert, in de map Walkthroughs\Portal\ConsoleAppWalkthrough.

In dit onderwerp

Eerder gebonden typen maken

Een nieuw consoletoepassingsproject maken in Visual Studio

Eerder gebonden typen maken

Voer het hulpprogramma CrmSvcUtil.exe met de uitbreiding “Microsoft.Xrm.Client.CodeGeneration” uit om uw entiteitklassen en servicecontexten te genereren. Hieronder volgt een voorbeeldopdracht voor het maken van een bestand met de naam Xrm.cs dat verwijst naar een exemplaar van Microsoft Dynamics 365. Houd er rekening mee dat het bestand Microsoft.Xrm.Client.CodeGeneration.dll zich in dezelfde map moet bevinden als het bestand CrmSvcUtil.exe, of in de algemene assemblycache van het systeem, wanneer u deze opdracht uitvoert. De eerste weergegeven opdracht is voor een on-premises organisatie. De tweede opdracht is voor een CRM Online-organisatie. Beide opdrachten moeten worden uitgevoerd als één opdrachtregel zonder regeleinden.
```
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
```
Tip

Het hulpmiddel CrmSvcUtil is beschikbaar in de map Bin van de SDK-download of door het pakket Microsoft.CrmSdk.CoreToolsNuGet te installeren.

Een nieuw consoletoepassingsproject maken in Visual Studio

Maak een nieuwe consoletoepassing genaamd “ConsoleAppWalkthrough”. Als u de .NET Framework 4.5.2 nog niet hebt geïnstalleerd, kunt u het Ontwikkelaarpakket verkrijgen uit .NET Framework installeren.
Voeg de volgende referenties uit de map SDK\bin toe. U kunt deze stap en de volgende overslaan door het pakket Microsoft.CrmSdk.ExtensionsNuGet eenvoudig te installeren.
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
Voeg de volgende referenties uit .NET toe.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
Controleer of het consoleproject .NET Framework 4.5.2 als doel-framework opgeeft en niet .NET Framework 4.5.2-clientprofiel. Controleer de eigenschappen van het project door in de Oplossingenverkenner het project ConsoleAppWalkthrough te selecteren en op Alt-Enter te klikken.
Klik met de rechtermuisknop op het project in Visual Studio, klik op Toevoegen en klik vervolgens op Bestaand item.
Selecteer het bestand "xrm.cs" dat u hebt gemaakt toen u de eerder gebonden typen genereerde.
Klik met de rechtermuisknop opnieuw op uw project, klik op Toevoegen en klik vervolgens op Nieuw item.
Selecteer Toepassingsconfiguratiebestand uit de opties en klik vervolgens op Toevoegen.

Bewerk het configuratiebestand App.config met uw specifieke verbindingsreeks.

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

Voeg een gebruiksinstructie toe aan de naamruimte die u in Stap 1 hebt gebruikt bij het maken van het project (in dit voorbeeld "Xrm").

Voeg de volgende code toe aan uw programmaklasse:

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

Debug en test de oplossing. Hiermee wordt een contactpersoon in uw Dynamics 365-organisatie gemaakt.

Zie ook

Portalontwikkelingshandleiding voor Microsoft Dynamics CRM 2015
Portaloverzichten voor Dynamics CRM 2015
Overzicht: Een webtoepassing maken die verbinding met Microsoft Dynamics CRM 2015 maakt met behulp van uitbreidingen voor ontwikkelaars

Delen via

Overzicht: Een consoletoepassing maken die verbinding met Microsoft Dynamics CRM 2015 maakt met behulp van uitbreidingen voor ontwikkelaars

In dit onderwerp

Eerder gebonden typen maken

Een nieuw consoletoepassingsproject maken in Visual Studio

Zie ook

Aanvullende resources