Del via


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

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.

  • AD og IFD er kun tilladt for Dynamics 365-forekomster i det lokale miljø.

  • OAuth er tilladt for Dynamics 365 (online) og forekomster i det lokale miljø.

  • Office365 er kun tilladt for Dynamics 365 (online)-forekomster.

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:

  • Always: Beder altid brugeren om at angive legitimationsoplysninger.

  • Auto: Gør det muligt for dig som bruger at vælge, om prompten skal vises i grænsefladen til logonkontrolelementet.

  • Never: Beder ikke brugeren om at angive legitimationsoplysninger. Hvis der ikke er en brugergrænseflade i den forbindelsesmetode, der bruges, skal du bruge denne værdi.

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;" />
<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />
<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