Mit Common Data Service verbinden
In diesem Thema wird beschrieben, wie Sie eine Verbindung zwischen Business Centralund Common Data Service einrichten. Typischerweise stellen Unternehmen die Verbindung her, um Daten mit einer anderen Dynamics 365-Geschäftsanwendung, z. B. Dynamics 365 Sales, zu integrieren und zu synchronisieren.
Bevor Sie beginnen
Sie müssen einige Informationen bereithalten, bevor Sie die Verbindung herstellen:
- Die URL für die Common Data Service-Umgebung, mit der Sie eine Verbindung herstellen möchten. Wenn Sie die Aktion CDS Verbindungseinrichtung unterstützte Einrichtungsanleitung verwenden, um die Verbindung herzustellen, werden wir Ihre Umgebungen ermitteln, aber Sie können auch die URL einer anderen Umgebung in Ihrem Mandant eingeben.
- Der Benutzername und das Passwort eines Kontos, das über Administratorberechtigungen in Business Central und Common Data Service verfügt.
Note
Diese Schritte beschreiben das Verfahren der Onlineversion von Business Central. Wenn Sie Business Central vor Ort verwenden und die Verbindung mit Common Data Service nicht mit dem Azure Active Directory-Konto herstellen, müssen Sie außerdem einen Benutzernamen und ein Kennwort eines Benutzerkontos für die Integration angeben. Dieses Konto wird als „Integrationsbenutzer“-Konto bezeichnet. Wenn Sie ein Azure Active Directory-Konto verwenden, ist das Integrationsbenutzerkonto weder erforderlich noch wird es angezeigt. Der Integrationsbenutzer wird automatisch eingerichtet und benötigt keine Lizenz.
Eine Verbindung mit Common Data Service einrichten
Für alle anderen Authentifizierungstypen als die Office 365-Authentifizierung richten Sie Ihre Verbindung zu Common Data Service auf der Seite CDS-Verbindungseinrichtung ein. Für die Office 365-Authentifizierung empfehlen wir die Verwendung des unterstützten Setups für die Common Data Service-Verbindung. Der Leitfaden erleichtert die Einrichtung der Verbindung und die Festlegung erweiterter Funktionen, z. B. Personenbesitz und Erstsynchronisierung.
Important
Während der Einrichtung der Verbindung mit Common Data Service wird der Administrator aufgefordert, der registrierten Azure-Anwendung mit dem Namen Business Central Integration für Common Data Service zu erteilen:
- Die Berechtigung Auf Common Data Service zugreifen ist erforderlich, damit Business Central im Namen des Administrators automatisch einen nicht lizenzierten, nicht interaktiven Benutzer der Anwendung Business Central Integration erstellen, diesem Benutzer Sicherheitsrollen zuweisen und Business Central Base CDS Integration Solution für Common Data Service bereitstellen kann. Diese Berechtigung wird nur einmal beim Einrichten der Verbindung mit Common Data Service verwendet.
- Die Berechtigung Vollzugriff auf Dynamics 365 Business Central ist erforderlich, damit automatisch erstellte Benutzer der Anwendung Business Central Integration auf Business Central-Daten zugreifen können, die synchronisiert werden.
- Die Berechtigung Anmelden und Ihr Profil lesen ist erforderlich, um zu überprüfen, ob dem Benutzer, der sich anmeldet, tatsächlich die Sicherheitsrolle „Systemadministrator“ in Common Data Service zugewiesen ist.
Durch die Einwilligung im Namen der Organisation berechtigt der Administrator die registrierte Azure-Anwendung mit dem Namen Business Central Integration für Common Data Service, Daten mit automatisch erstellten Anmeldeinformationen des Benutzers der Anwendung Business Central zu synchronisieren.
So verwenden Sie das unterstützte Setup zum Einrichten der Common Data Service-Verbindung
- Wählen Sie das Symbol
, geben Sie Unterstützte Einrichtung ein und wählen Sie dann den entsprechenden Link. - Wählen Sie Common Data Service-Verbindung einrichten aus, um das unterstützte Setup zu starten.
- Füllen Sie die Felder nach Bedarf aus.
So erstellen oder pflegen Sie den Link manuell
Die folgende Prozedur beschreibt, wie die Verbindung auf der Seite CDS-Verbindungsaufbau manuell eingerichtet wird. Dies ist auch die Seite, auf der Sie Einstellungen für die Integration verwalten.
Wählen Sie das Symbol
, geben Sie CDS-Verbindungsaufbau ein, und wählen Sie dann den entsprechenden Link.Geben Sie die folgenden Informationen über die Verbindung von Business Central mit Common Data Service ein.
Feld Beschreibung Umgebungs-URL Wenn Sie Umgebungen in Common Data Service besitzen, werden wir diese für Sie finden, wenn Sie den Einrichtungsleitfaden ausführen. Wenn Sie eine Verbindung zu einer anderen Umgebung in einem anderen Mandanten herstellen möchten, können Sie die Administrator-Zugangsdaten für die Umgebung eingeben, und wir werden diese ermitteln. Aktiviert Beginnen Sie mit der Verwendung der Integration. Wenn Sie die Verbindung nicht sofort aktivieren, werden die Verbindungseinstellungen gespeichert, aber Benutzer können nicht von Business Central aus auf Common Data Service-Daten zugreifen. Sie können zu dieser Seite zurückkehren und die Verbindung später aktivieren. Wählen Sie im Feld Eigentümermodell aus, ob eine Team-Entität in Common Data Service neue Datensätze oder ein oder mehrere bestimmte Benutzer besitzen soll. Wenn Sie Person wählen, müssen Sie jeden Benutzer angeben. Wenn Sie Team wählen, wird die Standard-Geschäftseinheit BCI_Company im Feld Gekoppelte Geschäftseinheit angezeigt.
Geben Sie die folgenden erweiterten Einstellungen ein.
Feld Beschreibung Business Central Benutzer müssen CDS-Benutzern zugeordnet sein Wenn Sie das Personenbesitzmodell verwenden, geben Sie an, ob Business Central-Benutzerkonten über übereinstimmende Benutzerkonten in Common Data Service verfügen müssen. Die Office 365-Authentifizierungs-E-Mail des Business Central-Benutzers muss mit der Primären E-Mail des Dynamics 365 Sales-Benutzers identisch sein.
Wenn Sie den Wert auf Ja festlegen, werden Business Central-Benutzer, die kein zugeordnetes Dynamics 365 Sales-Benutzerkonto haben, keine Business Central-Integrationsfunktionen auf der Benutzeroberfläche haben. Der Zugriffs auf Dynamics 365 Sales-Daten direkt von Business Central wird im Auftrag des Dynamics 365 Sales-Benutzerkontos ausgeführt.
Wenn Sie den Wert auf Nein festlegen, werden alle Business Central-Benutzer Dynamics 365 Sales-Integrationsfunktionen auf der Benutzeroberfläche haben. Der Zugriffs auf Dynamics 365 Sales-Daten wird im Auftrag des Dynamics 365 Sales-Verbindungs-(Integrations-)Benutzers ausgeführt.Der aktuelle Business Central-Verkäufer ist einem Benutzer zugeordnet Gibt an, ob Ihr Benutzerkonto einem Konto in zugeordnet ist Dynamics 365 Sales Um die Verbindungseinstellungen zu testen, wählen Sie Verbindung, und dann Verbindung testen.
Note
Wenn keine Datenverschlüsselung in Business Central aktiviert ist, werden Sie gefragt, ob sie diese aktivieren möchten. Um Datenverschlüsselung zu aktivieren, wählen Sie Ja aus, und stellen Sie die erforderlichen Informationen bereit. Anderenfalls wählen Sie Nein aus. Sie können die Datenverschlüsselung später aktivieren. Weitere Informationen finden Sie unter Verschlüsseln von Daten in Dynamics 365 Business Central in der Hilfe für Entwickler und die Verwaltung.
Wenn die Common Data Service-Synchronisierung nicht bereits eingerichtet ist, werden Sie gefragt, ob Sie die Standardsynchronisierungskonfiguration verwenden möchten. Abhängig davon, ob Sie Datensätze in Common Data Service und Business Central angepasst bleiben sollen, wählen Sie Ja oder Nein aus.
Zeig mir den Prozess
Das folgende Video zeigt die Schritte zum Verbinden von Business Central und Common Data Service.
Verbinden von Vor-Ort-Versionen
Sie müssen einige Informationen auf der Seite Common Data Service-Verbindungseinrichtung eingeben, um Business Central vor Ort mit Common Data Service zu verbinden.
Wenn Sie eine Verbindung mit einem Azure Active Directory (Azure AD)-Konto herstellen möchten, müssen Sie eine Anwendung in Azure AD registrieren, die Anwendungs-ID, die geheime Schlüsseltresor-ID und die zu verwendende Umleitungs-URL angeben. Die Umleitungs-URL ist bereits ausgefüllt und sollte für die meisten Installationen funktionieren. Sie müssen Ihre Installation für die Verwendung von HTTPS einrichten. Weitere Informationen finden Sie unter Konfigurieren von SSL zum Sichern der Business Central Web Client-Verbindung . Wenn Sie Ihren Server für eine andere Startseite einrichten, können Sie die URL jederzeit ändern. Der geheime Clientschlüssel wird als verschlüsselte Zeichenfolge in Ihrer Datenbank gespeichert.
So registrieren Sie eine Anwendung in Azure AD, um eine Verbindung mit Common Data Service über Business Central herzustellen
Bei den folgenden Schritten wird davon ausgegangen, dass Sie Azure AD verwenden, um Identitäten und den Zugriff zu verwalten. Weitere Informationen zum Registrieren einer Anwendung in Azure AD finden Sie unter Schnellstart: Anwendung bei der Microsoft-Identitätsplattform registrieren. Wenn Sie Azure AD nicht verwenden, finden Sie weitere Informationen unter Verwenden eines anderen Identitäts- und Zugriffsverwaltungsdienstes.
Wählen Sie im Navigationsbereich von Azure-Portal unter Verwalten die Option Authentifizierung aus.
Fügen Sie unter URLs umleiten die Umleitungs-URL hinzu, die auf der Seite Common Data Service-Verbindungseinrichtung in Business Central vorgeschlagen wird.
Wählen Sie unter Verwalten die Option API-Berechtigungen aus.
Wählen Sie unter Konfigurierte Berechtigungen die Option Berechtigung hinzufügen aus, und fügen Sie anschließen der Registerkarte Microsoft APIs delegierte Berechtigungen hinzu:
- Fügen Sie für Business Central die Financials.ReadWrite.All-Berechtigungen hinzu.
- Fügen Sie für Dynamics CRM die user_impersonation-Berechtigungen hinzu.
Note
Der Name der Dynamics CRM-API kann sich ändern.
Wählen Sie unter Verwalten die Option Zertifikate & Geheimnisse aus, und erstellen Sie dann einen neuen geheimen Schlüssel für Ihre App. Sie verwenden den geheimen Schlüssel in Business Central, im Feld Geheimer Clientschlüssel auf der Seite Common Data Service-Verbindungseinrichtung, oder Sie speichern ihn in einem sicheren Speicher und stellen ihn in einem Ereignisabonnenten bereit, wie weiter oben in diesem Thema beschrieben.
Wählen Sie Übersicht aus, und suchen Sie dann den Wert Anwendungs-(Client-)ID. Dies ist die Client-ID Ihrer Anwendung. Sie müssen sie auf der Seite Common Data Service-Verbindungseinrichtung im Feld Client-ID eingeben oder in einem sicheren Speicher speichern und in einem Ereignisabonnenten bereitstellen.
Geben Sie in Business Central auf der Seite Common Data Service-Verbindungseinrichtung im Feld Umgebungs-URL die URL für Ihre Common Data Service-Umgebung ein.
Aktivieren Sie das Kontrollkästchen Aktiviert, um die Verbindung mit Common Data Service zu aktivieren.
Melden Sie sich mit Ihrem Administratorkonto für Azure Active Directory an (dieses Konto muss eine gültige Lizenz für Common Data Service haben und ein Administrator in Ihrer Common Data Service-Umgebung sein). Nachdem Sie sich angemeldet haben, werden Sie aufgefordert, Ihrer registrierten Anwendung zu erlauben, sich im Namen der Organisation bei Common Data Service anzumelden. Sie müssen Ihre Zustimmung geben, um die Einrichtung abzuschließen.
Note
Wenn Sie nicht aufgefordert werden, sich mit Ihrem Administratorkonto anzumelden, liegt dies wahrscheinlich daran, dass Popups blockiert sind. Erlauben Sie Popups von
https://login.microsoftonline.com, um sich anzumelden.
Verwenden eines anderen Identitäts- und Zugriffsverwaltungsdienstes
Wenn Sie Azure Active Directory nicht verwenden, um Identitäten und den Zugriff zu verwalten, benötigen Sie die Hilfe eines Entwicklers. Wenn Sie die App-ID und den geheimen Schlüssel lieber an einem anderen Ort speichern möchten, können Sie die Felder „Client-ID“ und „Geheimer Clientschlüssel“ leer lassen und eine Erweiterung schreiben, um die ID und den geheimen Schlüssel von diesem Speicherort abzurufen. Sie können den geheimen Schlüssel zur Laufzeit bereitstellen, indem Sie die Ereignisse „OnGetCDSConnectionClientId“ und „OnGetCDSConnectionClientSecret“ in Codeunit 7201 „CDS Integration Impl“ abonnieren.
So trennen Sie Common Data Service
- Wählen Sie das Symbol , geben Sie CDS-Verbindungsaufbau ein, und wählen Sie dann den entsprechenden Link.
- Schalten Sie auf der Seite CDS Verbindungseinrichtung den Schalter Aktiviert aus.