Bruge forbindelsesstrenge i XRM-værktøj til at oprette forbindelse til Dynamics 365
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
I Microsoft Dynamics 365 (online og i det lokale miljø) kan du med XRM-værktøj oprette forbindelse til din Dynamics 365-forekomst ved hjælp af strenge. Dette minder om konceptet med forbindelsesstrenge, der bruges sammen med Microsoft SQL Server. Forbindelsesstrenge har også indbygget support i konfigurationsfiler, herunder muligheden for at kryptere konfigurationsafsnittene til maksimal sikkerhed. Dette gør det muligt at konfigurere Dynamics 365-forbindelser under installationen og ikke bruge hard code i dit program til at oprette forbindelse til din Dynamics 365-forekomst.
Dette emne indeholder
Oprette en forbindelsesstreng
Parametre for forbindelsesstreng
Eksempler på forbindelsesstrenge
Bestem din forbindelsesstatus
Oprette en forbindelsesstreng
Du angiver forbindelsesstrengen i filen app.config eller web.config for dit projekt, som vist i følgende eksempel.
<connectionStrings>
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</connectionStrings>
![]() |
---|
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. |
Når du har oprettet forbindelsesstrengen, kan du bruge den til at oprette er CrmServiceClient-objekt.
//Use the connection string named "MyCRMServer"
//from the configuration file
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);
Bemærk
Du skal bruge følgende using-direktiv i koden for at kunne henvise til System.Configuration-navneområdet for at få adgang til tilslutningsstrengen i din kode: using System.Configuration;
Når du har oprettet et CrmServiceClient-objekt, kan du bruge objektet til at udføre handlinger i Dynamics 365.Flere oplysninger:Bruge XRM-værktøjer til at udføre handlinger i Dynamics 365
Parametre for forbindelsesstreng
Forbindelsesstrengen indeholder en række name= value-par, der er adskilt af semikoloner. I følgende tabel vises understøttede parametre, som kan angives i vilkårlig rækkefølge.
Parameternavn |
Beskrivelse |
---|---|
ServiceUri, Service Uri, Url, or Server |
Angiver URL-adressen til Microsoft Dynamics 365 Server. URL-adressen kan bruge http- eller https-protokollen, og porten er valgfri. Standardporten er 80 for http-protokollen og 443 for https-protokollen. URL-adressen er typisk i formatet http://crm-server:port/organization-name for Dynamics 365 i det lokale miljø og https://organization-name.crm.dynamics.com til Dynamics 365 (online). Organisationsnavnet kræves. Du kan angive enten det fulde eller det entydige navn på organisationen, der skal oprettes forbindelse til. Eksempel: http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com eller http://10.10.10.2/test. |
Domain |
Angiver det domæne, der bekræfter brugerens legitimationsoplysninger. |
UserName, User Name, UserId, 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. |
HomeRealmUri eller Home Realm Uri |
Angiver Uri'en for startdomænet. |
AuthenticationType eller AuthType |
Angiver den godkendelsestype, der skal oprette forbindelse til Dynamics 365-forekomsten. Gyldige værdier er: AD, IFD (AD FS aktiveret), OAuth eller Office365.
|
RequireNewInstance |
Angiver, om du vil genbruge en eksisterende forbindelse, hvis tilbagekaldt, når forbindelsen er stadig aktiv. Standardværdien er false, der angiver, at den eksisterende forbindelse genbruges. Hvis angivet til true, tvinger det systemet til at oprette en entydig forbindelse. |
ClientId, AppId eller ApplicationId |
Angiver den ClientID, der blev tildelt, da du registrerede dit program i Microsoft Azure Active Directory eller Active Directory Federation Services (AD FS). Denne parameter gælder kun, når godkendelsestypen er angivet som OAuth. |
RedirectUri eller ReplyUrl |
Angiver omdirigerings-URI'en for det program, du registrerede i Microsoft Azure Active Directory eller Active Directory Federation Services (AD FS). Denne parameter gælder kun, når godkendelsestypen er angivet som OAuth. |
TokenCacheStorePath |
Angiver den fulde sti til den placering, hvor brugertokencachen skal gemmes. Den kørende proces skal have adgang til den angivne sti. Processen skal oprette og konfigurere denne sti. Denne parameter gælder kun, når godkendelsestypen er angivet som OAuth. |
LoginPrompt |
Angiver, om brugeren bliver bedt om legitimationsoplysninger, hvis legitimationsoplysningerne ikke er angivet. Gyldige værdier:
Denne parameter gælder kun, når godkendelsestypen er angivet som OAuth. |
Eksempler på forbindelsesstrenge
Følgende eksempler viser, hvordan du kan bruge forbindelsesstrenge for tilslutning til forskellige installationer og godkendelsesscenarier.
Integreret godkendelse i det lokale miljø
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
Navngivet konto med lokal godkendelse
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />
Navngivet konto med Office 365
<add name="MyCRMServer" connectionString="AuthType=Office365;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso.crm.dynamics.com"/>
Brug af OAuth og navngivet konto i Office 365 med UX, hvor der bedes om godkendelse
<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contosotest.crm.dynamics.com;AppId=<GUID>;RedirectUri =app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>
Brug af OAuth og navngivet konto i Dynamics 365 til det lokale miljø med UX, hvor der bedes om godkendelse
<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso:8080/Test;AppId=<GUID>;RedirectUri=app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>
IFD med en navngivet konto med uddelegering til et underdomæne
<add name="MyCRMServer" connectionString="AuthType=IFD;Url=http://contoso:8080/Test; HomeRealmUri=https://server-1.server.com/adfs/services/trust/mex/;Domain=CONTOSO; Username=jsmith; Password=passcode" />
Bestem din forbindelsesstatus
Hvis du skal afgøre, om forbindelsesanmodningen lykkedes, skal du kontrollere værdien af egenskaben CrmServiceClient.IsReady. Hvis sand, oprettes forbindelsen, og du er klar til at arbejde. I modsat fald kontrollere værdierne af egenskaberne CrmServiceClient. LastCrmError og CrmServiceClient.LastCrmException for årsagen til forbindelsesfejl.
Se også
CrmServiceClient
Opbygge Windows-klientprogrammer ved hjælp af XRM-værktøjerne
Bruge CrmServiceClient-konstruktører til at oprette forbindelse til Dynamics 365
Bruge XRM-værktøjer til at udføre handlinger i Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret