Verwenden von Verbindungszeichenfolgen im XRM-Tooling zum Herstellen einer Verbindung zu Dynamics 365

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Mit Microsoft Dynamics 365 (online und lokal) ermöglicht das XRM-Tooling es Ihnen, eine Verbindung zu Ihrer Dynamics 365-Instanz herzustellen, indem Sie Verbindungszeichenfolgen verwenden. Dies ähnelt dem Konzept von Verbindungszeichenfolgen, das in Microsoft SQL Server verwendet wird. Verbindungszeichenfolgen erhalten native Unterstützung in Konfigurationsdateien inklusive der Möglichkeit der Verschlüsselung der Konfigurationsabschnitte für maximale Sicherheit. Dies ermöglicht es Ihnen, Dynamics 365-Verbindungen zur Bereitstellungszeit zu konfigurieren und nicht hartcodiert in der Anwendung, um eine Verbindung zu Ihrer Dynamics 365-Instanz herzustellen.

In diesem Thema

Erstellen einer Verbindungszeichenfolge

Parameter für Verbindungszeichenfolgen

Beispiele für Verbindungszeichenfolgen

Bestimmung Ihres Verbindungsstatus

Erstellen einer Verbindungszeichenfolge

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="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />
</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.

Nachdem Sie die Verbindungszeichenfolge erstellt haben, verwenden Sie diese, um ein CrmServiceClient-Objekt zu erstellen.

//Use the connection string named "MyCRMServer"
//from the configuration file
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);

Hinweis

Sie müssen die folgende using-Direktive in Ihrem Code verwenden, um auf den System.Configuration-Namespace verweisen, um auf die Verbindungszeichenfolge in Ihrem Code zuzugreifen: using System.Configuration;

Nachdem Sie ein CrmServiceClient-Objekt erstellt haben, können Sie das Objekt werden, um Aktionen in Dynamics 365 auszuführen.Weitere Informationen:XRM-Tooling zur Ausführung von Aktionen in Dynamics 365 verwenden

Parameter für Verbindungszeichenfolgen

Die Verbindungszeichenfolge enthält eine Reihe von Name-Wert-Paaren, getrennt durch Semikolons. Die folgende Tabelle enthält unterstützte Parameter, die in beliebiger Reihenfolge eingegeben werden können.

Parametername

Beschreibung

ServiceUri, Service Uri, Url, or Server

Gibt die URL zu Microsoft Dynamics 365 Server an. Die URL kann das http- oder https-Protokoll verwenden, und der Port ist optional. Standardmäßig wird der Port 80 für das http-Protokoll und 443 für das https-Protokoll verwendet. Die Server-URL ist normalerweise im Format http://crm-Server:Port/Organisationsname für die lokale Version von Dynamics 365 und https://Organisationsname.crm.dynamics.com für Dynamics 365 (online).

Der Organisationsname muss angegeben werden. Sie können entweder den benutzerfreundlichen oder eindeutigen Namen der Organisation angeben, um eine Verbindung herzustellen.

Beispiel http://contoso/test, http://contoso:5555/test, https://contoso/test, https://test.crm.dynamics.com oder http://10.10.10.2/test.

Domain

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

UserName, User Name, UserId, 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.

HomeRealmUri oder Home Realm Uri

Gibt den Startbereichs-URL an.

AuthenticationType oder AuthType

Gibt den Authentifizierungstyp an, um die Verbindung zur Dynamics 365-Instanz herzustellen. Gültige Werte sind: AD, IFD (AD FS) aktiviert, OAuth oder Office365.

  • AD und IFD sind nur für lokale Dynamics 365-Instanzen zulässig.

  • OAuth ist für Dynamics 365 (online) und lokale Instanzen zulässig.

  • Office365 ist nur für Dynamics 365 (online)-Instanzen zulässig.

RequireNewInstance

Definiert, ob die vorhandene Verbindung wieder verwendet wird, wenn Sie aufgerufen wird, solange die Verbindung noch aktiv ist. Standardwert ist false, der angibt, dass die bestehende Verbindung wiederverwendet wird. Wenn auf true festgelegt, wird das System gezwungen, eine eindeutige Verbindung herzustellen.

ClientId, AppId oder ApplicationId

Gibt die zugewiesene ClientID an, wenn Sie die Anwendung in Microsoft Azure Active Directory oder Active Directory Federation Services (AD FS) registrieren.

Dieser Parameter gilt nur, wenn OAuth als Authentifizierungstyp angegeben ist.

RedirectUri oder ReplyUrl

Gibt den Umleitungs-URI der Anwendung an, die Sie in Microsoft Azure Active Directory oder Active Directory Federation Services (AD FS) registrieren.

Dieser Parameter gilt nur, wenn OAuth als Authentifizierungstyp angegeben ist.

TokenCacheStorePath

Gibt den vollständigen Pfad zum Speicherort an, an dem der Benutzertoken gespeichert werden soll. Der laufende Prozess muss über Zugriff auf den angegebenen Pfad verfügen. Es ist die Prozesszuständigkeit, diesen Pfad festzulegen und zu konfigurieren.

Dieser Parameter gilt nur, wenn OAuth als Authentifizierungstyp angegeben ist.

LoginPrompt

Gibt an, ob der Benutzer zur Eingabe der Anmeldeinformationen aufgefordert wird, wenn die Anmeldeinformationen nicht angegeben wurden. Gültige Werte sind:

  • Always: Fordert immer den Benutzer auf, Anmeldeinformationen anzugeben.

  • Auto: Ermöglicht dem Benutzer, in der Anmeldungssteuerelement-Benutzeroberfläche auszuwählen, ob die Eingabeaufforderung angezeigt wird oder nicht.

  • Never: Fordert den Benutzer nicht auf, Anmeldeinformationen anzugeben. Wenn für die Verwendung einer Verbindungsmethode keine Benutzeroberfläche bereitgestellt wird, müssen Sie diesen Wert verwenden.

Dieser Parameter gilt nur, wenn OAuth als Authentifizierungstyp angegeben ist.

Beispiele für Verbindungszeichenfolgen

Die folgenden Beispiele veranschaulichen, wie Sie Verbindungszeichenfolgen für die Verbindung mit Bereitstellungen und Authentifizierungsszenarien verwenden können.

Integrierte lokale Authentifizierung

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test;" />

Benanntes Konto unter Verwendung der lokalen Authentifizierung

<add name="MyCRMServer" connectionString="AuthType=AD;Url=http://contoso:8080/Test; Domain=CONTOSO; Username=jsmith; Password=passcode" />

Benanntes Konto unter Verwendung von Office 365

<add name="MyCRMServer" connectionString="AuthType=Office365;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso.crm.dynamics.com"/>

OAuth unter Verwendung des benannten Kontos in Office 365 mit UX zur Abfrage der Authentifizierungsbestätigung

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contosotest.crm.dynamics.com;AppId=<GUID>;RedirectUri =app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

OAuth unter Verwendung des benannten Kontos in der lokalen Version von Dynamics 365 mit UX zur Abfrage der Authentifizierungsbestätigung

<add name="MyCRMServer" connectionString="AuthType=OAuth;Username=jsmith@contoso.onmicrosoft.com; Password=passcode;Url=https://contoso:8080/Test;AppId=<GUID>;RedirectUri=app://<GUID>;TokenCacheStorePath =c:\MyTokenCache;LoginPrompt=Auto"/>

IFD unter Verwendung eines benannten Kontos mit Delegierung an einen Vorbereich

<add name="MyCRMServer" connectionString="AuthType=IFD;Url=http://contoso:8080/Test; HomeRealmUri=https://server-1.server.com/adfs/services/trust/mex/;Domain=CONTOSO; Username=jsmith; Password=passcode" />

Bestimmung Ihres Verbindungsstatus

Um zu bestimmen, ob die Verbindungsaufforderung erfolgreich war, überprüfen Sie den Wert für die CrmServiceClient.IsReady-Eigenschaft. Wenn der Wert true ist, ist die Verbindung erfolgreich undSie können mit der Arbeit beginnen. Andernfalls müssen die Werte der CrmServiceClient. LastCrmError und CrmServiceClient.LastCrmException Eigenschaften überprüfen, um die Ursache des Verbindungsfehlers herauszufinden..

Siehe auch

CrmServiceClient
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools
CrmServiceClient-Konstruktoren verwenden, um eine Verbindung mit Dynamics 365 herzustellen
XRM-Tooling zur Ausführung von Aktionen in Dynamics 365 verwenden

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright