Connessione semplificata a Microsoft Dynamics CRM 2015
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
Developer Extensions per Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 utilizza il concetto di una stringa di connessione per connettersi al server Microsoft Dynamics 365. È simile al concetto di stringhe di connessione utilizzate con Microsoft SQL Server. Le stringhe di connessione sono una parte naturale del framework ADO.NET e dispongono inoltre del supporto nativo nei file di configurazione, inclusa la possibilità di crittografare le sezioni di configurazione per la massima sicurezza. Questo incoraggia l'utilizzo di un modello affidabile in cui le connessioni Microsoft Dynamics 365 vengono configurate al momento della distribuzione e non sono hardcoded nell'applicazione. Pertanto, tutti le API in Developer Extensions per Microsoft Dynamics 365 funzionano con un oggetto CrmConnection utilizzato internamente dalla classe CrmOrganizationServiceContext come illustrato in questo argomento, il quale utilizza una stringa di connessione per connettersi al server.
Questa stringa di connessione deve essere inserita nel file app.config o web.config del progetto, come illustrato nell'esempio seguente.
<connectionStrings>
<add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
.jpeg "System_CAPS_security") Sicurezza Nota |
|---|
Se si aggiungono informazioni riservate al file app.config o web.config, ad esempio una password dell'account, assicurarsi di adottare le precauzioni di sicurezza appropriate per proteggerle. |
In questo argomento
Creare una stringa connessione
Parametri della stringa di connessione
Esempi di stringhe di connessione
Creare una stringa connessione
La stringa di connessione viene utilizzata per creare un'istanza dell'oggetto CrmConnection, che a sua volta è possibile utilizzare per creare un'istanza di un oggetto OrganizationService o di un oggetto CrmOrganizationServiceContext.
//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);
Una CrmConnection può inoltre essere creata indipendentemente dal file app.config e generata inline come illustrato di seguito.
var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");
Parametri della stringa di connessione
Il formato di base della stringa di connessione è uguale a quello di una stringa di connessione di OLEDB. Consiste in una serie di coppie nome/valore separate da punti e virgola. Nella tabella seguente sono elencati i parametri supportati, che possono essere immessi in qualsiasi ordine.
Nome parametro |
Descrizione |
|---|---|
Server, Url, or Service Uri |
Specifica l'URL per il server Microsoft Dynamics 365. L'URL può essere http o https e la porta è facoltativa se è http sulla porta 80 o https sulla porta 443. L'URL del server è in genere in formato di http:// crm-server: port/organization-name o del Microsoft Dynamics CRM Online di https:// organization-name.crm.dynamics.com. Il nome dell'organizzazione è obbligatorio. |
Domain |
Specifica il dominio che verifica le credenziali degli utenti. |
Username or User ID |
Specifica il nome di identificazione dell'utente associato con le credenziali. |
Password |
Specifica la password per il nome utente associato con le credenziali. |
Device ID or Device User Name |
Specifica l'identificatore del dispositivo per Account Microsoft definito dall'utente. Può essere qualsiasi stringa non vuota. Questo ID dispositivo verrà registrato con la password del dispositivo la prima volta che viene eseguita l'autenticazione. Se l'ID e la password del dispositivo non corrispondono ai valori registrati in precedenza, l'autenticazione non riuscirà. L'ID dispositivo ID si applica solo a CRM Online. |
Device Password |
Specifica la password del dispositivo per Account Microsoft definita dall'utente. Deve contenere almeno sei caratteri. Questa password verrà registrata con l'ID del dispositivo la prima volta che viene eseguita l'autenticazione. Se l'ID e la password del dispositivo non corrispondono ai valori registrati in precedenza, l'autenticazione non riuscirà. La password del dispositivo ID si applica solo a CRM Online. |
Timeout |
Viene passato alla proprietà Timeout della classe OrganizationServiceProxy. |
Home Realm Uri |
Viene passato alla proprietà HomeRealmUri della classe OrganizationServiceProxy. |
Tipi di proxy abilitati |
True per impostazione predefinita, questo parametro consente a OrganizationService di restituire i tipi di proxy anziché solo il tipo Entity di base. |
Proxy Types Assembly |
Specifica l'assembly contenente i tipi di proxy da Microsoft Dynamics 365, generato mediante lo strumento CrmSvcUtil.exe, con l'estensione Microsoft.Xrm.Client.CodeGeneration. |
Caller ID |
Viene passato alla proprietà CallerId della classe OrganizationServiceProxy. |
Service Configuration Instance Mode |
Può essere impostato su Static, PerName, PerRequest o PerInstance.PerName è l'impostazione predefinita; questo ottimizza il numero di volte in cui una IServiceConfiguration<TService> viene creata per un OrganizationService, in modo che per ciascuna stringa di connessione ne venga creata solo una. Per ulteriori informazioni su altri valori possibili, vedere Specificare l'attributo instanceMode. |
User Token Expiry Window |
Specifica un TimeSpan, hh:mm:ssformattato, utilizzato come offset quando viene recuperato un nuovo token utente. Ad esempio, se questo parametro è impostato su "00:10: 00 ", il nuovo token utente verrà recuperato 10 minuti prima dell'effettiva scadenza del token. |
Esempi di stringhe di connessione
Nel seguente esempio viene illustrata la stringa di connessione che utilizza l'autenticazione integrata locale.
Url=http://crm.contoso.com/xrmContoso;
Nel seguente esempio viene illustrata la stringa di connessione che utilizza l'autenticazione Active Directory.
Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode
Nel seguente esempio viene illustrata la stringa di connessione che utilizza Account Microsoft per connettersi a Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode
Nel seguente esempio viene illustrata la stringa di connessione che utilizza Microsoft Online Services per connettersi a Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;
Vedere anche
Esempio: avvio rapido semplificato di connessione con Microsoft Dynamics CRM
Estensioni per sviluppatori per Microsoft Dynamics CRM 2015
Generare il codice con le estensioni dello strumento di generazione del codice (Dynamics CRM 2015)
Procedure dettagliate dei portali per Dynamics CRM 2015
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright