Utilizzare gli strumenti XRM per la connessione a CRM
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
Per connettersi a Microsoft Dynamics 365, è necessario creare un'istanza della classe CrmServiceClient e quindi utilizzare uno dei costruttori per la connessione. Ogni chiamata al metodo da un oggetto di questa classe è considerata un'unità atomica di lavoro e tutte le chiamate a Microsoft Dynamics 365 sono thread-safe.
In questo argomento
Connettersi a CRM tramite OrganizationServiceProxy
Connettersi a CRM Online (Live ID)
Connettersi a CRM Online (Office 365)
Connettersi a CRM locale (Active Directory)
Connettersi a distribuzione con connessione Internet (IFD) di CRM
Connettersi a CRM (basato sulle attestazioni)
Parametri facoltativi per tutti i costruttori
Determinare lo stato della connessione
Connettersi a CRM tramite OrganizationServiceProxy
Utilizzare il costruttore seguente per la connessione a CRM mediante l'istanza di OrganizationServiceProxy fornita dall'utente.
CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);
Connettersi a CRM Online (Live ID)
Utilizzare il costruttore seguente:
CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");
I valori validi per il parametro <CRMonlineRegion> sono: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 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 CRM Online (Office 365)
Utilizzare il costruttore seguente:
CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);
I valori validi per il parametro <CRMonlineRegion> sono: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 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 CRM locale (Active Directory)
Utilizzare il costruttore seguente:
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");
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.
Connettersi a distribuzione con connessione Internet (IFD) di CRM
Utilizzare il costruttore seguente:
CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");
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.
Connettersi a CRM (basato sulle attestazioni)
Utilizzare il costruttore 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.
Parametri facoltativi per tutti i costruttori
Sono i parametri facoltativi che è possibile utilizzare con ogni costruttore mostrato in precedenza.
useUniqueInstance: Indica se riutilizzare una connessione esistente se richiamata mentre la connessione è ancora attiva. L'impostazione predefinita è false. Se impostato su true, forzerà il sistema a creare una connessione univoca.
useSSL: indica se utilizzare SSL per la connessione a Dynamics 365. Impostazioni predefinite su false, ovvero, utilizzare http://. Se impostato su true, utilizzerà https://.
orgDetail: Impostazioni predefinite su null. Se impostato, è restituito da una query al servizio di individuazione e viene in genere utilizzato come la seconda tappa di una procedura di selezione dell'organizzazione.
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
Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a CRM
Utilizzare strumenti XRM per eseguire azioni in CRM
Esempio - Guida introduttiva per Microsoft Dynamics CRM
Compilare applicazioni client di Windows tramite gli strumenti XRM
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright