Delen via

Eerder gebonden entiteitklassen maken met het hulpmiddel voor het genereren van code (CrmSvcUtil.exe)

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

CrmSvcUtil.exe is een hulpprogramma voor het genereren van opdrachtregelcode voor gebruik met Microsoft Dynamics 365 (online en on-premises). Dit hulpprogramma genereert eerder gebonden .NET Framework-klassen die het entiteitsgegevensmodel vertegenwoordigen dat wordt gebruikt door Microsoft Dynamics 365. U vindt dit hulpprogramma in het SDK-pakket in de map SDK\Bin. Download het Microsoft Dynamics CRM SDK-pakket.

In dit onderwerp

Over het hulpprogramma voor het genereren van code

Het hulpprogramma voor het genereren van code uitvoeren

Parameters

Gebruiksvoorbeelden

Het configuratiebestand gebruiken

Tracering inschakelen

Over het hulpprogramma voor het genereren van code

Het hulpprogramma CrmSvcUtil.exe maakt een Microsoft Visual C#- of Microsoft Visual Basic .NET-uitvoerbestand dat sterk-getypte klassen bevat voor entiteiten in uw organisatie. Dit omvat aangepaste entiteiten en kenmerken. Dit uitvoerbestand bevat één klasse voor elke entiteit, die eerdere binding en IntelliSense-ondersteuning biedt in Microsoft Visual Studio om u te helpen bij het schrijven van aangepaste code. De gegenereerde klassen zijn gedeeltelijke klassen die kunnen worden uitgebreid met aangepaste bedrijfslogica in aparte bestanden. U kunt ook uitbreidingen voor dit hulpprogramma maken. Zie Maak uitbreidingen voor het hulpprogramma voor codegeneratie voor meer informatie.

Dit hulpprogramma kan ook worden gebruikt om een klasse te genereren die wordt afgeleid van de klasse OrganizationServiceContext, die fungeert als een entiteitcontainer in het entiteitgegevensmodel. Deze service biedt de faciliteiten voor het bijhouden van wijzigingen en het beheren van identiteiten, gelijktijdigheid en relaties. Deze klasse maakt ook een SaveChanges-methode beschikbaar die records invoegt, bijwerkt en verwijdert in Microsoft Dynamics 365. Zie Gebruik de klasse OrganizationServiceContext voor meer informatie.

Het hulpprogramma voor het genereren van code gebruikt verschillende parameters die de inhoud bepalen van het bestand dat wordt gemaakt. De parameters kunnen worden doorgegeven vanaf de opdrachtregel wanneer u het hulpprogramma uitvoert, of in een .NET-verbonden toepassingsconfiguratiebestand.

De klassen die worden gemaakt door het hulpprogramma voor het genereren van code, kunnen worden ontworpen om te worden ingebouwd in een klassebibliotheek waarnaar kan worden verwezen door projecten die Microsoft Dynamics 365 gebruiken. Nadat u het klassebestand met het hulpprogramma hebt gegenereerd, moet u het bestand aan uw Visual Studio-project toevoegen. U moet ook verwijzingen naar verschillende assembly's toevoegen waarvan de gegenereerde klassen afhankelijk zijn.

Hierna volgen assembly's waarnaar in uw project moet worden verwezen wanneer u het gegenereerde codebestand gebruikt.

  • Microsoft.Crm.Sdk.Proxy.dll

  • Microsoft.Xrm.Sdk.dll

Deze assembly's zijn te vinden in de map SDK\Bin van de SDK. Download het Microsoft Dynamics CRM SDK-pakket.

Het hulpprogramma voor het genereren van code uitvoeren

Voer het hulpprogramma CrmSvcUtil.exe uit vanuit de map SDK\Bin. Als u het hulpprogramma vanuit een andere map uitvoert, moet u ervoor zorgen dat zich een kopie van de Microsoft.Xrm.Sdk.dll-assembly in dezelfde map bevindt.

In het volgende voorbeeld wordt de indeling weergegeven voor het uitvoeren van het hulpprogramma vanaf de opdrachtregel voor een on-premises distributie van Microsoft Dynamics 365. U levert de parameterwaarden voor uw installatie.

    CrmSvcUtil.exe /url:http://<serverName>/<organizationName>/XRMServices/2011/Organization.svc    /out:<outputFilename>.cs /username:<username> /password:<password> /domain:<domainName>    /namespace:<outputNamespace> /serviceContextName:<serviceContextName>

In het volgende voorbeeld wordt de indeling weergegeven voor het uitvoeren van het hulpprogramma van de opdrachtregel met Microsoft Dynamics 365 (online). U levert de parameterwaarden geschikt voor uw account en de server.

    CrmSvcUtil.exe /url:https://<organizationUrlName>.api.crm.dynamics.com/XRMServices/2011/Organization.svc    /out:<outputFilename>.cs /username:<username> /password:<password>     /namespace:<outputNamespace> /serviceContextName:<serviceContextName>

Typ voor de parameter username de gebruikersnaam die wordt gebruikt voor aanmelding bij Microsoft-account of Microsoft Office 365. U kunt de juiste URL in de webtoepassing vinden door Instellingen te selecteren, naar Aanpassingen te navigeren en vervolgens Resources voor ontwikkelaars te kiezen. De URL wordt weergegeven onder Organisatieservice.

Als u de ondersteunde opdrachtregelparameters wilt weergeven, gebruikt u de volgende opdracht.

    CrmSvcUtil.exe /?

Wanneer u het hulpprogramma voor Microsoft Dynamics 365 (online) uitvoert met de identiteitsprovider Microsoft-account, hoeft u de parameters deviceid en devicepassword niet meer op te geven vanaf de opdrachtregel. Het hulpprogramma registreert uw apparaat automatisch. U kunt uw apparaat echter handmatig registreren en waarden voor deze parameters verkrijgen door eerst het codevoorbeeld DeviceRegistration te compileren en uit te voeren, zoals hier beschreven.

Uw afzonderlijke apparaat-id en wachtwoord genereren

  1. Open en maak het DeviceRegistration-project: SDK\Tools\DeviceRegistration\DeviceRegistration.csproj.

  2. Voer het uitvoerbare bestand uit vanaf de opdrachtregel. Als u uw apparaat wilt registreren, stelt u de parameter /operation in op Register.

        C:\deviceregistration.exe /operation:Register

  3. Kopieer de weergegeven waarden voor de apparaat-id en het wachtwoord en gebruik ze als de parameterwaarden voor deviceid en devicepassword wanneer u het hulpprogramma CrmSvcUtil uitvoert.

Parameters

De onderstaande tabel toont de parameters van het hulpprogramma voor het genereren van code en geeft een korte beschrijving van hun gebruik.

Parameter

Snelkoppeling

Beschrijving

Vereist

deviceid

di

Apparaat-id die wordt gebruikt wanneer u verbinding maakt met de online-server voor verificatie. Alleen vereist als de apparaat-id niet op schijf is opgeslagen in de map %USERPROFILE%\LiveDeviceID. Alleen gebruikt met de identiteitsprovider Microsoft-account.

Onwaar

devicepassword

dp

Apparaatwachtwoord dat wordt gebruikt wanneer u verbinding maakt met de online-server voor verificatie. Alleen vereist als het apparaatwachtwoord niet op schijf is opgeslagen in de map %USERPROFILE%\LiveDeviceID. Alleen gebruikt met de identiteitsprovider Microsoft-account.

Onwaar

domain

d

Het domein waarmee moet worden geverifieerd als u verbinding maakt met de server.

Onwaar

url

De URL voor de organisatieservice.

Waar

out

o

De bestandsnaam voor de gegenereerde code.

Waar

language

l

De taal om de code in te genereren. Dit kan “CS” of “VB” zijn. De standaardwaarde is “CS”.

Onwaar

namespace

n

De naamruimte voor de gegenereerde code. De standaard is de algemene naamruimte.

Onwaar

username

u

De gebruikersnaam die moet worden gebruikt wanneer u verbinding maakt met de server voor verificatie.

Onwaar

wachtwoord

p

Het wachtwoord dat moet worden gebruikt wanneer u verbinding maakt met de server voor verificatie.

Onwaar

servicecontextname

De naam van de gegenereerde contextklasse van de organisatieservice. Als er geen waarde wordt opgegeven, wordt er geen servicecontext gemaakt.

Onwaar

help

?

Gebruiksinformatie weergeven.

Onwaar

nologo

De banner tijdens runtime onderdrukken.

Onwaar

generateActions

Aanvraag- en responsklassen genereren voor acties.

interactivelogin

il

Wanneer dit is ingesteld op waar, wordt een dialoogvenster weergegeven om u aan te melden bij de Dynamics 365-service. Alle overige verbindingsgerelateerde parameters die in de opdrachtregel zijn opgegeven worden genegeerd.

Onwaar

connectionstring

connstr

Bevat gegevens, in de vorm van één tekenreeks, voor het maken van verbinding met een Dynamics 365-organisatie. Alle overige verbindingsgerelateerde parameters die in de opdrachtregel zijn opgegeven worden genegeerd. Raadpleeg Verbinding maken met Dynamics 365 door middel van verbindingsreeksen in XRM-tooling voor meer informatie.

Onwaar

Gebruiksvoorbeelden

De volgende voorbeelden tonen hoe u het hulpmiddel voor het genereren van code vanaf de opdrachtregel gebruikt voor elk installatietype. De gebruikersnaam en het wachtwoord zijn optionele parameters. Als uw referenties voor de doel Microsoft Dynamics 365-server zijn opgeslagen in de Windows-referentiekluis, hoeft u ze niet op te geven om het hulpmiddel voor het genereren van code uit te voeren.

Claimsverificatie - Active Directory

Het volgende voorbeeld toont hoe u het hulpprogramma voor het genereren van code uitvoert met behulp van claimsverificatie in Active Directory. Let op het gebruik van HTTPS, omdat deze voorbeeldserver Transport Layer Security (TLS) of Secure Sockets Layer (SSL) gebruikt.

    CrmSvcUtil.exe /url:https://myport:555/MyOrg/XRMServices/2011/Organization.svc /out:GeneratedCode.cs
       /username:administrator /password:password

Microsoft Dynamics 365 (online)

Dit voorbeeld laat zien hoe u het hulpprogramma voor het genereren van code uitvoert voor Microsoft Dynamics 365 (online). Het eerste voorbeeld is voor de identiteitsprovider Microsoft-account en het tweede is voor de identiteitsprovider Office 365.

    CrmSvcUtil.exe /url:https://myorg.api.crm.dynamics.com/XRMServices/2011/Organization.svc    /out:GeneratedCode.cs /username:"myname@live.com" /password:"myp@ssword!" 

    CrmSvcUtil.exe /url:https://myorg.api.crm.dynamics.com/XRMServices/2011/Organization.svc    /out:GeneratedCode.cs /username:"myname@myorg.onmicrosoft.com" /password:"myp@ssword!"

Claimsverificatie - IFD

Het volgende voorbeeld toont hoe u het hulpprogramma voor het genereren van code uitvoert met behulp van claimsverificatie.

    CrmSvcUtil.exe /url:https://myorg.crm.com:555/XRMServices/2011/Organization.svc     /out:GeneratedCode.cs /username:administrator /password:p@ssword!

Het configuratiebestand gebruiken

Het CrmSvcUtil.exe.config-configuratiebestand moet zich in dezelfde map bevinden als het hulpprogramma CrmSvcUtil.exe. Het configuratiebestand gebruikt de standaardsleutel/waarde-paren in de sectie appSettings. Wanneer u echter een waarde invoert op de opdrachtregel, wordt die waarde gebruikt in plaats van de waarde in het configuratiebestand. Sleutel/waarde-paren die worden gevonden in het configuratiebestand van de toepassing en die niet overeenkomen met de verwachte parameters, worden genegeerd.

Neem de parameters url en namespace niet op in het configuratiebestand. Deze moeten vanaf de opdrachtregel worden ingevoerd als het hulpprogramma CrmSvcUtil.exe wordt uitgevoerd.

Het volgende voorbeeld toont hoe u de parameters voor het uitvoerbestand en de domeinnaam met sneltoetsen configureert in het toepassingsconfiguratiebestand.

<appSettings>    <add key="o" value="CrmProxy.cs"/>    <add key="d" value="mydomain"/></appSettings>

Tracering inschakelen

Als u tracering wilt inschakelen wanneer u het hulpprogramma uitvoert, voegt u de volgende regels aan het configuratiebestand toe:

<system.diagnostics> 
   <trace autoflush="false" indentsize="4"> 
      <listeners> 
         <add name="configConsoleListener" type="System.Diagnostics.ConsoleTraceListener"> 
            <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" /> 
         </add> 
      </listeners> 
   </trace> 
</system.diagnostics>

Zie Configureer tracering voor XRM tooling voor meer informatie over ondersteunde traceeropties.

Zie ook

Hulpmiddelen voor ontwikkelaars
Blader door de metagegevens voor uw organisatie
Maak uitbreidingen voor het hulpprogramma voor codegeneratie
Gebruik de eerder gebonden entiteitsklassen voor maken, bijwerken en verwijderen
Tips voor probleemoplossing
Een eenvoudig programma uitvoeren met Microsoft Dynamics 365-webservices

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht