Usare i costruttori di CrmServiceClient per connettere a Dynamics 365
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Per connettersi a Microsoft Dynamics 365, è necessario creare un'istanza della classe CrmServiceClient e quindi utilizzare uno dei costruttori per la connessione. Tutte le chiamate a Dynamics 365 che usano la classe CrmServiceClient sono thread-safe.
Oltre ai costruttori indicati in questa sezione, è possibile utilizzare stringhe di connessione con CrmServiceClient per la connessione a Dynamics 365.Ulteriori informazioni:Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365
In questo argomento
Connettersi a Dynamics 365 tramite OrganizationServiceProxy
Connettersi a Dynamics 365 tramite OrganizationWebProxyClient
Connettersi a Dynamics 365 (online) (Office 365)
Connettersi a Dynamics 365 (online) (Office 365) tramite OAuth
Connettersi a Dynamics 365 locale (Active Directory)
Connettersi a una distribuzione con connessione Internet di Dynamics 365 (IFD)
Connettersi a una distribuzione con connessione Internet di Dynamics 365 (IFD) tramite OAuth
Connettersi a Dynamics 365 (basato sulle attestazioni)
Determinare lo stato della connessione
Connettersi a Dynamics 365 tramite OrganizationServiceProxy
Utilizzare il costruttore seguente per la connessione a Dynamics 365 mediante l'istanza di OrganizationServiceProxy fornita dall'utente.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);
Connettersi a Dynamics 365 tramite OrganizationWebProxyClient
Utilizzare il costruttore seguente per la connessione a Dynamics 365 mediante l'istanza di OrganizationWebProxyClient fornita dall'utente. Questo costruttore è introdotto in Microsoft Dynamics 365 (online e locale).
CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);
Connettersi a Dynamics 365 (online) (Office 365)
Utilizzare l'elenco seguente di costruttori per la connessione all'istanza Dynamics 365 (online) in Office 365.
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);
Valori validi il parametro <CrmRegion> sono: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND e NorthAmerica2. Se si imposta questo parametro su String.Empty, cercherà i server in tutte le aree per l'organizzazione Dynamics 365. Per il parametro <OrgName>, è possibile specificare sia il nome univoco che il nome descrittivo.
I parametri seguenti sono facoltativi: useUniqueInstance, useSsl e orgDetail.
Connettersi a Dynamics 365 (online) (Office 365) tramite OAuth
Utilizzare l'elenco seguente di costruttori per usare il protocollo OAuth per la connessione all'istanza Dynamics 365 (online) in Office 365. Il supporto OAuth è introdotto in Microsoft Dynamics 365 (online e locale).
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
<userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);
Questo costruttore usa Microsoft Azure Active Directory Authentication Library (ADAL) per autenticare gli utenti. Se le credenziali utente (nome utente e password) non sono specificate, ADAL chiede all'utente di fornire le credenziali nel parametro PromptBehavior (facoltativo) specificato nell costruttore. ADAL autentica le credenziali tramite il protocollo OAuth, ottiener l'accesso e aggiorna i token Azure Active Directory e quindi utilizza il token di accesso per apportare richieste a Dynamics 365.
I valori validi per il parametro <CrmRegion> sono NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND e NorthAmerica2. Se si imposta questo parametro su String.Empty, cercherà i server in tutte le aree per l'organizzazione Dynamics 365. Per il parametro <OrgName>, è possibile specificare sia il nome univoco che il nome descrittivo.
Connettersi a Dynamics 365 locale (Active Directory)
Utilizzare l'elenco seguente di costruttori per connettersi all'istanza locale con l'autenticazione Active Directory.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
Questo processo eseguirà un'autenticazione di Active Directory basata sul dominio specificato. Per il parametro <Server>, specificare il nome host del server Dynamics 365; ad esempio: crmtest. Per il parametro <OrgName>, è possibile specificare sia il nome univoco che il nome descrittivo.
I parametri seguenti sono facoltativi: useUniqueInstance, useSsl e orgDetail.
Connettersi a una distribuzione con connessione Internet di Dynamics 365 (IFD)
Utilizzare l'elenco seguente di costruttori per la connessione all'istanza IFD Dynamics 365.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);
Questo metodo eseguirà un'autenticazione basata sulle attestazioni in base al dominio locale specificato. Ciò è utile per gli utenti che utilizzano AD FS e hanno configurato i propri server Dynamics 365 come attestazioni, in cui la popolazione degli utenti vive nello stesso dominio AD FS del server Dynamics 365. Per il parametro <Server>, specificare il nome host del server Dynamics 365; ad esempio: crmtest. Per il parametro <OrgName>, è possibile specificare sia il nome univoco che il nome descrittivo.
I parametri seguenti sono facoltativi: useUniqueInstance, useSsl e orgDetail.
Connettersi a una distribuzione con connessione Internet di Dynamics 365 (IFD) tramite OAuth
Utilizzare l'elenco seguente di costruttori per usare il protocollo OAuth in Active Directory Federation Services (ADFS) in Windows Server 2012 R2 per la connessione all'istanza IFD Dynamics 365. Affinché questo costruttore funzioni, il computer in cui è installato Server Microsoft Dynamics 365 deve essere configurato l'utilizzo di AD FS 2.2 come servizio token di sicurezza (STS). Il supporto di OAuth per la connessione all'istanza IFD Dynamics 365 è introdotto in 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);
I valori clientId e redirectUri per il supporto dell'applicazione OAuth devono essere registrati nel server IFD.
Se le credenziali utente (nome utente e password) non sono specificate, ADAL chiede all'utente di fornire le credenziali nel parametro PromptBehavior (facoltativo) specificato nell costruttore. ADAL autentica gli utenti che utilizzano il token di sicurezza AD FS e utilizza il token per eseguire azioni in Dynamics 365.
Connettersi a Dynamics 365 (basato sulle attestazioni)
Per disabilitare l'autenticazione basata sul costruttore utilizzare la procedura seguente.
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");
Questo metodo eseguirà un'autenticazione basata sulle attestazioni rispetto all'area di autenticazione principale specificata. Ciò è utile per gli utenti che utilizzano AD FS e hanno configurato i propri server Dynamics 365 come attestazioni, in cui la popolazione degli utenti vive nello stesso dominio AD FS del server Dynamics 365. Per il parametro <Server>, specificare il nome host del server Dynamics 365; ad esempio: crmtest. Per il parametro <OrgName>, è possibile specificare sia il nome univoco che il nome descrittivo.
Determinare lo stato della connessione
Per determinare se la richiesta di connessione è riuscita, controllare il valore della proprietà CrmServiceClient.IsReady. Se true, la connessione ha esito positivo e si è pronti per l'utilizzo. In caso contrario, verificare i valori di CrmServiceClient. proprietà LastCrmError e CrmServiceClient.LastCrmException per la causa dell'errore di connessione.
Vedere anche
AuthenticationType
Utilizzare le stringhe di connessione negli strumenti XRM per connettersi a Dynamics 365
Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a Dynamics 365
Utilizzare strumenti XRM per eseguire azioni in Dynamics 365
Esempio - Guida introduttiva per Microsoft Dynamics 365
Compilare applicazioni client di Windows tramite gli strumenti XRM
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright