Vereenvoudigde verbinding met Microsoft Dynamics CRM 2015
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
De uitbreidingen voor ontwikkelaars Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update maken gebruik van het concept van een verbindingsreeks om de Microsoft Dynamics 365 - server te verbinden. Dit is vergelijkbaar met het concept verbindingsreeksen die met Microsoft SQL Server worden gebruikt. Verbindingsreeksen zijn een natuurlijk deel van het ADO.NET-framework en hebben ook standaard ondersteuning in configuratiebestanden, inclusief de mogelijkheid om de configuratiesecties voor maximumbeveiliging te versleutelen. Dit stimuleert u om een robuust model gebruiken waarbij Microsoft Dynamics 365-verbindingen op de implementatietijd worden geconfigureerd, en niet hard zijn gecodeerd in uw toepassing. Als zodanig werken alle API's in uitbreidingen voor ontwikkelaars voor Microsoft Dynamics 365 met een CrmConnection object, intern gebruikt door de klasse CrmOrganizationServiceContext zoals aangegeven in dit onderwerp, die een verbindingsreeks gebruikt op de server.
U levert deze verbindingsreeks in het app.config of web.config bestand voor het project, zoals aangegeven in het volgende voorbeeld.
<connectionStrings>
<add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
.jpeg "System_CAPS_security") Beveiliging Opmerking |
|---|
Als mogelijk ook gevoelige informatie aan het app.config of web.config bestand toevoegt, bijvoorbeeld een accountwachtwoord, zorg dan dat u beveiligingvoorzorgsmaatregelen treft om de informatie te beveiligen. |
In dit onderwerp
Een verbindingsreeks maken
Verbindingsreeksparameters
Voorbeelden van verbindingsreeksen
Een verbindingsreeks maken
De verbindingsreeks wordt gebruikt om een CrmConnection een object te instaniëren, dat op zijn beurt ook kan worden gebruikt om een OrganizationService object of een CrmOrganizationServiceContext object te instaniëren.
//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);
Een CrmConnection kan ook afzonderlijk van het app.config bestand en geconstrueerde in de regel als volgt worden gemaakt.
var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");
Verbindingsreeksparameters
De basisindeling van de verbindingsreeks is hetzelfde als een OLEDB verbindingsreeks. Het is een reeks naam/waarde-paren gescheiden door puntkomma's. De volgende tabel bevat een overzicht van ondersteunde parameters, die in elke gewenste volgorde kunnen worden ingevoerd.
Parameternaam |
Beschrijving |
|---|---|
Server, Url, or Service Uri |
Hiermee wordt de URL aan de Microsoft Dynamics 365-server opgegeven. De URL kan http of https zijn en de poort is optioneel bij http boven poort 80 of https boven poort 443. De server-URL heeft doorgaans de indeling http:// crm-server: port/organization-name of voor Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com. De naam van de organisatie is vereist. |
Domain |
Specificeert het domein dat gebruikersreferenties verifieert. |
Username or User ID |
Specificeert de identificatienaam van de gebruiker gekoppeld aan de referenties. |
Password |
Specificeert het wachtwoord voor de gebruikersnaam gekoppeld aan de referenties. |
Device ID or Device User Name |
Specificeert de door de gebruiker gedefinieerde Microsoft-account-apparaat-id. Dit kan elke niet-lege tekenreeks zijn. Dit apparaat-id wordt geregistreerd met het wachtwoord de eerste keer dat een verificatie wordt uitgevoerd. Als het apparaat-id en het wachtwoord niet met de eerder geregistreerde waarden overeenkomen, mislukt de verificatie. De apparaat-id geldt alleen voor CRM Online. |
Device Password |
Specificeert het door de gebruiker gedefinieerde Microsoft-account-apparaatwachtwoord. Het moet minimaal zes tekens lang zijn. Dit wachtwoord wordt geregistreerd met het apparaat-ID de eerste keer dat een verificatie wordt uitgevoerd. Als het apparaat-id en het wachtwoord niet met de eerder geregistreerde waarden overeenkomen, mislukt de verificatie. Het apparaatwachtwoord geldt alleen voor CRM Online. |
Timeout |
Wordt doorgestuurd naar de eigenschap Timeout van de klasse OrganizationServiceProxy. |
Home Realm Uri |
Wordt doorgestuurd naar de eigenschap HomeRealmUri van de klasse OrganizationServiceProxy. |
Proxyservertypen ingeschakeld |
True standaard, deze parameter staat OrganizationService toe om proxyservertypen in plaats van alleen het basis Entity-type te vinden. |
Proxy Types Assembly |
Specificeert de assembly die de proxyservertypen van Microsoft Dynamics 365, gegenereerd met behulp van het CrmSvcUtil.exe hulpprogramma, bevat met de extensie Microsoft.Xrm.Client.CodeGeneration. |
Caller ID |
Wordt doorgestuurd naar de eigenschap CallerId van de klasse OrganizationServiceProxy. |
Service Configuration Instance Mode |
Kan worden ingesteld op Static, PerName, PerRequest of PerInstance.PerName wordt standaard weergegeven; dit optimaliseert het aantal keren dat een IServiceConfiguration<TService> voor een OrganizationService wordt gemaakt, zodat er maar één voor elke verbindingsreeks wordt gemaakt. Voor meer informatie over andere mogelijke waarden, raadpleegt u Het kenmerk instanceMode opgeven. |
User Token Expiry Window |
Specificeert een TimeSpan, opgemaakt hh:mm:ss, die wordt gebruikt als afwijking wanneer een nieuwe gebruikerstoken wordt opgehaald. Bijvoorbeeld, als deze parameer is ingesteld op "00:10:00", zal een nieuwe gebruikervolgtoken 10 minuten voordat het token werkelijk is verlopen worden opgehaald. |
Voorbeelden van verbindingsreeksen
Het volgende voorbeeld toont de verbindingsreeks met geïntegreerde on-premises-verificatie.
Url=http://crm.contoso.com/xrmContoso;
Het volgende voorbeeld toont de verbindingsreeks met Active Directory-verificatie.
Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode
Het volgende voorbeeld toont de verbindingsreeks met Microsoft-account om verbinding te maken met Microsoft Dynamics CRM Online…
Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode
Het volgende voorbeeld toont de verbindingsreeks met Microsoft Online Services om verbinding te maken met Microsoft Dynamics CRM Online.
Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;
Zie ook
Voorbeeld: Snel aan de slag met een vereenvoudigde verbinding met Microsoft Dynamics CRM
Uitbreidingen voor ontwikkelaars voor Microsoft Dynamics CRM 2015
Code genereren met de uitbreidingen van het hulpmiddel voor het genereren van code (Dynamics CRM 2015)
Portaloverzichten voor Dynamics CRM 2015
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht