Teilen über


Zu synchronisierende Tabellen und Felder zuordnen

Die Basis für die Synchronisation von Tabellen und Feldern in Business Central mit Tabellen und Spalten in Dataverse, damit Daten ausgetauscht werden können. Die Zuordnung erfolgt über Integrationstabellen.

Zuordnen von Integrationstabellen

Eine Integrationstabelle ist eine Tabelle in der Business Central-Datenbank, die eine Tabelle wie ein Konto in Dataverse darstellt. Integrationstabellen umfassten Felder, die Feldern in der Spalte für die Dataverse-Tabelle entsprechen. Die Kontointegrationstabelle stellt beispielsweise eine Verbindung zur Entität Tabelle in Dataverse her. Es muss für jede Tabelle in CDS, die Sie mit Daten in Business Central synchronisieren möchten, eine dazugehörende Integrationstabellenzuordnung vorhanden sein.

Wenn Sie die Verbindung zwischen den Apps herstellen, richtet Business Central einige Standardzuordnungen für die Tabellen und Felder ein. Sie können die Tabellenzuordnungen auf Wunsch ändern. Weitere Informationen finden Sie unter Standard Tabellenzuordnung für die Synchronisation. Wenn Sie die Standardzuordnungen geändert haben und Ihre Änderungen rückgängig machen möchten, wählen Sie auf der Seite Tabellenzuordnungsintegration die Option Standard-Synchronisierungseinrichtung aus.

Hinweis

Wenn Sie Business Central On-Premises verwenden, werden die Integrationstabellenzuordnungen in Tabelle 5335 Integrationstabellenzuordnungen gespeichert und können dort angezeigt und geändert werden. Komplexe Zuordnungen und Synchronisierungsregeln werden in der Codeunit 5341 definiert.

Trinkgeld

Wenn sich ein gekoppelter Datensatz ändert, synchronisiert Business Central die Daten automatisch mit Dataverse. Die automatische Synchronisierung ist in den meisten Fällen großartig. Häufige Änderungen an großen Mengen gekoppelter Datensätze in einer Tabelle können jedoch die Datensynchronisierung verlangsamen.

Um eine langsame Leistung zu vermeiden, können Sie auf der Seite Integrationstabellenzuordnungen die ereignisbasierte Datensynchronisierung für jede Tabelle aktivieren oder deaktivieren. Standardmäßig ist die ereignisbasierte Synchronisierung aktiviert, sodass vorhandene Integrationen nicht betroffen sind. Ihr Administrator kann es für bestimmte Tabellen ein- oder ausschalten.

Tabellen- und Feldzuordnungen zu vorhandenen Integrationstabellen hinzufügen

VORSCHAUVERSION Diese Funktion befindet sich derzeit in der Vorschauversion.

Auf der Seite Integrationstabellenzuordnungen können Sie mit der Aktion „Neu Tabellenzuordnung“ neue Tabellenzuordnungen zu Integrationstabellen hinzufügen. Die Aktion startet die Anleitung für die unterstützte Einrichtung Neue Integrationszuordnungen erstellen, die Sie beim Einrichten neuer Integrationstabelle und Feldzuordnungen unterstützt.

Mit der Anleitung können Sie die Tabellen in Business Central vorhandenen Integrationstabellen in Dataverse zuordnen. Sie können außerdem die eindeutige Kennung der Dataverse-Tabelle in Feldname des eindeutigen Bezeichners der Integrationstabelle und Feldname für „Geändert am“ der Integrationstabelle angeben, die für eine funktionierende Datensynchronisierung erforderlich sind.

Notiz

Die Suche in der Spalte „Tabelle“ gibt alle Business Central-Tabellen zurück, einschließlich benutzerdefinierter Tabellen, die noch nicht zugeordnet sind. Diejenigen, die bereits auf der Seite der Integrationstabellenzuordnung vorhanden sind, sind nicht enthalten. Die Suche in der Integrationstabellenspalte gibt nur Dataverse-Tabellen (AL-Proxy-Tabellen) zurück, die zu sofort einsatzbereiten Integrationen gehören. Um zusätzliche oder benutzerdefinierte Dataverse-Tabellen hinzuzufügen, benötigen Sie die Hilfe einer Entwicklungsfachkraft, die diese über eine Erweiterung erstellt und bereitstellt.

Die Aktion „Erweitert“ öffnet zusätzliche Tabellenzuordnungseinstellungen, die Sie einrichten können. Im Abschnitt Erweitert können Sie im Feld Tabellenfilter Filter für Business Central angeben. Verwenden Sie das Feld Integrationstabellenfilter für Dataverse-Daten, die bei der Datensynchronisierung berücksichtigt werden sollen, zusammen mit den Konfigurationsvorlagencodes im Vorlagencode Tabellenkonfiguration und im Int. Vorlagencode für Tabellenkonfiguration, um fehlende Daten vorab auszufüllen, wenn neue Daten aus einer der Anwendungen kommen.

Mit der Anleitung können Sie außerdem die Felder angeben, welche die neue Zuordnung enthalten soll. Sie können ein Business Central-Feld in der Spalte Feldname mit einem Dataverse-Feldnamen in der Spalte Integrationsfeldname abgleichen. Sie können außerdem eine Richtung angeben, d. h. ob das Feld in der Spalte Konstante immer den gleichen Wert hat und ob während der Feldzuordnung Validierungen oder Transformationen angewendet werden sollen.

Notiz

Um Fehler zu reduzieren, wird bei der Suche nach der Spalte Integrationstabellenfeld eine Liste der verfügbaren Felder gefiltert. Um Felder zuzuordnen, welche die Filter nicht enthalten, benötigen Sie die Hilfe einer Entwicklungsfachkraft.

  • Felder müssen aktiviert sein.
  • Sie können die Anleitung nicht verwenden, um FlowField- und FlowFilter-Felder zuzuordnen.
  • Sie können nur Felder vom Typ BigInteger, boolesch, Code, Datum, DateFormula, DateTime, Dezimal, Dauer, GUID, Integer, Option und Text zuordnen.

Trinkgeld

Sie können vorhandenen Integrationstabellenzuordnungen auch neue Feldzuordnungen hinzufügen. Dies geschieht über die Listenseite Integrationsfeldzuordnungen, die Sie erreichen, indem Sie auf der Seite Integrationstabellenzuordnungen die Option Felder auswählen.

Wählen Sie einfach Neue Feldzuordnung aus, um den Feldzuordnungsschritt der Anleitung für die unterstützte Einrichtung Neue Integrationszuordnungen erstellen zu öffnen. Fahren Sie dann wie in diesem Artikel beschrieben fort.

Neue Feldzuordnungen, die Sie zu einer vorhandenen Tabellenzuordnung hinzufügen, sind deaktiviert. Sie können Liste bearbeiten auswählen, um sie später zu aktivieren.

Synchronisierungsregeln

Eine Integrationstabellenzuordnung enthält auch Regeln, die steuern, wie Integrationssynchronisationsaufträge Datensätze in einer Business Central-Tabelle und einer Tabelle in Dataverse synchronisieren. Beispiele für Regeln für eine Integration mit Sales finden Sie unter Synchronisierungsregeln.

Strategien zur automatischen Lösung von Konflikten

Datenkonflikte können leicht auftreten, wenn Geschäftsanwendungen kontinuierlich Daten austauschen. Es kann beispielsweise vorkommen, dass ein Benutzer eine Zeile in einer der Anwendungen oder in beiden löscht oder ändert. Um die Anzahl der manuell zu lösenden Konflikte zu verringern, können Sie Lösungsstrategien angeben. Business Central löst Konflikte automatisch gemäß den Regeln in den Strategien.

Integrationstabellenzuordnungen enthalten Regeln, die steuern, wie Datensätze von Synchronisierungsaufträgen synchronisiert werden. Auf der Seite Integrationstabellenzuordnung können Sie in den Spalten Löschkonflikte auflösen und Aktualisierungskonflikte auflösen angeben, wie Business Central Konflikte lösen soll, die auftreten, weil Datensätze in Tabellen in der einen oder der anderen Geschäftsanwendung gelöscht oder in beiden aktualisiert wurden.

In der Spalte Löschkonflikte auflösen können Sie auswählen, dass Business Central gelöschte Datensätze automatisch wiederherstellen soll, die Kopplung zwischen den Datensätzen entfernen soll oder gar nichts unternehmen. Wenn Sie nichts unternehmen, müssen Sie Konflikte manuell lösen.

In der Spalte Aktualisierungskonflikte auflösen können Sie festlegen, dass Business Central automatisch eine Datenaktualisierung an die Integrationstabelle sendet, wenn Daten an Dataverse gesendet werden. Alternativ können Sie auswählen, dass eine Datenaktualisierung aus der Integrationstabelle abgerufen wird, wenn Daten von Dataverse abgerufen werden. Sie können auch gar nichts festlegen. Wenn Sie nichts unternehmen, müssen Sie Konflikte manuell lösen.

Nachdem Sie die Strategie festgelegt haben, können Sie auf der Seite Gekoppelte Datensynchronisierungsfehler die Aktion Alle wiederholen zum automatischen Lösen von Konflikten auswählen.

Zuordnen von Integrationsfeldern

Das Zuordnen von Tabellen ist nur der erste Schritt. Sie müssen auch die Felder in den Tabellen zuordnen. Integrationsfeldzuordnungen verknüpfen Felder in Business Central-Tabellen entsprechenden Spalten in Dataverse zu und bestimmen, ob Daten in jeder Tabelle synchronisiert werden sollen. Die Standardtabellenzuordnung, die von Business Central bereitgestellt wird, umfasst Feldzuordnungen, die Sie aber ändern können. Weitere Informationen finden Sie unter Anzeigen von Tabellenzuordnungen.

Notiz

Wenn Sie eine on-premises Version von Business Central verwenden, sind die Zuordnungen von Integrationsfeldern in Tabelle 5336 Zuordnung von Integrationsfeldern definiert.

Sie können die Felder manuell zuordnen oder den Prozess automatisieren, indem Sie mehrere Felder gleichzeitig anhand von Kriterien für die Übereinstimmung ihrer Werte zuordnen. Weitere Informationen finden Sie unter Mehrere Datensätze auf der Basis von Feldwertabgleich koppeln.

Behandlung von Unterschieden in Feldwerten

Manchmal sind die Werte in den Feldern, die Sie zuordnen möchten, unterschiedlich. Beispielsweise lautet in Dynamics 365 Sales der Sprachcode für die Vereinigten Staaten „U.S.“, in Business Central jedoch „US“. Das bedeutet, dass Sie den Wert transformieren müssen, wenn Sie Daten synchronisieren. Sie können Transformationsregeln für die Felder auf der Seite Integrationstabellenzuordnungen festlegen, indem Sie Zuordnungen und dann Felder wählen. Vordefinierte Regeln werden bereitgestellt, aber Sie können auch eigene Regeln erstellen. Weitere Informationen finden Sie unter Transformationsregeln.

Behandlung fehlender Optionswerte

Dataverse enthält Optionssatzspalten, die Werte liefern, denen Sie Business Central-Felder vom Typ Option zur automatischen Synchronisation zuordnen können. Während der Synchronisierung werden nicht zugeordnete Optionen ignoriert und die fehlenden Optionen werden an die zugehörige Business Central-Tabelle angehängt und der Systemtabelle der CDS-Optionszuordnung hinzugefügt, damit sie später bearbeitet werden können. Zum Beispiel, indem er die fehlenden Optionen in einem der beiden Produkte hinzufügt und dann die Zuordnung aktualisiert. Weitere Informationen finden Sie unter Behandlung fehlender Optionswerte.

Gekoppelte Datensätze

Kopplungsverknüpfungszeilen in Dataverse zu Datensätzen in Business Central. Zum Beispiel sind Konten in Dataverse in der Regel mit Kunden in Business Central gekoppelt. Das Koppeln von Datensätzen bietet folgende Vorteile:

  • Es ermöglicht die Synchronisation.
  • Benutzer können Datensätze oder Zeilen in einer Geschäftsanwendung eines anderen Benutzers öffnen.

Die Kopplung setzt voraus, dass die Apps bereits integriert sind.

Kopplungen können automatisch eingerichtet werden, indem die Synchronisierungsaufgaben verwendet werden, oder sie können manuell erfolgen, indem der Datensatz in Business Central bearbeitet wird. Weitere Informationen finden Sie unter Synchronisieren von Daten in Business Central und Dataverse und Datensätze manuell koppeln und synchronisieren.

Filtern von Datensätzen und Zeilen

Falls Sie nicht alle Zeilen für eine bestimmte Tabelle in Dataverse oder in Business Central synchronisieren möchten, können Sie Filter einrichten, um die Datensätze zu begrenzen, die synchronisiert werden. Sie können Filter auf der Seite Integrationstabellenzuordnungen einrichten.

  1. Wählen Sie das Symbol Glühbirne, die die „Wie möchten Sie weiter verfahren“-Funktion öffnet. aus, geben Sie Integrationstabellenzuordnungen ein und wählen Sie dann den entsprechenden Link aus.
  2. Um die Business Central-Datensätze zu filtern, legen Sie das Feld Tabellenfilter fest.
  3. Um die Dataverse Zeilen zu filtern, legen Sie das Feld Integrationstabellenfilter fest.

Erstellen neuer Datensätze

Standardmäßig werden nur gekoppelte Datensätze in Business Central und Zeilen in Dataverse durch die Integrationssynchronisierungsprojekte synchronisiert. Sie können Tabellenzuordnungen einrichten, um neue Datensätze oder Zeilen in der Ziel-App für jede Zeile in der App zu erstellen, die nicht bereits gekoppelt ist.

Beispielsweise verwendet der SALESPEOPLE - Dynamics 365 Sales Synchronisierungsauftrag die Tabellenzuordnung VERKÄUFER. Das Synchronisierungsprojekt kopiert Daten von Benutzern in Dataverse in Verkäuferdatensätze in Business Central. Wenn Sie die Tabellenzuordnung einrichten, um neue Datensätze zu erstellen, wird für alle Benutzenden in Dataverse, die nicht bereits an einen Verkäufer in Business Central gekoppelt sind, eine neue Verkäuferzeile in Business Central erstellt.

