Del via

Opret klasser for tidligt bundne objekter med værktøjet til oprettelse af kode (CrmSvcUtil.exe)

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

CrmSvcUtil.exe er et værktøj til oprettelse af kommandolinjekode til brug sammen med Microsoft Dynamics 365 (online og i det lokale miljø). Værktøjet opretter tidligt bundne .NET Framework-klasser, der repræsenterer objektdatamodellen, som bruges af Microsoft Dynamics 365. Dette værktøj findes i SDK-pakken i mappen SDK\Bin. Hent SDK-pakken til Microsoft Dynamics CRM.

Dette emne indeholder

Om værktøjet til oprettelse af kode

Køre værktøjet til oprettelse af kode

Parametre

Eksempler på brug

Når indstillingen er satBrug konfigurationsfilen

Aktiver sporing

Om værktøjet til oprettelse af kode

Værktøjet CrmSvcUtil.exe opretter en Microsoft Visual C#- eller Microsoft Visual Basic .NET-outputfil, der indeholder typesikre klasser til objekter i organisationen. Dette omfatter brugerdefinerede objekter og attributter. Outputfilen indeholder én klasse for hvert objekt, hvilket giver tidlig binding og IntelliSense-understøttelse i Microsoft Visual Studio som hjælp, når du skriver brugerdefineret kode. De oprettede klasser er delte klasser, der kan udvides med brugerdefineret forretningslogik i separate filer. Du kan også oprette udvidelser til dette værktøj. Du kan finde flere oplysninger under Oprette udvidelser til værktøjet til oprettelse af kode.

Værktøjet kan også bruges til at oprette en klasse, der er afledt af klassen OrganizationServiceContext, der fungerer som en objektbeholder i objektdatamodellen. Denne servicekontekst indeholder faciliteter til registrering af ændringer og administration af identiteter, samtidighed og relationer. Denne klasse indeholder også en SaveChanges-metode, der skriver, indsætter, opdaterer og sletter poster i Microsoft Dynamics 365. Du kan finde flere oplysninger under Bruge klassen OrganizationServiceContext.

Værktøjet til oprettelse af kode indeholder mange parametre, der bestemmer indholdet af den fil, der oprettes. Parametrene, der kan overføres fra kommandolinjen, når du kører værktøjet, eller i en .NET-kompatibel programkonfigurationsfil.

De klasser, der oprettes af kodeoprettelsesværktøjet, er designet til at blive indbygget i et klassebibliotek, som projekter, der benytter Microsoft Dynamics 365, kan referere til. Når du har oprettet klassefilen ved hjælp af værktøjet, skal du føje filen til dit Visual Studio-projekt. Du skal også føje referencer til flere assemblyer, som de oprettede klasser er afhængige af.

De følgende lister over assemblyer, der refereres til i projektet, når du bruger den oprettede kodefil.

  • Microsoft.Crm.Sdk.Proxy.dll

  • Microsoft.Xrm.Sdk.dll

Disse assemblyer findes i mappen SDK\Bin i SDK. Hent SDK-pakken til Microsoft Dynamics CRM.

Køre værktøjet til oprettelse af kode

Kør værktøjet CrmSvcUtil.exe fra mappen SDK\Bin. Hvis du kører værktøjet fra en anden mappeplacering, skal du sørge for, at en kopi af assemblyen Microsoft.Xrm.Sdk.dll er i den samme mappe.

I følgende eksempel vises formatet for at køre værktøjet fra kommandolinjen til en lokal installation af Microsoft Dynamics 365. Du kan angive parameterværdierne for installationen.

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

Følgende eksempel viser formatet for at køre værktøjet fra kommandolinjen med Microsoft Dynamics 365 (online). Du kan angive de parameterværdier, der er relevante for dit firma og din 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>

For parameteren username skal du indtaste det brugernavn, der bruges til at logge på Microsoft-konto eller Microsoft Office 365. Du kan finde den korrekte URL-adresse i webprogrammet ved at vælge Indstillinger, navigere til Tilpasninger og derefter vælge Udviklerressourcer. URL-adressen vises under Organisationstjeneste.

Du kan få vist de kommandolinjeparametre, der understøttes, ved at bruge følgende kommando.

	CrmSvcUtil.exe /?

Når du kører værktøjet mod Microsoft Dynamics 365 (online) ved hjælp af Microsoft-konto-identitetsudbyderen, du behøver ikke længere at angive parametrene deviceid og devicepassword fra kommandolinjen. Værktøjet registrerer enheden automatisk. Dog kan du manuelt registrere enheden og hente værdierne for disse parametre ved første at kompilere og køre kodeeksemplet DeviceRegistration som beskrevet her.

Opret dit individuelle enheds-id og din adgangskode

  1. Åbn og opbyg DeviceRegistration-projektet: SDK\Tools\DeviceRegistration\DeviceRegistration.csproj.

  2. Kør den eksekverbare fil fra kommandolinjen. For at registrere din enhed skal du indstille parameteren /operation til Register.

    C:\deviceregistration.exe /operation:Register
  1. Kopiér de viste værdier for enheds-id'et og adgangskoden, og brug dem som parameterværdier for deviceid og devicepassword, når du kører værktøjet CrmSvcUtil.

Parametre

I følgende tabel vises parametrene for kodeoprettelsesværktøjet med en kort beskrivelse af deres brug.

Parameter

Genvej

Beskrivelse

Krævet

deviceid

di

Enheds-id bruges, når du opretter forbindelse til onlineserveren for godkendelse. Kun påkrævet, hvis enheds-id'et ikke er gemt på disken i mappen %USERPROFILE%\LiveDeviceID. Bruges kun sammen med Microsoft-konto-identitetsudbyderen.

Falsk

devicepassword

dp

Adgangskode til enheden, som bruges, når du opretter forbindelse til onlineserveren for godkendelse. Kun påkrævet, hvis adgangskoden til enheden ikke er gemt på disken i mappen %USERPROFILE%\LiveDeviceID. Bruges kun sammen med Microsoft-konto-identitetsudbyderen.

Falsk

domain

d

Det domæne, der skal godkendes mod, når du opretter forbindelse til serveren.

Falsk

url

URL-adressen til organisationstjenesten.

Sand

out

o

Filnavnet til den oprettede kode.

Sand

language

l

Det sprog, der bruges til at generere koden i. Dette kan enten være “CS” eller “VB”. Standardværdien er “CS”.

Falsk

namespace

n

Navneområdet for den oprettede kode. Standard er det globale navneområde.

Falsk

username

u

Det brugernavn, der skal bruges, når du opretter forbindelse til serveren for godkendelse.

Falsk

password

p

Den adgangskode, der skal bruges, når du opretter forbindelse til serveren for godkendelse.

Falsk

servicecontextname

Navnet på den oprettede servicekontekstklasse for organisationen. Hvis ingen værdi er angivet, oprettes der ikke nogen servicekontekst.

Falsk

help

?

Vis oplysninger om brug.

Falsk

nologo

Undertryk banner på kørselstidspunktet.

Falsk

generateActions

Opret anmodnings- og svarklasser for handlinger.

interactivelogin

il

Når indstillingen er sat true, vises en dialogboks for logon til Dynamics 365-tjenesten. Alle andre forbindelsesrelaterede parametre, der er angivet på kommandolinjen, ignoreres.

Falsk

connectionstring

connstr

Indeholder oplysninger, angivet som en enkelt streng, om oprettelse af forbindelse til en Dynamics 365-organisation. Alle andre forbindelsesrelaterede parametre, der er angivet på kommandolinjen, ignoreres. Du kan finde flere oplysninger i Bruge forbindelsesstrenge i XRM-værktøj til at oprette forbindelse til Dynamics 365.

Falsk

Eksempler på brug

Følgende eksempler viser, hvordan du bruger værktøjet til oprettelse af kode fra kommandolinjen for hver installationstype. Bemærk, at brugernavn og adgangskode er valgfri parametre. Hvis dine legitimationsoplysninger for Microsoft Dynamics 365-destinationsserveren gemmes i funktionen til styring af legitimationsoplysninger i Windows, du behøver ikke at angive dem for at køre værktøjet til oprettelse af kode.

Kravgodkendelse – Active Directory

I følgende eksempel vises, hvordan du kører værktøjet til oprettelse af kode ved hjælp af kravgodkendelse i Active Directory. Bemærk brugen af https, fordi eksempelserveren bruger TLS (Transport Layer Security) eller SSL (Secure Sockets Layer).

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

Microsoft Dynamics 365 (online)

I følgende eksempel vises, hvordan du kører værktøjet til oprettelse af kode for Microsoft Dynamics 365 (online). Det første eksempel er for Microsoft-konto-identitetsudbyderen, og andet er for Office 365-identitetsudbyderen.

    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!"

Kravgodkendelse – IFD

I følgende eksempel vises, hvordan du kører værktøjet til oprettelse af kode ved hjælp af kravgodkendelse.

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

Når indstillingen er satBrug konfigurationsfilen

Konfigurationsfilen CrmSvcUtil.exe.config skal være i samme mappe som værktøjet CrmSvcUtil.exe. Konfigurationsfilen bruger standardnøgle-/-værdiparret i afsnittet appSettings. Men hvis du angiver en værdi på kommandolinjen, bruges denne værdi i stedet for værdien i konfigurationsfilen. Et nøgle-/værdipar, som findes i programmets konfigurationsfil, og som ikke stemmer overens med nogen af de forventede parametre, ignoreres.

Omfatter ikke parametrene url og namespace i konfigurationsfilen. Disse skal angives fra kommandolinjen, når værktøjet CrmSvcUtil.exe begynder at køre.

I følgende eksempel vises, hvordan du konfigurerer outputfilens og domænenavnets parametre i programmets konfigurationsfil ved hjælp af genvejstaster.

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

Aktiver sporing

For at aktivere sporing, når du kører værktøjet, skal du føje følgende linjer til konfigurationsfilen:

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

Du kan finde flere oplysninger om understøttede sporingsindstillinger under Konfigurere sporing for XRM-værktøj.

Se også

Udviklerværktøjer
Gennemse metadata for organisationen
Oprette udvidelser til værktøjet til oprettelse af kode
Bruge de tidligt bundne objektklasser til oprettelse, opdatering og sletning
Tip til fejlfinding
Kørsel af et simpelt program ved hjælp af Microsoft Dynamics 365 webtjenester

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret