Bruge CrmServiceClient-konstruktører 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
Hvis du skal oprette forbindelse til Microsoft Dynamics 365, skal du oprette en forekomst af CrmServiceClient-klassen, og benyt derefter en af konstruktører til at oprette forbindelse. Alle opkald til Dynamics 365 ved hjælp af CrmServiceClient-klasse er trådsikre.
Ud over de konstruktører, der er nævnt i dette emne, kan du også bruge forbindelsesstrenge med CrmServiceClient til at oprette forbindelse til Dynamics 365.Flere oplysninger:Bruge forbindelsesstrenge i XRM-værktøj til at oprette forbindelse til Dynamics 365
Dette emne indeholder
Oprette forbindelse til Dynamics 365 ved hjælp af OrganizationServiceProxy
Oprette forbindelse til Dynamics 365 ved hjælp af OrganizationWebProxyClient
Oprette forbindelse til Dynamics 365 (online) (Office 365)
Oprette forbindelse til Dynamics 365 (online) (Office 365) vha. OAuth
Oprette forbindelse til Dynamics 365 (online) til det lokale miljø (Active Directory)
Oprette forbindelse til Dynamics 365 IFD (Internet-Facing Deployment)
Oprette forbindelse til Dynamics 365 IFD (Internet-Facing Deployment) vha. OAuth
Oprette forbindelse til Dynamics 365 (kravsbaseret)
Bestem din forbindelsesstatus
Oprette forbindelse til Dynamics 365 ved hjælp af OrganizationServiceProxy
Brug følgende konstruktør til at oprette forbindelse til Dynamics 365 vha. den brugerangivne OrganizationServiceProxy-forekomst.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);
Oprette forbindelse til Dynamics 365 ved hjælp af OrganizationWebProxyClient
Brug følgende konstruktør til at oprette forbindelse til Dynamics 365 vha. den brugerangivne OrganizationWebProxyClient-forekomst. Denne konstruktør er introduceret i Microsoft Dynamics 365 (online og i det lokale miljø).
CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);
Oprette forbindelse til Dynamics 365 (online) (Office 365)
Brug følgende konstruktør til at oprette forbindelse til din Dynamics 365 (online)-forekomst i Office 365.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);
Gyldige værdier for <CrmRegion>-parametrene er: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND og NorthAmerica2. Hvis du angiver denne til String.Empty, søges der på servere i alle regioner for Dynamics 365-organisationen. For <OrgName>-parameteren, kan du angive det entydige eller fulde navn.
Følgende parametre er valgfri: useUniqueInstance, useSsl og orgDetail.
Oprette forbindelse til Dynamics 365 (online) (Office 365) vha. OAuth
Brug følgende konstruktør for at bruge OAuth-protokollen til at oprette forbindelse til din Dynamics 365 (online)-forekomst i Office 365.OAuth-supporten er introduceret i Microsoft Dynamics 365 (online og i det lokale miljø).
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
<userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);
Denne konstruktør bruger Microsoft Azure Active Directory Authentication Library (ADAL) til at godkende brugere. Hvis der ikke er angivet legitimationsoplysninger (brugernavn og adgangskode), beder ADAL brugeren om at angive legitimationsoplysningerne, afhængigt af PromptBehavior-parameteren (valgfrit), der angivet i konstruktøren. ADAL godkender legitimationsoplysningerne ved hjælp af OAuth-protokollen, får adgang til og opdaterer tokener fra Azure Active Directory, og bruger derefter adgangstokenen til at foretage anmodninger til Dynamics 365.
Gyldige værdier for <CrmRegion>-parameteren er: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND og NorthAmerica2. Hvis du angiver denne til String.Empty, søges der på servere i alle regioner for Dynamics 365-organisationen. For <OrgName>-parameteren, kan du angive det entydige eller fulde navn.
Oprette forbindelse til Dynamics 365 (online) til det lokale miljø (Active Directory)
Brug følgende konstruktør til at oprette forbindelse til en lokal forekomst med Active Directory-godkendelse.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
Det vil køre en Active Directory-godkendelse baseret på det angivne domæne. For <Server>-parameteren skal du angive værtsnavnet på din Dynamics 365-server, f.eks.: crmtest. For <OrgName>-parameteren, kan du angive det entydige eller fulde navn.
Følgende parametre er valgfri: useUniqueInstance, useSsl og orgDetail.
Oprette forbindelse til Dynamics 365 IFD (Internet-Facing Deployment)
Brug følgende konstruktør til at oprette forbindelse til din Dynamics 365 IDF-forekomst.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
Denne metode kører en kravsbaseret godkendelse på baggrund af det angivne lokale domæne. Det er nyttigt for kunder, der bruger AD FS, og har konfigureret deres Dynamics 365-server som fordringer, hvor befolkningen bor i den samme AD FS-domæne som Dynamics 365-serveren. For <Server>-parameteren skal du angive værtsnavnet på din Dynamics 365-server, f.eks. crmtest. For <OrgName>-parameteren, kan du angive det entydige eller fulde navn.
Følgende parametre er valgfri: useUniqueInstance, useSsl og orgDetail.
Oprette forbindelse til Dynamics 365 IFD (Internet-Facing Deployment) vha. OAuth
Brug følgende konstruktør til at bruge OAuth-protokollen i Active Directory Federation Services (AD FS) i Windows Server 2012 R2 for at oprette forbindelse til en Dynamics 365 IFD-forekomst. For at denne konstruktør skal fungere, skal computeren, hvor Microsoft Dynamics 365 Server er installeret, være konfigureret til at bruge AD FS 2.2 som sikkerhedstokentjenesten (STS).OAuth-supporten til at oprette forbindelse til en Dynamics 365 IFD-forekomst er introduceret i Dynamics 365.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<HomeRealm>", "<HostName>", "<Port>", "<OrgName>", useSsl:true, useUniqueInstance:false,
<orgDetail>, <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, externalOrgWebProxyClient, PromptBehavior.Auto);
clientId- og redirectUri-værdierne for det program, der understøtter OAuth skal registreres i IFD-serveren.
Hvis der ikke er angivet legitimationsoplysninger (brugernavn og adgangskode), beder ADAL brugeren om at angive legitimationsoplysningerne, afhængigt af PromptBehavior-parameteren (valgfrit), der angivet i konstruktøren. ADAL godkender brugeren ved hjælp af sikkerhedstokenet fra AD FS, og bruger tokenet til at udføre handlinger i Dynamics 365.
Oprette forbindelse til Dynamics 365 (kravsbaseret)
Benyt følgende konstruktør til at bruge kravsbaseret godkendelse.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");
Denne metode kører en kravsbaseret godkendelse mod det angivne startdomæne. Det er nyttigt for kunder, der bruger AD FS, og har konfigureret deres Dynamics 365-server som fordringer, hvor befolkningen bor i den samme AD FS-domæne som Dynamics 365-serveren. For <Server>-parameteren skal du angive værtsnavnet på din Dynamics 365-server, f.eks. crmtest. For <OrgName>-parameteren, kan du angive det entydige eller fulde navn.
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 skal du kontrollere værdierne i CrmServiceClient.LastCrmError og CrmServiceClient.LastCrmException-egenskaber for årsagen til forbindelsesfejlen.
Se også
AuthenticationType
Bruge forbindelsesstrenge i XRM-værktøj til at oprette forbindelse til Dynamics 365
Brug PowerShell cmdlets for XRM-værktøjer til at oprette forbindelse til Dynamics 365
Bruge XRM-værktøjer til at udføre handlinger i Dynamics 365
Eksempel: Startvejledning til Microsoft Dynamics 365
Opbygge Windows-klientprogrammer ved hjælp af XRM-værktøjerne
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret