Freigeben über

Vereinfachte Verbindung mit Microsoft Dynamics CRM 2015

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Entwicklererweiterungen für Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update basieren auf dem Konzept einer Verbindungszeichenfolge für die Verbindung zum Microsoft Dynamics 365 -Server. Dies ähnelt dem Konzept von Verbindungszeichenfolgen, das in Microsoft SQL Server verwendet wird. Verbindungszeichenfolgen sind Bestandteil des ADO.NET-Frameworks und erhalten zudem native Unterstützung in Konfigurationsdateien inklusive der Möglichkeit der Verschlüsselung der Konfigurationsabschnitte für maximale Sicherheit. Damit können Sie ein robustes Modell verwenden, in dem Microsoft Dynamics 365-Verbindungen zur Bereitstellungszeit konfiguriert werden und nicht in der Anwendung hartcodiert sind. Daher arbeiten alle APIs in Entwicklererweiterungen für Microsoft Dynamics 365 mit einem CrmConnection-Objekt, das intern von der CrmOrganizationServiceContext-Klasse verwendet wird, wie in diesem Thema veranschaulicht, in dem die Verbindung zum Server mithilfe einer Verbindungszeichenfolge hergestellt wird.

Sie geben diese Verbindungszeichenfolge in der Datei app.config oder web.config für das Projekt an, wie im folgenden Beispiel angezeigt.

<connectionStrings>
  <add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>
System_CAPS_security Sicherheit Hinweis

Wenn Sie vertrauliche Informationen zur Datei app.config oder web.config hinzufügen, z. B. ein Firmenkennwort, müssen Sie sicherstellen, dass geeignete Sicherheitsvorkehrungen zum Schutz dieser Informationen getroffen werden.

In diesem Thema

Erstellen einer Verbindungszeichenfolge

Parameter für Verbindungszeichenfolgen

Beispiele für Verbindungszeichenfolgen

Erstellen einer Verbindungszeichenfolge

Die Verbindungszeichenfolge wird verwendet, um ein CrmConnection-Objekt zu instanziieren, das wiederum verwendet werden kann, um ein OrganizationService oder ein CrmOrganizationServiceContext-Objekt zu instanziieren.

//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);

Eine CrmConnection kann auch unabhängig von der Datei app.config erstellt und wie folgt inline konstruiert werden.

var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");

Parameter für Verbindungszeichenfolgen

Das Grundformat der Verbindungszeichenfolge ist mit einer OLEDB-Verbindungszeichenfolge identisch. Es besteht aus einer Reihe von durch Semikolon getrennten Name-Wert-Paaren. Die folgende Tabelle enthält unterstützte Parameter, die in beliebiger Reihenfolge eingegeben werden können.

Parametername

Beschreibung

Server, Url, or Service Uri

Gibt die URL zum Microsoft Dynamics 365-Server an. Die URL kann http oder https sein und der Port ist optional, wenn die http über Port 80 oder https über Port 443 ausgeführt wird. Die Server-URL ist normalerweise im Format für http:// crm-server: port/organization-name oder für Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com gespeichert. Der Organisationsname muss angegeben werden.

Domain

Gibt die Domäne an, die Anmeldeinformationen von Benutzern überprüft.

Username or User ID

Gibt die Benutzerkennung an, die den Anmeldeinformationen zugeordnet ist.

Password

Gibt das Kennwort für den Benutzernamen, das den Anmeldeinformationen zugeordnet ist.

Device ID or Device User Name

Gibt den benutzerdefinierten Microsoft-Konto-Geräteidentifizierer an. Hier kann jede beliebige, nicht leere Zeichenkette angegeben werden. Diese Geräte-ID wird mit dem Gerätekennwort bei der ersten Authentifizierung registriert. Wenn die Geräte-ID und das Kennwort nicht mit den zuvor registrierten Werten übereinstimmen, erfolgt keine Authentifizierung. Die Geräte-ID betrifft nur CRM Online.

Device Password

Gibt das benutzerdefinierte Kennwort für das Microsoft-Konto-Gerät an. Es muss mindestens sechs Zeichen lang sein. Dieses Kennwort wird mit der Geräte-ID bei der ersten Authentifizierung registriert. Wenn die Geräte-ID und das Kennwort nicht mit den zuvor registrierten Werten übereinstimmen, erfolgt keine Authentifizierung. Das Geräte-Passwort betrifft nur CRM Online.

Timeout

Wird an die Timeout-Eigenschaft der OrganizationServiceProxy-Klasse übergeben.

Home Realm Uri

Wird an die HomeRealmUri-Eigenschaft der OrganizationServiceProxy-Klasse übergeben.

Proxytypen aktiviert

Dieser standardmäßig auf True gesetzte Parameter ermöglicht, dass OrganizationService Proxytypen anstelle des grundlegenden Typs Entity zurückgibt.

Proxy Types Assembly

Gibt die Assembly an, die die Proxytypen aus Microsoft Dynamics 365 enthält, die mit dem Tool CrmSvcUtil.exe generiert wurden und die Erweiterung Microsoft.Xrm.Client.CodeGeneration haben.

Caller ID

Wird an die CallerId-Eigenschaft der OrganizationServiceProxy-Klasse übergeben.

Service Configuration Instance Mode

Kann auf Static, PerName, PerRequest oder PerInstance festgelegt werden.PerName ist der Standardwert. Damit wird die Häufigkeit optimiert, mit der eine IServiceConfiguration<TService> für eine OrganizationService, so erstellt wird, so dass nur eine für jeden Verbindungsstring erstellt wird. Weitere Informationen über andere mögliche Werte finden Sie unter Geben Sie das instanceMode das Attribut an.

User Token Expiry Window

Gibt eine Zeitspanne im Format hh:mm:ss an, die als Offset verwendet wird, wenn ein neues Benutzertoken abgerufen wird. Wenn dieser Parameter auf „00:10:00“ festgelegt ist, wird ein neues Benutzertoken 10 Minuten vor dem tatsächlichen Ablauf des Tokens abgerufen.

Beispiele für Verbindungszeichenfolgen

Im folgenden Beispiel wird die Verbindungszeichenfolge dargestellt, in der integrierte lokale Authentifizierung verwendet wird.

Url=http://crm.contoso.com/xrmContoso;

Im folgenden Beispiel wird die Verbindungszeichenfolge dargestellt, in der Active Directory-Authentifizierung verwendet wird.

Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode

Im folgenden Beispiel wird die Verbindungszeichenfolge dargestellt, in der Microsoft-Konto für die Verbindung zu Microsoft Dynamics CRM Online verwendet wird.

Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode

Im folgenden Beispiel wird die Verbindungszeichenfolge dargestellt, in der Microsoft Online Services für die Verbindung zu Microsoft Dynamics CRM Online verwendet wird.

Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;

Siehe auch

Beispiel: Erste Schritte für einfacheres Herstellen von Verbindungen mithilfe von Microsoft Dynamics CRM
Entwicklererweiterungen für Microsoft Dynamics CRM 2015
Generieren von Code mit den Codegenerierungstool-Erweiterungen (Dynamics CRM 2015)
Exemplarische Vorgehensweisen zu Portalen für Dynamics CRM 2015

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright