Brug XRM-værktøjer for at oprette forbindelse til CRM
Udgivet: november 2016
Gælder for: Dynamics CRM 2015
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. Hver metodekald af et objekt af denne klasse anses for at være en atomisk enhed for arbejde, og alle opkald til Microsoft Dynamics 365 er trådsikre.
Dette emne indeholder
Opret forbindelse til CRM vha. OrganizationServiceProxy
Opret forbindelse til CRM Online (Live id)
Opret forbindelse til CRM Online (Office 365)
Opret forbindelse til CRM på stedet (Active Directory)
Opret forbindelse til CRM IFD (Internet-Facing Deployment).
Opret forbindelse til CRM (kravsbaseret)
Valgfrie parametre for konstruktører
Bestem din forbindelsesstatus
Opret forbindelse til CRM vha. OrganizationServiceProxy
Brug følgende konstruktør til at oprette forbindelse til CRM vha. den brugerangivne OrganizationServiceProxy-forekomst.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);
Opret forbindelse til CRM Online (Live id)
Brug følgende konstruktør.
CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");
Gyldige værdier for <CRMonlineRegion>-parameteren er: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 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.
Opret forbindelse til CRM Online (Office 365)
Brug følgende konstruktør.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);
Gyldige værdier for <CRMonlineRegion>-parameteren er: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 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.
Opret forbindelse til CRM på stedet (Active Directory)
Brug følgende konstruktør.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");
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.
Opret forbindelse til CRM IFD (Internet-Facing Deployment).
Brug følgende konstruktør.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");
Denne metode vil køre en kravsbaseret godkendelse på baggrund af den 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.
Opret forbindelse til CRM (kravsbaseret)
Brug følgende konstruktør.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");
Denne metode vil køre en kravsbaseret godkendelse mod det angivne hjemmedomæ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.
Valgfrie parametre for konstruktører
Disse er de valgfrie parametre, som du kan bruge sammen med hver af de tidligere konstruktører.
useUniqueInstance: Angiver, om du vil genbruge en eksisterende forbindelse, hvis tilbagekaldt, når forbindelsen er stadig aktiv. Standard er falsk. Hvis angivet til sand, tvinger det systemet til at oprette en entydig forbindelse.
useSSL: Angiver, om du vil bruge SSL til at oprette forbindelse til Dynamics 365. Standardværdien er false, dvs. brug http://. Hvis angivet til sand, bruges der https://.
orgDetail: Bruger NULL som standard. Hvis angivet, returneres det fra en forespørgsel til registreringstjenesten og bruges normalt som den anden del af udvælgelsesprocessen for en organisation.
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å
Brug PowerShell cmdlets for XRM-værktøjer til at oprette forbindelse til CRM
Bruge XRM-værktøjer til at udføre handlinger i CRM
Eksempel: Startvejledning til Microsoft Dynamics CRM
Opbygge Windows-klientprogrammer ved hjælp af XRM-værktøjerne
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret