Mit Microsoft Dataverse verbinden
Hinweis
Gültig ab November 2020:
- Common Data Service wurde in Microsoft Dataverse umbenannt. Weitere Informationen
- Einige Begriffe in Microsoft Dataverse wurden aktualisiert. Beispielsweise ist Entität jetzt Tabelle und Feld ist nun Spalte. Weitere Informationen
In diesem Thema wird beschrieben, wie Sie eine Verbindung zwischen Business Centralund Dataverse 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 Dataverse-Umgebung, mit der Sie eine Verbindung herstellen möchten. Wenn Sie die Aktion Dataverse 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 Dataverse verfügt.
- Wenn Sie eine lokale Business Central 2020 Veröffentlichungszyklus 1, Version 16.5 haben, lesen Sie den Artikel zu Einige bekannte Probleme. Sie müssen die beschriebene Problemumgehung ausführen, bevor Sie eine Verbindung zu Dataverse herstellen können.
Wichtig
Ihre Dataverse-Umgebung darf sich nicht im Administrationsmodus befinden. Der Administrationsmodus führt dazu, dass die Verbindung fehlschlägt, da das Integrationsbenutzerkonto für die Verbindung keine Administratorrechte besitzt. Weitere Informationen finden Sie unter Verwaltungsmodus.
Hinweis
Diese Schritte beschreiben das Verfahren in Business Central online. Wenn Sie Business Central lokal verwenden und nicht das Azure Active Directory Konto verwenden, um die Verbindung mit Dataverse herzustellen, 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 Dataverse einrichten
Für alle anderen Authentifizierungstypen als die Microsoft 365-Authentifizierung richten Sie Ihre Verbindung mit Dataverse auf der Seite Dataverse Verbindungseinrichtung ein. Für die Microsoft 365-Authentifizierung empfehlen wir die Anleitung zur unterstützten Einrichtung für die Dataverse Verbindung. Der Leitfaden erleichtert die Einrichtung der Verbindung und die Festlegung erweiterter Funktionen, wie z. B. Personenbesitz und Erstsynchronisierung.
Wichtig
Während der Einrichtung der Verbindung mit Dataverse wird der Administrator aufgefordert, der registrierten Azure-Anwendung mit dem Namen Business Central Integration für Dataverse zu erteilen:
- Die Berechtigung Auf Dataverse 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 Integration Solution für Dataverse bereitstellen kann. Diese Berechtigung wird nur einmal beim Einrichten der Verbindung mit Dataverse 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 Dataverse zugewiesen ist.
Durch die Einwilligung im Namen der Organisation berechtigt der Administrator die registrierte Azure-Anwendung mit dem Namen Business Central Integration für Dataverse, Daten mit automatisch erstellten Anmeldeinformationen des Benutzers der Anwendung Business Central zu synchronisieren.
So verwenden Sie die Dataverse Anleitung zur unterstützten Einrichtung
Die Anleitung zur unterstützten Einrichtung für die Verbindung von Dataverse kann Ihnen helfen, die Verbindung einfacher herzustelle und Sie kann Ihnen sogar beim Ausführen einer ersten Synchronisierung helfen. Wenn Sie die anfängliche Synchronisierung ausführen möchten, überprüft Business Central die Daten in beiden Anwendungen und gibt Empfehlungen für die anfängliche Synchronisierung. Die folgende Tabelle beschreibt die Empfehlungen.
| Empfehlung | Beschreibung |
|---|---|
| Vollständige Synchronisierung | Daten existieren nur in Business Central oder nur in Dataverse. Die Empfehlung lautet, alle Daten des Dienstes, der sie hat, mit dem anderen Dienst zu synchronisieren. |
| Keine Synchronisation | Daten sind in beiden Anwendungen vorhanden, und eine vollständige Synchronisierung würde die Daten duplizieren. Die Empfehlung ist, Datensätze zu koppeln. |
| Abhängigkeit nicht erfüllt | Daten sind in beiden Anwendungen vorhanden, aber die Zeile oder Tabelle kann nicht synchronisiert werden, da dies von einer Zeile oder Tabelle abhängt, für die die Empfehlung Keine Synchronisierung gilt. Wenn beispielsweise Kunden nicht synchronisiert werden können, können auch Daten für Kontakte, die von den Kundendaten abhängen, nicht synchronisiert werden. |
Wichtig
In der Regel verwenden Sie die vollständige Synchronisierung nur, wenn Sie die Anwendungen zum ersten Mal integrieren, und nur eine Anwendung enthält Daten. Eine vollständige Synchronisierung kann in einer Demonstrationsumgebung hilfreich sein, da in jeder Anwendung automatisch Datensätze erstellt und gekoppelt werden, wodurch die Arbeit mit synchronisierten Daten beschleunigt wird. Sie sollten die vollständige Synchronisierung jedoch nur ausführen, wenn Sie eine Zeile in Business Central für jede Zeile in Dataverse für die Tabellenzuordnungen möchten. Andernfalls kann das Ergebnis doppelte Datensätze sein.
- Wählen Sie das Symbol
, geben Sie Unterstützte Einrichtung ein und wählen Sie dann den entsprechenden Link. - Wählen Sie Eine Verbindung zu Microsoft Dataverse einrichten, um das Leitfaden für das unterstützte Setup zu starten.
- Füllen Sie die Felder nach Bedarf aus.
Hinweis
Wenn Sie nicht aufgefordert werden, sich mit Ihrem Administratorkonto anzumelden, liegt dies wahrscheinlich daran, dass die Popups blockiert sind. Erlauben Sie Popups von https://login.microsoftonline.com, um sich anzumelden.
So erstellen oder pflegen Sie den Link manuell
Die folgende Prozedur beschreibt, wie die Verbindung auf der Seite Dataverse Verbindungs-Einrichtung manuell eingerichtet wird. Dies ist auch die Seite, auf der Sie Einstellungen für die Integration verwalten.
- Wählen Sie das Symbol , geben Sie Dataverse Verbindungseinrichtung ein und wählen Sie dann den entsprechenden Link.
Geben Sie die folgenden Informationen über die Verbindung von Business Central mit Dataverse ein.
Feld Beschreibung Umgebungs-URL Wenn Sie Umgebungen in Dataverse 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 Dataverse-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 Sie möchten, dass eine Team-Tabelle in Dataverse 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 im Feld Gekoppelte Geschäftseinheit angezeigt.
|
Um die Verbindungseinstellungen zu testen, wählen Sie Verbindung, und dann Verbindung testen.
Hinweis
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 Dataverse-Synchronisierung nicht bereits eingerichtet ist, werden Sie gefragt, ob Sie die Standardsynchronisierungskonfiguration verwenden möchten. Abhängig davon, ob Sie Datensätze in Dataverse und Business Central angepasst bleiben sollen, wählen Sie Ja oder Nein aus. <!--
Show Me the Process
The following video shows the steps to connect Business Central and Dataverse.
-->
Verbinden von Vor-Ort-Versionen
Sie müssen einige Informationen auf der Seite Dataverse-Verbindungseinrichtung eingeben, um Business Central vor Ort mit Dataverse 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 Dataverse ü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 Dataverse-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.
Hinweis
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 Dataverse-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 Dataverse-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 Dataverse-Verbindungseinrichtung im Feld Umgebungs-URL die URL für Ihre Dataverse-Umgebung ein.
- Aktivieren Sie das Kontrollkästchen Aktiviert, um die Verbindung mit Dataverse zu aktivieren.
Melden Sie sich mit Ihrem Administratorkonto für Azure Active Directory an (dieses Konto muss eine gültige Lizenz für Dataverse haben und ein Administrator in Ihrer Dataverse-Umgebung sein). Nachdem Sie sich angemeldet haben, werden Sie aufgefordert, Ihrer registrierten Anwendung zu erlauben, sich im Namen der Organisation bei Dataverse anzumelden. Sie müssen Ihre Zustimmung geben, um die Einrichtung abzuschließen.
Hinweis
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 Dataverse
- Wählen Sie das Symbol , geben Sie Dataverse Verbindungseinrichtung ein und wählen Sie dann den entsprechenden Link.
- Schalten Sie auf der Seite Dataverse Verbindungseinrichtung die Umschaltung auf Aktiviert.
Siehe auch
Den Status einer Synchronisierung anzeigen
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).