So erstellen Sie neue Datensätze während der Synchronisierung:

  1. Wählen Sie das Symbol Glühbirne, die die „Wie möchten Sie weiter verfahren“-Funktion öffnet. aus, gegen Sie Integrationstabellenzuordnung ein und wählen Sie den entsprechenden Link aus.
  2. Deaktivieren Sie im Tabellenzuordnungseintrag in der Liste das Feld Nur gekoppelte Datensätze synchronisieren.

Konfigurationsvorlagen für Tabellenzuordnungen verwenden

Sie können eine oder mehrere Konfigurationsvorlagen zur Verwendung für neue Business Central-Datensätze und eine andere Vorlage zur Verwendung für neue Dataverse-Zeilen angeben.

Wenn Sie das Standard-Synchronisationssetup installieren, werden in den meisten Fällen automatisch zwei Konfigurationsvorlagen erstellt und für die Tabellenzuordnung für Business Central-Debitoren und Dynamics 365 Sales-Konten verwendet: CDSCUST und CDSACCOUNT.

  • CDSCUST erstellt und synchronisiert neue Debitoren in Business Central basierend auf Konten in Dynamics 365 Sales.

    Um diese Vorlage zu erstellen, kopieren Sie eine vorhandene Konfigurationsvorlage für Debitoren. Die Seite CDSCUST wird nur erstellt, wenn eine bestehende Konfigurationsvorlage vorhanden ist und das Feld Währungscode in der Vorlage leer ist. Wenn ein Feld in der Konfigurationsvorlage einen Wert enthält, ersetzt der Wert den Wert in der zugeordneten Spalte im Dataverse-Konto. Wenn es sich beispielsweise bei der Spalte Land/Region in einem Dataverse-Konto um US handelt und das Feld Land/Region in der Konfigurationsvorlage GB lautet, dann wird GB für Land/Region im Debitor in Business Central verwendet.

  • CDSACCOUNT erstellt und synchronisiert neue Konten in Dataverse basierend auf einem Konto in Business Central.

Sie können weitere Vorlagen hinzufügen und mithilfe von Filtern Bedingungen festlegen, gemäß denen Business Central sie anwendet. Die Vorlagen gelten für Daten, die in beide Richtungen fließen. Sie können beispielsweise eine Vorlage für inländische Debitoren in den Vereinigten Staaten und eine andere für ausländische Debitoren in der Europäischen Union verwenden oder umgekehrt. In diesem Fall verwendet Business Central bei der Datensynchronisierung den Länder-/Regionscode des Debitors, um die entsprechende Vorlage anzuwenden.

So bestimmen Sie Konfigurationsvorlagen für eine Tabellenzuordnung:

  1. Wählen Sie das Glühbirne, die die „Wie möchten Sie weiter verfahren“-Funktion öffnet. Symbol aus, geben Sie Integrationstabellenzuordnung ein und wählen Sie dann den entsprechenden Link aus.

  2. Wählen Sie im Tabellenzuordnungseintrag in der Liste im Feld Tabellenkonfigurationsvorlagen die Konfigurationsvorlage aus, die für neue Datensätze in Business Central verwendet werden soll.

  3. Wenn Sie mehrere Vorlagen haben, geben Sie Kriterien in das Feld Integrationstabellenfilter und geben Sie dann eine Zahl in das Feld Priorität ein, um die Bedingungen festzulegen, die bestimmen, wann die Vorlage verwendet werden soll. Die Priorität bestimmt die Reihenfolge, in der Business Central prüft, ob die Vorlagen verwendet werden sollen.

    Notiz

    Die Felder Vorlagencode Tabellenkonfiguration und Int. Vorlagencode Tabellenkonfiguration zeigen unterschiedliche Werte an, die von der Anzahl der Vorlagen abhängen, die Sie für eine bestimmte Integrationstabellenzuordnung konfigurieren:

    • Wenn Sie eine einzelne Konfigurationsvorlage konfigurieren, wird der Name der Konfigurationsvorlage angezeigt, um die Kompatibilität mit den aktuellen Funktionen zu gewährleisten.
    • Wenn Sie mehrere Konfigurationsvorlagen konfigurieren, wird die Anzahl der konfigurierten Konfigurationsvorlagen angezeigt.
  4. Legen Sie das Feld Int. Vorlagencode Tabellenkonfiguration auf die Konfigurationsvorlage fest, die für neue Datensätze in Dataverse verwendet werden soll.

Siehe auch

Über das Integrieren von Dynamics 365 Business Central mit Dataverse
Synchronisieren von Business Central und Dataverse
Synchronisierung planen

Kostenlose E-Learning-Module für Business Central finden Sie hier