Forenklet forbindelse til Microsoft Dynamics CRM 2015

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Developer Extensions til Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015 bruger konceptet med en forbindelsesstreng til at oprette forbindelse til Microsoft Dynamics 365-serveren. Dette minder om konceptet med forbindelsesstrenge, der bruges sammen med Microsoft SQL Server. Forbindelsesstrenge er en naturlig del af ADO.NET-strukturen og har også indbygget support i konfigurationsfiler, herunder muligheden for at kryptere konfigurationsafsnittene til maksimal sikkerhed. Dette opfordrer dig til at bruge en robust model, hvor Microsoft Dynamics 365-forbindelser er konfigureret fra installationstidspunktet og ikke er hårdt kodet i dit program. Som sådan arbejder alle API'er i Developer Extensions til Microsoft Dynamics 365 med et CrmConnection-objekt, som bruges internt af klassen CrmOrganizationServiceContext som vist i dette emne, og som bruger en forbindelsesstreng til at oprette forbindelse til serveren.

Du kan angive forbindelsesstrengen i filen app.config eller web.config for dit projekt, som vist i følgende eksempel.

<connectionStrings>
  <add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>

Sikkerhed Bemærkning
Hvis du føjer alle følsomme oplysninger til filen app.config eller web.config, for eksempel en adgangskode, skal du sørge for at træffe passende sikkerhedsforanstaltninger for at beskytte oplysningerne.

Dette emne indeholder

Oprette en forbindelsesstreng

Parametre for forbindelsesstreng

Eksempler på forbindelsesstrenge

Oprette en forbindelsesstreng

Forbindelsesstrengen, der bruges til at oprette en forekomst af et CrmConnection -objekt, som igen kan bruges til at oprette en forekomst af et OrganizationService-objekt eller et CrmOrganizationServiceContext-objekt.

//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);

En CrmConnection kan også oprettes uafhængigt af filen app.config og konstrueres indbygget på følgende måde.

var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");

Parametre for forbindelsesstreng

Det grundlæggende format for forbindelsesstrengen er det samme som en OLEDB-forbindelsesstreng. Det er en række navne/værdipar adskilt af semikolon. I følgende tabel vises understøttede parametre, som kan angives i vilkårlig rækkefølge.

Parameternavn	Beskrivelse
Server, Url, or Service Uri	Angiver URL-adressen til Microsoft Dynamics 365-serveren. URL-adressen kan være http eller https, og porten er valgfri, hvis det er http via port 80 eller https over port 443. Serverens URL-adresse har typisk formatet http:// crm-server: port/organization-name eller til Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com. Organisationsnavnet kræves.
Domain	Angiver det domæne, der bekræfter brugerens legitimationsoplysninger.
Username or User ID	Angiver navnet på det bruger-id, der er knyttet til legitimationsoplysningerne.
Password	Angiver adgangskoden til det brugernavn, der er knyttet til legitimationsoplysningerne.
Device ID or Device User Name	Angiver det brugerdefinerede Microsoft-konto-enheds-id. Det kan være en tom streng. Dette enheds-ID skal registreres med enhedens adgangskode, første gang der køres en godkendelse. Hvis enheds-ID og adgangskode ikke svarer til de tidligere registrerede værdier, mislykkes godkendelsen. Enheds-id'et gælder kun for CRM Online.
Device Password	Angiver den brugerdefinerede Microsoft-konto-enhedsadgangskode. Den skal være på mindst seks tegn. Denne adgangskode skal registreres med enhedens ID, første gang der køres en godkendelse. Hvis enheds-ID og adgangskode ikke svarer til de tidligere registrerede værdier, mislykkes godkendelsen. Enhedsadgangskoden gælder kun for CRM Online.
Timeout	Bliver sendt til egenskaben Timeout for klassen OrganizationServiceProxy.
Home Realm Uri	Bliver sendt til egenskaben HomeRealmUri for klassen OrganizationServiceProxy.
Proxy-typer, der er aktiveret	True Denne parameter aktiverer som standard OrganizationService til at returnere proxy-datatyper i stedet for blot den grundlæggende Entity-type.
Proxy Types Assembly	Angiver den assembly, der indeholder proxytyperne fra Microsoft Dynamics 365, der er genereret ved hjælp af værktøjet CrmSvcUtil.exe med udvidelsen Microsoft.Xrm.Client.CodeGeneration.
Caller ID	Bliver sendt til egenskaben CallerId for klassen OrganizationServiceProxy.
Service Configuration Instance Mode	Kan angives til Static, PerName, PerRequest eller PerInstance.PerName er standard. ette optimerer antallet af gange, en IServiceConfiguration<TService> vil blive oprettet for en OrganizationService, så der kun oprettes én for hver forbindelsesstreng. Du kan finde flere oplysninger om andre mulige værdier i Angiv attributten instanceMode.
User Token Expiry Window	Angiver en TimeSpan, formateret hh:mm:ss, som anvendes som en forskydning, for når der hentes et nyt bruger-token. Hvis denne parameter er indstillet til "00:10:00", bliver der hentet et nyt bruger-token 10 minutter, før tokenet faktisk udløber.

Eksempler på forbindelsesstrenge

Følgende eksempel viser den forbindelsesstreng, der bruger integreret lokal godkendelse.

Url=http://crm.contoso.com/xrmContoso;

Følgende eksempel viser den forbindelsesstreng, der bruger Active Directory godkendelse.

Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode

Følgende eksempel viser den forbindelsesstreng, der bruger Microsoft-konto til at oprette forbindelse til Microsoft Dynamics CRM Online...

Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode

Følgende eksempel viser den forbindelsesstreng, der bruger Microsoft Online Services til at oprette forbindelse til Microsoft Dynamics CRM Online.

Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode; 

Se også

Eksempel: Forenklet forbindelse for hurtig start ved hjælp af Microsoft Dynamics CRM
Udviklerudvidelser til Microsoft Dynamics CRM 2015
Oprette kode med udvidelserne til kodeoprettelsesværktøjet (Dynamics CRM 2015)
Portalgennemgange til Dynamics CRM 2015

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret