1.Auf der Seite «Cloud Connector-Verwaltung» wählen Sie «Einrichtung» und dann «Einrichtung der Entität» aus.
2.In der Tabelle müssen die Spalten «Tabellen-ID», «Quelle» und «Webdienstendpunkt» ausgefüllt werden.
•Tabellen-ID: Hier wird der Name der SwissSalary/Business Central-Tabelle angegeben. Klicken Sie in der Spalte «Tabellen-ID», wählen Sie «Aus vollständiger Liste auswählen» und wählen Sie die entsprechende SwissSalary/Business Central-Tabelle aus, in die Sie Daten aus dem verbundenen System übertragen möchten oder aus der Sie Daten in das verbundene System schreiben möchten. Dieselbe Tabelle kann mehrmals, mit verschiedenen Endpunkten in dem verbundenen System eingerichtet werden.
•Reihenfolge: Gibt die Reihenfolge an, in der diese Entitätstabelle synchronisiert werden soll. Beachten Sie die Tabellenabhängigkeiten; die Tabellenbeziehungen werden während der Synchronisierung validiert.
•Quelle: Hier wird die Richtung der Synchronisation angegeben. Wenn die Quelle Business Central ist, werden die Daten aus SwissSalary/Business Central in das verbundene System synchronisiert. Wenn die Quelle extern ist, erfolgt die Synchronisation von Daten aus dem verbundenen System in SwissSalary/Business Central. Der Cloud Connector erlaubt keine bidirektionale Synchronisierung bestimmter Tabellen. Jede Tabelle muss eine einzige Quelle haben, entweder SwissSalary/Business Central oder das verbundene System.
•Automatische Synchronisierung: Gibt an, ob Tabellenänderungen aus SwissSalary automatisch in das verbundene System synchronisiert werden sollen.
•Löschungen Synchronisieren: Gibt an, ob Löschvorgänge für diese Entität synchronisiert werden sollen. Das Aktivieren dieser Einstellung hat erhebliche Auswirkungen auf die Gesamtleistung der Synchronisierung.
•Webdienstendpunkt: Hier wird der Name (wie Sie die Webdienste im Feld «Service Name» beim Schritt 5 benannt haben) der Tabelle im verbundenen System angegeben. Klicken Sie in der Spalte «Webdienstendpunkt» und geben Sie den Tabellennamen ein.
3.Sie können das Mapping der zu synchronisierenden Felder einrichten, indem Sie auf den entsprechenden Tabellenname klicken.. Die folgenden Felder können im Abschnitt «Zuordnung von Entitätsfeldern» wie folgt ausgefüllt werden:
•Feld-ID: Hier wird die ID des Feldes in der zugeordneten SwissSalary/BusinessCentral-Tabelle angegeben.
•Feldname: Hier wird der Name des Feldes in der zugeordneten SwissSalary/BusinessCentral-Tabelle angegeben.
•Name des Servicefelds: Hier wird der Name des Feldes in der zugeordneten Tabelle des verbundenen Systems angegeben.
•Aktiviert: Hier wird angegeben, ob dieses Feld beim Aktualisieren von Datensätzen in der Quell- oder Zielinstanz einbezogen werden soll.
•Der Schlüssel: Gibt an, ob dieses Feld Teil des Schlüssels (Primary Key) für diese Entität ist.
•Validieren: Gibt an, ob die Tabellenfeldüberprüfung durchgeführt werden soll, wenn Daten für dieses Feld festgelegt werden. Dies gilt nur, wenn Daten aus dem angebundenen System in SwissSalary übernommen werden.
4.Falls Sie in der Spalte «Quelle» den Wert «Extern» ausgewählt haben, wird der Abschnitt «Entitätsfeldkonstanten» angezeigt. Hier können die folgenden Felder im Abschnitt «Entitätsfeldkonstanten» wie folgt ausgefüllt werden:
•Feld-ID: Hier wird der konstante Wert angegeben, der für das Feld in neuen Datensätzen festgelegt werden soll, die in Business Central eingehen.
•Feldname: Hier wird der Name des Felds in der zugeordneten SwissSalary/BusinessCentral-Tabelle angegeben.
•Konstanter Wert: Hier wird der konstante Wert angegeben, der für das Feld in neuen Datensätzen festgelegt werden soll, die in Business Central eingehen.
•Aktiviert: Hier wird angegeben, ob dieses Feld beim Aktualisieren von Datensätzen in der Quell- oder Zielinstanz einbezogen werden soll.
5.Falls Sie beim Abschnitt «Zuordnung von Entitätsfeldern» dann «Entitätsfeldkonstanten» auf «Felder»/ «Felder auf Standard zurücksetzen» klicken werden alle Felder der ausgewählten Tabellen aufgelistet.
6.Wichtig: Einige Lohnbuchhaltungs-bezogene Entitäten sind bereits vordefiniert. In diesem Fall müssen Sie diese Entitäten nicht erneut einrichten, sondern können direkt mit Schritt 9 und 10 fortfahren. Sie haben auch die Möglichkeit, andere Entitäten einzurichten, die nicht bereits vom SwissSalary Cloud Connector vordefiniert sind, wie beispielsweise die Personalkarte.
Abbildung 7
7.Odata-Filter (Optional): Falls «Quelle» den Wert «Extern» hat, kann der OData-Filter gesetzt werden. Gemäss dieser Anleitung können die Filterausdrücke in diesem Feld verwendet werden.
8.Automatische Synchronisierung: Gibt an, ob Tabellenänderungen aus SwissSalary automatisch in das verbundene System synchronisiert werden sollen.
9.Löschungen Synchronisieren: Gibt an, ob Löschvorgänge für diese Entität synchronisiert werden sollen. Das Aktivieren dieser Einstellung hat erhebliche Auswirkungen auf die Gesamtleistung der Synchronisierung.
10.Datenintegrationsprüfungen überspringen: Gibt an, ob Datenintegritätsprüfungen im SwissSalary ausser Acht gelassen werden sollen, die vor Beginn der Synchronisierung für diese Entität durchgeführt werden.
11.Nachlauf Dienstendpunkt (Optional): Gibt einen Endpunkt an, der im verbundenen System aufgerufen werden soll, nachdem die Entität erfolgreich synchronisiert wurde. Dies kann verwendet werden, wenn eine Aktion ausgeführt werden soll, nachdem die Tabellendaten erfolgreich synchronisiert wurden. Siehe beim Schritt X
12.Nachlauf Anforderungstext (Optional): Hier können Sie einen konstanten Wert angeben, den an den im Feld «Nachlauf Dienstendpunkt» angegebenen Dienstendpunkt gesendet werden soll. Hier müssen Sie die Feldnamen bzw. die dazugehörenden Werte als JSON angeben.
Automatisches Verbuchen von FiBu- und Kostenerfassungsjournale im Business Central/Navision on-prem, und Business Central SaaS.
Falls die in das verbundene System übertragene FiBu- und Kostenerfassungsjournale automatisch, nach der Synchronisation in dem verbundenen System verbucht werden sollen, sollen folgende Einrichtungen vorgenommen werden:
1.A. Business Central on-Prem: In dem verbundenen System müssen Sie zwei neuen Objekte (Gen-Journal Line Post, bzw. Cost-Journal Line Post) installieren und als Webdienste veröffentlichen. Diese Objekte werden von SwissSalary Ihnen zur Verfügung gestellt, damit die Funktion Buchen durch die Webdienste aufrufbar sind
B. Business Central SaaS: Sie müssen den CodeUnit Webdienst: 231 Gen. Jnl.-Post als Webdienst veröffentlichen, damit die Funktion Buchen durch die Webdienste aufrufbar sind.
2.Auf der Seite «Einrichtung der Entität», bei den Entitäten Gen. Journal Line und Cost Journal Line, müssen Sie die entsprechenden Webdiensten für die Funktion «Buchen» in dem Feld «Post-Run Service Endpunkt auswählen.
3.Auf der Seite «Einrichtung der Entität», bei den Entitäten Gen. Journal Line und Cost Journal Line, müssen Sie im Feld «Post-Run» Anforderungstext den folgenden json als request Body erfassen:
{
"JournalTemplateFilter": "ALLGEMEIN",
"JournalBatchFilter": "$L-*$"
}