Mandanten erstellen und Synchronisation einrichten
DYCE Time Tracking und DYCE Project & Resource Planning verwenden Mandanten und Umgebungen. Für jeden Mandanten in Business Central kann ein Mandant in der DYCE Connect Plattform erstellt werden. Für jede Umgebung in Business Central wird eine Umgebung in der DYCE Connect Plattform angelegt. Der Benutzer kann frei zwischen den Mandanten wechseln, solange er in den anderen Mandanten angelegt ist.
Neue Mandanten erstellen
Neue Mandanten für die DYCE Connect Plattform werden aus Business Central heraus erstellt. Ein Mandant in DYCE Connect entspricht jeweils einem Mandanten in Business Central. Um einen neuen Mandanten zu erstellen und es mit einem Mandanten in Business Central zu verbinden, muss der DYCE Synchronisation Einrichtungsassistent aus Business Central aufgerufen werden. Der Assistent führt alle notwendigen Schritte aus und bereitet den Mandanten in DYCE Connect vor. Er kann in der Seite DYCE Einrichtung Synchronisation oder über die Suche (Alt+Q) aufgerufen werden.
Der Benutzer, der den Assistenten ausführt, muss über die entsprechenden Berechtigungen und Rollen verfügen. Insbesondere benötigt er eine Business Central Lizenz, ausreichende Benutzerberechtigungen und die Rolle Anwendungsadministrator (in Microsoft Entra).
Der Anwender, der die neue Umgebung in DYCE Connect erstellt hat, wird automatisch als Benutzer eingetragen. Weitere Benutzer müssen anschließend manuell hinzugefügt und mit den entsprechenden Rollen versehen werden.
Sobald der Assistent durchlaufen wurde und die DYCE Connect Umgebung bereit ist, sollten zwei Dinge getan werden. Zuerst sollte die Synchronisation eingeschaltet (Automatische Synchronisation aktiviert auf JA setzen) und die entsprechenden Einträge in der Aufgabenwarteschlange überprüft werden. Es muss sichergestellt sein, dass der Status der Einträge DYCE Sync Task (70921505) und DYCE Task Watchdog (70921489) auf Bereit steht. Bitte überprüfen Sie auch das Früheste Startdatum/ Uhrzeit. Zweitens muss immer eine Vollständige Synchronisation durchgeführt werden, um die vorhandenen Daten aus Business Central mit DYCE Connect zu synchronisieren. Der kontinuierliche Synchronisationsprozess beginnt kurz nach Abschluss der Mandantenerstellung.
Eine Vollständige Synchronisation kann entweder manuell auf der Seite DYCE Einrichtung Synchronisation oder am Ende des Onboarding-Assistenten gestartet werden.
Einrichtung der Synchronisation
In der Seite DYCE Einrichtung Synchronisation in Business Central kann die Einrichtung der Synchronisation kontrolliert und eine Vollständige Synchronisation ausgeführt werden. In der Seite kann das Intervall zwischen den Sync-Sessions und die Anzahl der Abfragen je Sync-Session editiert werden. Wenn Synchronisation aktiviert auf NEIN geändert wird, wird die die Ausführung der Synchronisation über die Aufgabenwarteschlange angehalten (CodeUnit 70921505).
Ist die Automatische Synchronisation aktiviert, wird die Synchronisation im Hintergrund über die Aufgabenwarteschlange ausgeführt. Drei Aufgabenwarteschlangeneinträge sind für die Synchronisation relevant:
- DYCE Sync Task (Codeunit 70921505): Diese Aufgabe ist für das Senden und Empfangen von Daten von DYCE Connect verantwortlich. Sie startet sich selbst neu und läuft kontinuierlich, während sie auf neue Nachrichten wartet, die verarbeitet werden müssen.
- DYCE Task Watchdog (Codeunit 70921489): Der Watchdog überprüft, ob die Synchronisationsaufgabe läuft, und reaktiviert sie, falls dies nicht der Fall ist.
- DYCE Purge Log (Codeunit 70921482): Diese Aufgabe bereinigt die verarbeiteten eingehenden und ausgehenden Nachrichten, die älter als 30 Tage sind. Nicht verarbeitete Nachrichten oder Nachrichten im Fehlerstatus werden nicht gelöscht.
Anhand von Ausgehende Nachrichten unverarbeitet kann erkannt werden, wie viele Daten nicht an die DYCE Connect Plattform gesendet wurden. Wird ein Datensatz in Business Central erstellt, wird er immer hier angezeigt bis er gesendet wird. Bei einer vollständigen Synchronisation werden die Daten sukzessive abgearbeitet.
Der Zustand, dass Daten überhaupt nicht gesendet werden, sollte nicht eintreten. Es ist aber ein Hinweis darauf, dass die Synchronisation nicht aktiviert oder ein Problem in der Aufgabenwarteschlange aufgetreten ist.
Anhand von Eingehende Nachrichten unverarbeitet kann erkannt werden, wie viele Daten aus der DYCE Connect Plattform zwar empfangen, aber nicht korrekt verarbeitet werden konnten. Durch Klick auf die Anzahl werden die betroffenen Datensätze geöffnet. Unverarbeitete Nachrichten können bearbeitet und deren Verarbeitung erneut angestoßen werden.
Falls empfangene Daten erstmalig verarbeitet werden, muss die Reihenfolge der Updates des jeweiligen Datensatzes beachtet werden. Werden die Datensätze in einer anderen als der empfangenen Reihenfolge verarbeitet, kann der Inhalt der Daten verändert werden. Über Zeitpunkt kann der Zeitpunkt des Eingangs identifiziert werden. Die Operation Create muss vor einem Update durchgeführt werden. Delete sollte immer die letzte Operation sein, die ausgeführt wird.
Falls der Datenstand zwischen DYCE Connect Plattform und Business Central unterschiedlich ist, kann die Aktion Vollständige Synchronisation verwendet werden, um die Daten zu synchronisieren.
Eine vollständige Liste der Protokolleinträge kann in der Menügruppe Protokoll aufgerufen werden. Im Inforegister Statistik ist erkennbar, wann der letzte Heartbeat gesendet und empfangen wurde.
Im Administrationsbereich können die unverarbeiteten Daten der DYCE Connect Plattform und Business Central eingesehen und bearbeitet werden.
Es gibt mehr als einen Möglichkeit die Synchronisation versehentlich zu unterbrechen. Diese gilt es zu vermeiden.
- Erstellen, löschen oder modifizieren von Daten mit Konfigurationspakete
Nicht validierte Daten werden potentiell nicht synchronisiert, weil alle Trigger übersprungen werden. Die DYCE Connect Plattform verwendet die System Id als Referenz zwischen Datensätzen. Diese wird in Business Central nicht importiert sondern neu erstellt. Bsp. Der Import von Zeiterfassungen mit der Time & Travel Modellzeilen Id wird fehlschlagen, wenn die Id nicht denen im Time & Travel Model entsprechen. - Business Central Mandanten (mit einer DYCE Connect Umgebung) löschen, einen neuen mit gleichen Namen erstellen und den Einrichtungsassistent ausführen
Der neue Business Central Mandat wird sich mit der noch bestehenden Umgebung wieder verbinden. - Nicht verarbeitete Nachrichten in falscher Reihenfolge Wiederholen
Wird beispielweise eine Zeiterfassung zweimal in Time Tracking bearbeiten und nicht automatisch verarbeiten in Business Central, kann der Anwender die Verarbeitung erneut anstoßen. Wird das zweite Update vor dem ersten durch den Anwender verarbeitet, wird die Zeiterfassung mit einem alten Stand überschrieben.